【第641回】 Agentforce ： Salesforce Catalog で組織のメタデータを AI 検索
Salesforce Catalog が一般提供となり、Salesforce 組織内のメタデータを、AI ツールから自然言語で検索できるようになりました。
Salesforce Catalog は、Data 360 を基盤として、オブジェクトや項目、Lightning Web Components（LWC）などのメタデータを収集・インデックス化する機能です。正確な API 名を知らなくても、業務上の意味から関連するメタデータを探せることが特徴です。
Metadata Grounding MCP Server を通じて、ChatGPT、Claude、Agentforce Vibes などから利用できます。なお、Salesforce Catalog 自体は正式リリースとなりましたが、2026 年 10 月現在、Metadata Grounding MCP Server は ベータ版 です。
また、Salesforce Catalog は有効化や検索インデックスの作成・更新に追加のクレジットを消費しない のも利用ハードルを下げるポイントかと思います。但し、MCP サーバー経由で検索する際の利用料金は発生します。
今回は、この機能で何が便利になるのかに加え、有効化の手順や、実際に作成された検索インデックス、利用前に確認しておきたい点を紹介します。
① 組織にあるメタデータを、意味から探す
メタデータとは、顧客名や予約内容といった業務データそのものではなく、オブジェクトや項目の定義、Flow、Apex Class など、Salesforce の構成を表す情報です。
例えば、AI に「先月の注文をすべて表示してください」と依頼したとします。
この質問に正しく答えるには、AI はまず、その組織で「注文」を管理しているオブジェクトは何か、注文日を表す項目はどれか、顧客情報とどのように関連付けられているか を把握する必要があります。
Salesforce Catalog は、Metadata Grounding MCP Server を通じて、こうした組織固有のメタデータを検索するための情報を提供します。
正確な API 名が分からなくても、業務上の意味から関連するオブジェクトや項目を探せるため、AI が存在しない項目名を推測したり、関連付けを見落としたりすることを減らし、適切なクエリの生成につなげます。
ただし、組織独自の業務ルールまで、すべて自動で、しかも正しく理解されるわけではありません。 AI が適切に判断できるよう、オブジェクトや項目の「名前」や「説明」を分かりやすく整備し、必要に応じて業務上の定義を補足することが大切です。
② 従来のメタデータ参照との違い
従来も、Salesforce API や CLI、対応する MCP サーバーを利用すれば、AI が組織のオブジェクトや項目などの情報を取得・参照することは可能でした。よって、何が新しいのか？と疑問に思ったかたもいるかと思います。
今回の Salesforce Catalog の特徴は、組織のメタデータをあらかじめ収集・インデックス化し、意味検索とキーワード検索を組み合わせて、ハイブリッドに探せることです。つまり Data 360 検索インデックス が作成されます。
例えば、「予約情報を管理しているオブジェクトはどれですか？」と質問したときに、正確な API 名を指定しなくても、関連するメタデータを候補として見つけられます。
単に「メタデータを取得する」だけでなく、何を参照すべきか分からない段階から、業務上の意味を手掛かりに探せることがポイントです。
AI が検索結果を根拠としてクエリやコードを生成することで、存在しない項目名の生成や、既存アセットの見落としを減らすことが期待できます。ただし、正確性が保証されるわけではなく、内容の確認は引き続き必要です。
なお、Metadata Grounding MCP Server は、メタデータの検索・参照を担う読み取り専用のサーバーです。レコードの取得・更新や設定変更には、Headless 360 MCP Server などの対応ツールを別途利用します。
Salesforce Catalog は、既存の API や開発ツールを置き換えるものではなく、AI が組織の構成を理解するための情報を見つけやすくする基盤 として捉えると分かりやすいと思います。
③ Salesforce Catalog を有効化する
ここからは、Salesforce Catalog を有効化する手順を紹介します。
1. Feature Manager を開く
Data Cloud Setup → Feature Management → Feature Manager を開き、一覧から Salesforce Catalog を探し、Enable をクリックします。
注意：一度、有効化すると無効化することはできません。
2. 初回の取り込みとインデックス作成を待つ
有効化すると、組織のメタデータを抽出・取り込む初回の同期が実行され、Saslesforce Catalog 専用の「検索インデックス」の構築が開始されます。
有効化後に Catalog Metadata Search という Hybrid 型の検索インデックスが作成されます。
対象の検索インデックスを開き、Process History から、処理件数や処理サイズ、作成されたチャンク数、処理結果を確認できます。
その後も、メタデータの増分更新によってデータが維持されますが、前述の通り、この検索インデックスに関してはコストは発生しません。私の環境でも、上記の通り、大量の処理が発生しましたが、処理日当日のクレジットの消費は確認されませんでした。もしコストが発生したら、相当な消費になることは言うまでもありませんね。
④ Metadata Grounding MCP Server 有効化
続いて、Salesforce Catalog の準備が完了したら、AI ツールが検索するための窓口となる Metadata Grounding MCP Server を有効化します。
1. 設定で MCP Servers を検索し、Salesforce Servers タブから Metadata Grounding Beta を選択します。
2. Activate をクリックします。
主に次の 3 つのツールが利用されます。
describe_metadata：対応するメタデータの種類や構造を確認する
search_metadata：自然言語で関連する候補を検索する
query_metadata：見つかったメタデータの詳細を取得する
⑤ 外部 AI ツールから接続する
ChatGPT や Claude から利用する場合
ChatGPT や Claude などの外部 AI ツールから接続する場合は、Agentforce Vibes とは異なり、Salesforce 側で External Client App を登録し、OAuth 認証を設定する手順が必要です。
Metadata Grounding MCP Server の接続先 URL は、次の通りです。
本番環境
https://api.salesforce.com/platform/mcp/v1/d/[MyDomain]/platform/metadata-groundingSandbox
https://api.salesforce.com/platform/mcp/v1/d/[SandboxMyDomain]/sandbox/platform/metadata-grounding環境に合った URL を使用し、接続する AI ツールに応じた認証設定を行います。外部 AI ツールごとの設定は、以下を参照して下さい。
最初は、対応するメタデータの種類を確認するとよいと思います。
Metadata Grounding MCP Server を使って、この組織で検索できるメタデータの種類を確認してください。
続いて、業務上の意味から検索します。
Metadata Grounding MCP Server を使って、予約情報を管理するオブジェクトと、予約日・顧客に関連する項目を探してください。見つかった候補の表示ラベル、API 名、説明を教えてください。検索と参照だけを行い、変更はしないでください。
⑥ Agentforce Vibes から Sandbox の Catalog に接続する
Agentforce Vibes から利用する場合は、開発対象の Sandbox に接続し、その Sandbox の Salesforce Catalog を検索する構成 で進めます。
前提条件
Agentforce Vibes を利用するには、Agentforce Developer and Admin Tools の権限セットが必要です。
本番環境だけで Catalog を有効化している場合は、Sandbox 側でも準備が必要です。本番で作成した検索インデックスが、そのまま Sandbox から利用されるわけではありません。
1. Sandbox 側の準備を行う
対象の Sandbox で Data 360 が利用できることを確認し、上の ③・④と同様に、以下を実施します。
Salesforce Catalog を有効化
初回の取り込み・検索インデックス作成の完了を確認
Metadata Grounding MCP Server を有効化
AI が検索するのは、Catalog に取り込まれた情報です。有効化の直後は、検索の準備が完了するまで待つ必要があります。
2. Vibes の接続先を Sandbox にする
Agentforce Vibes の開発環境で、Salesforce DX プロジェクトを開きます。
画面下部のステータスバーから、デフォルト組織が対象の Sandbox になっていることを確認してください。別の組織が選択されている場合は、組織名または接続アイコンから切り替えます。
3. Metadata Grounding MCP Server に接続する
Agentforce Vibes のパネルから、次の順に開きます。
Toolkit → MCP Servers → Salesforce Platform
一覧から Metadata Grounding のサーバーを選択し、詳細画面でトグルをオンにします。
緑色の Connected 表示と利用可能なツール数が表示されれば、接続完了です。
Agentforce Vibes との接続では Salesforce の認証が利用されるため、ChatGPT や Claude の場合と異なり、External Client App の作成や Consumer Key の入力は不要です。
いかがでしたでしょうか。
Salesforce Catalog は、既存の設定や開発資産を AI が意味から発見し、再利用するための機能です。
一方で、その裏側では Data 360 への取り込みと検索インデックスの作成・更新が行われます。便利になる点と、組織のメタデータ量・更新量に応じた使用量の両方を確認しながら、活用を検討したい機能です。
今回は以上です。
