Agentforce MCP サーバーアクション

Model Context Protocol (MCP) サーバーを Agentforce アクションタイプとして使用する方法です。MCP サーバーの構築については、mcp-server-patterns を参照してください。

使用時機

• Agentforce トピック内で使用するための MCP サーバーの登録
• MCP アクションの認証、レート制限、またはツール検出の構成
• Salesforce の事前構築済み MCP サーバー (DX、Heroku、MuleSoft) の使用
• ゼロインフラストラクチャーエンドポイント向けホスト型 MCP (パイロット版) の設定
• エージェントスクリプトでの MCP アクション解決のデバッグ

---

概要

MCP は JSON-RPC 2.0 (HTTP/SSE 経由) を介して外部ツールを Agentforce に公開します。MCP サーバーはツール (名前、説明、パラメータ、戻り値の型を含む) を宣言し、Agentforce は接続時にそれらを検出します。各ツールが利用可能なエージェントアクションになります。

---

セットアップ

1. MCP サーバーレジストリに登録

Setup > MCP Servers > New MCP Server

フィールド	値
Name	わかりやすい名前 (例："Weather API")
Endpoint URL	サーバー URL (本番環境では HTTPS が必須)
Auth	OAuth 2.0 (統合ユーザー)
Transport	HTTP/SSE (標準)

登録後、ツールは Agentforce アセットライブラリに表示され、トピックに追加できます。

2. エージェントスクリプトに追加

エージェントスクリプトでは、MCP ツールは他のアクションと同様に参照されます。target: フィールドは不要です — MCP ツールはサーバーのツールマニフェストから自動検出されます。

topic weather:
   actions:
      get_weather:
         description: "Get current weather for a city"
         inputs:
            city: string
               description: "City name"
               is_required: True
         outputs:
            temperature: number
               description: "Temperature in Fahrenheit"
               is_displayable: True

   reasoning:
      actions:
         weather: @actions.get_weather
            with city = ...

3. クラシックセットアップ (エージェントビルダー UI)

Setup > Agentforce > Agent Assets > Add Action > アセットライブラリから MCP ツールを選択

---

認証

• OAuth 2.0 (統合ユーザー、最小権限の原則)
• 統合ユーザーに FLS とシェアリングルールが強制実行される
• 外部認証情報は名前付き認証情報を介して管理される
• トークン更新はプラットフォームによって自動的に処理される

---

レート制限

制限	値
サーバーごとの 1 分あたりのリクエスト数	約 50
ツール呼び出しごとのタイムアウト	120 秒 (エージェントタイムアウトと同じ)
最大ペイロードサイズ	プラットフォーム依存

---

ツール検出

接続時に、MCP サーバーはツールマニフェストを返します:

{
  "tools": [
    {
      "name": "get_weather",
      "description": "Get current weather conditions",
      "inputSchema": {
        "type": "object",
        "properties": {
          "city": { "type": "string", "description": "City name" }
        },
        "required": ["city"]
      }
    }
  ]
}

Agentforce はツール名と説明を LLM ルーティングに使用します — 明確かつ具体的に保ってください。

---

事前構築済み MCP サーバー

サーバー	用途	セットアップ
Salesforce DX MCP サーバー	AI アシスタントからスクラッチ環境のデプロイ、テスト、管理	@salesforce/mcp npm パッケージ
Heroku Platform	Heroku アプリ、dyno、アドオンの管理	組み込みコネクタ
MuleSoft	API オーケストレーション、統合フロー	MuleSoft Anypoint コネクタ

---

ホスト型 MCP (パイロット版)

完全に管理されたクラウドエンドポイント — ゼロインフラストラクチャー。コア CRM および B2C Commerce API 向けに事前構築されています。

• デプロイするサーバー不要 — Salesforce が MCP エンドポイントをホストします
• 管理者セットアップのみ — Setup で有効化し、権限を構成します
• 事前構築済みツール — 標準的な CRM 操作 (アカウント検索、ケース作成など)
• B2C Commerce ツール — 製品カタログ、注文管理

---

デバッグ

MCP アクションがエージェントスクリプト内で失敗する場合:

1. サーバー接続を確認: エンドポイント URL に Salesforce からアクセスできることを確認
2. 認証を確認: 名前付き認証情報と外部認証情報が構成されていることを確認
3. ツール名を確認: エージェントスクリプト内のアクション名がサーバーマニフェスト内のツール名と一致する必要があります
4. レート制限を確認: MCP サーバーログで 429 応答を監視
5. スタンドアロンでテスト: sf mcp test を使用するか、直接 HTTP でサーバーが応答することを確認

---

関連項目

• スキル: mcp-server-patterns — MCP サーバーの構築 (Node SDK)
• スキル: sf-agentforce-development — エージェントスクリプトパターン
• リファレンス: @../_reference/AGENTFORCE_PATTERNS.md