CRM Analytics MCP Server のトラブルシューティングとヒント
接続と権限の問題を解決し、AI クライアントが CRM Analytics データをより正確に照会するのに役立つプロンプトとプラクティスを使用します。
必要なエディション
| Lightning Experience で使用できます。 |
| CRM Analytics で有料オプションで使用可能なエディション: Enterprise Edition、Performance Edition、および Unlimited Edition。 |
一般的な接続の問題
- Server connection fails: [設定] の [MCP サーバー] で CRM Analytics MCP サーバーがオンになっていることを確認します。また、正しいコールバック URL を使用して外部クライアントアプリケーションを作成したことを確認します。次に、OAuth フローを開始する前に、そのアプリケーションが含まれる組織にサインインしていることを確認します。
- ツールが表示されません。MCP クライアントが組織種別に適したサーバー URL を使用し、各ユーザーが各自の Salesforce ログイン情報を使用して OAuth を完了していることを確認します。CRM Analytics MCP Server では、サービスアカウントトークンはサポートされません。
- 本番組織: 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)、および共有ルールが適用されます。CRM Analytics で参照できないデータやアセットは、AI クライアントには表示されません。
- データセット、ダッシュボード、レンズがありません。アセットが使用できないことがクライアントから報告された場合や、
list_コールで返される項目が予想より少ない場合は、そのアセットに対する権限がない可能性があります。アプリケーションまたはアセットへのアクセス権があり、その権限セットで CRM Analytics へのアクセス権が付与されていることを確認します。 - API 制限: MCP ツールコールは、組織の Wave API 制限に含まれます。[設定] の [API 利用状況] で利用状況を確認します。
詳細については、『 Troubleshooting Guide 』を参照してください。
Tips for Better Results (結果を改善するためのヒント)
- ツールではなく目標について、「call list_datasets」ではなく「Show me open opportunities by stage」 (フェーズ別の進行中の商談の表示) と入力します。AI クライアントがツールを選択します。
- 項目の説明によるクエリの精度の向上:データセット拡張メタデータ(XMD)に項目の表示ラベルと説明を追加すると、AIクライアントがより正確なSAQLを生成できます。
- 複雑なクエリの絞り込み: ネストされたグルーピング、複数データセットの結合、高度な SAQL 関数では、正確な結果を得るためにフォローアッププロンプトが必要になる場合があります。
プロンプトの例
新しいセッションでこれらのプロンプトを使用して、アセットの検出、スキーマの調査、データの質問を行います。
| ユーザープロンプト | Tool Called (コールされたツール) | 目的 |
|---|---|---|
| どの分析アプリケーションにアクセスできますか? | list_folders |
ダッシュボード、データセット、レンズが含まれるフォルダー (アプリケーション) を返します。結果を使用して、後の検索の範囲を設定します。 |
| 現在どの CRM Analytics データセットにアクセスできますか? | list_datasets |
セキュリティコンテキストで使用できるデータセット名、表示ラベル、ID を取得します。 |
| [セールスアプリケーション] フォルダーにあるすべてのダッシュボードを表示します。 | list_dashboards |
特定のアプリケーションまたはビジネスユニットの事前作成済みダッシュボードを検索します。 |
| 表示が許可されているすべての保存済み探索をリストします。 | list_lenses |
保存したレンズとレンズが参照するデータセットのインベントリを収集します。 |
| Executive Pipeline データセットの完全なメタデータを渡してください。 | get_dataset |
データセットの詳細 (クエリに必要な現在のバージョン ID を含む) を返します。 |
| Opportunity データセットの正確な項目、ディメンション、基準は? | get_xmd |
クライアントが構文的に正しい SAQL を構築できるように、項目の API 参照名、データ型、表示ラベルを指定します。 |
| 昨年度の売上上位 10 件の取引先は? | execute_query |
データセットスキーマを調べて SAQL クエリを生成し、構造化された結果を返します。 |
| 前四半期の地域別のパイプライン合計は? | execute_query |
SAQL を使用してグルーピングと絞り込みを実行します。 |
| 今月の営業担当のパフォーマンスと目標を表示します。 | execute_query |
クエリを実行し、行と列のメタデータを構造化 JSON として返します。 |
ベータフィードバックとサポート
このサーバーはベータリリースとして使用できます。フィードバックによって、正式リリース (GA) 環境が形成されます。
- フィードバックを Salesforce アカウントチームと共有するか、このプログラムの Trailblazer Community グループで送信してください。
- 既知の問題と回避策については、各更新のリリースノートを参照してください。
- 設定時の技術的な問題については、Salesforce サポートにお問い合わせください。また、CRM Analytics MCP サーバー (ベータ) についても説明します。
この記事で問題は解決されましたか?
ご意見をお待ちしております。
