CRM Analytics MCP 伺服器疑難排解與祕訣
解決連線與權限問題,並使用可協助 AI 用戶端更準確地查詢 CRM Analytics 資料的提示與作法。
必要版本
| 適用於 Lightning Experience。 |
| CRM Analytics 隨附 (以下版本需額外付費取得 CRM Analytics：Enterprise、Performance 與 Unlimited Edition)。 |
一般連線問題
- 伺服器連線失敗:在「設定」中的「MCP 伺服器」下確認 CRM Analytics MCP 伺服器已開啟。同時確認您已使用正確的回呼 URL 建立外部用戶端應用程式。然後,在您啟動 OAuth 流程之前,確認您已登入包含該應用程式的組織。
- 沒有顯示任何工具:確認您的 MCP 用戶端針對您的組織類型使用正確的伺服器 URL,且每個使用者使用自己的 Salesforce 認證完成 OAuth。CRM Analytics MCP 伺服器不支援服務帳戶權杖。
- 生產組織:CRM Analytics MCP 伺服器適用於生產組織,以及 Sandbox 與臨時組織。使用符合您組織類型的伺服器 URL:
- 生產:
https://api.salesforce.com/platform/mcp/v1/analytics/crma-beta - Sandbox 或臨時組織:
https://api.salesforce.com/platform/mcp/v1/sandbox/analytics/crma-beta
- 生產:
資料與工具存取權
您的 MCP 工作階段會以您的身分執行。由於驗證會使用您的 Salesforce 認證,因此每個要求都會遵循欄位級安全性 (FLS)、物件級安全性 (OLS)、列層級安全性 (RLS) 和共用規則。AI 用戶端永遠看不見您在 CRM Analytics 中看不見的資料或資產。
- 遺失的資料集、顯示面板或透鏡:如果用戶報告資產無法使用,或
list_通話傳回的項目少於預期,則您可能沒有該資產的權限。確認您擁有應用程式或資產的存取權,且您的權限集授與 CRM Analytics 存取權。 - API 限制:MCP 工具呼叫會計入您組織的 Wave API 限制。在「設定」的「API 使用狀況」下檢查使用狀況。
如需詳細資訊,請參閱「疑難排解指南」。
獲得更好的結果的小秘訣
- 描述目標,而非工具:請說「依階段向我顯示未結束機會」,而不是「call list_datasets」。AI 用戶端會選取工具。
- 使用欄位描述改善查詢準確度:將欄位標籤和描述新增至資料集擴充中繼資料 (XMD) 可協助 AI 用戶端產生更精確的 SAQL。
- 精簡複雜查詢:巢狀分組、多個資料集聯結或進階 SAQL 函數可能需要追蹤提示才能取得確切的結果。
範例提示
在新工作階段中使用這些提示來探索資產、檢查結構描述,並詢問您的資料。
| 使用者提示 | 已呼叫工具 | 目的 |
|---|---|---|
| 我可以存取哪些分析應用程式? | list_folders |
傳回保留顯示面板、資料集和透鏡的資料夾 (應用程式)。使用結果來定義後續搜尋的範圍。 |
| 我現在可以存取哪些 CRM Analytics 資料集? | list_datasets |
以安全性內容中可用的資料集名稱、標籤和識別碼來取用。 |
| 向我顯示「銷售應用程式」資料夾中的所有顯示面板。 | list_dashboards |
尋找特定應用程式或業務單位的預先建立顯示面板。 |
| 列出我允許檢視的所有已儲存探索。 | list_lenses |
收集已儲存透鏡的庫存及其參照的資料集。 |
| 為我提供「執行管道」資料集的完整中繼資料。 | get_dataset |
傳回資料集詳細資料,包括查詢所需的目前版本識別碼。 |
| 「機會」資料集中的確切欄位、維度和度量為何? | get_xmd |
提供欄位 API 名稱、資料類型和標籤,以便用戶端建立語法正確的 SAQL。 |
| 上一個會計年度依收入排序的前 10 個帳戶為何? | execute_query |
檢查資料集結構描述、產生 SAQL 查詢,並傳回結構化結果。 |
| 上一季依區域的銷售管道總數為何? | execute_query |
使用 SAQL 執行分組與篩選。 |
| 向我展示這個月代表績效與配額比較。 | execute_query |
執行查詢並將資料列與資料欄中繼資料傳回為結構化 JSON。 |
Beta 版回饋意見與支援
此伺服器目前為 Beta 版。您的回饋意見會打造廣泛可用的 (GA) 體驗。
- 與您的 Salesforce 帳戶小組共用回饋意見,或在此計畫的 Trailblazer Community 群組中提交回饋意見。
- 檢查每個更新的版本注意事項,以瞭解已知問題和因應措施。
- 若在設定期間有技術問題,請連絡 Salesforce 支援,並參照 CRM Analytics MCP 伺服器 (Beta 版)。
此文章是否解決您的問題？
請讓我們知道，以便我們改進！
