MCP for Agentforce に関する考慮事項

MCP サーバーと登録

• MCP for Agentforce は、Streamable HTTP Transport Protocol を使用するサーバをサポートします。HTTP+SSE およびその他のプロトコルはサポートされません。
• MCP for Agentforce では、認証なしと OAuth 2.0 クライアント クレデンシャルのみがサポートされます。認証コード、CIMD、DCR、JWT ベアラー、PKCE など、他の OAuth フローはサポートされていません。OAuth 2.1 クライアントログイン情報など、一部の高度な認証パターンを追加の設定で使用できます。
• ユーザーレベルの認証はサポートされていません。現在、個々のユーザー ID やパーソナライズされた応答を必要とする使用事例はサポートされていません。たとえば、MCP for Agentforceを使用して個々のユーザーに返金することはできませんが、顧客のすべての請求書を取得することはできます。
• MCP for Agentforce では、サーバ ツールのみがサポートされます。MCP サーバーアプリケーション、プロンプト、リソースはサポートされません。
• ツール名は最大 128 文字で、^a-zA-Z0-9./-{1,128}$ の文字がサポートされます。
• MCP サーバーが同期されていない場合や、MCP サーバーが使用できない場合、登録リストビューとサーバーレコードページには現在、サーバーが接続済みとして表示されます。修正が進行中です。
• サーバー登録またはサーバー自体を変更すると、エージェントで関連付けられた MCP ツールアクションが中断される場合があります。登録の削除などの変更を行う前に、エージェントから関連付けられたアクションを削除し、アセットライブラリから関連付けられたエージェントアクションを削除してから、サーバー登録を削除します。その後、サーバーを再登録して、新しい MCP ツールアクションをエージェントに追加できます。

パッケージ化とリリース

セキュリティを確保するため、Salesforce では MCP ツールアクションを含むエージェントのパッケージ化またはリリースをサポートしていますが、MCP サーバー登録メタデータはパッケージ化されていません。エージェントに追加された MCP ツールアクションは、標準では機能しません。

パッケージをリリースする前に、新しい環境で MCP サーバーを登録し、エージェントが使用するツールを許可リストに登録します。次に、リリース後にエージェントから既存の MCP ツールアクションを削除し、アセットライブラリの新しいアクションに置き換えます。

エージェントメタデータは、ドラフトエージェントまたは確定エージェント用にパッケージ化できます。エージェントが新しい環境でドラフト状態の場合、編集できます。エージェントがコミット状態の場合、新しいドラフトを作成して変更を加えます。

Agentforce プラットフォームおよびビルダーのサポート

• MCP サーバーアクション (MCP ツールアクション) を参照するエージェントアクションの請求レートは他のエージェントアクションと同じです。使用状況に関するレポートは Digital Wallet で利用できます。「Agentforce および生成 AI の使用状況と請求」を参照してください。
• Agentforce Builder のサポートは、プリミティブ値と項目アクセスが浅い場合に最適です。そのため、可能な場合は、構造化された JSON 応答がシンプルな MCP サーバ ツールを選択するか、応答を調整してください。最上位オブジェクト、最上位オブジェクトプロパティ、および最上位オブジェクトの配列がサポートされます。現在、ネストされたプロパティ、オブジェクトの配列、動的オブジェクトのペイロードなど、より複雑な形状はエンドツーエンドでサポートされていません。詳細はこちら。
• Agentforce Builder は Lightning 種別を使用してアクションの入力と出力を表示します。すべての MCP ツールの入力スキーマと出力スキーマが Lightning タイプに対応付けられるわけではありません。MCP ツール アクションのデータを Lightning 種別に解決できない場合でも、エージェントでアクションを使用できますが、入力または出力を変数に保存することはできません。詳細はこちら。
• MCP ツールアクションをエージェントに追加すると、次のようになります。
  • 一部のデータ型 (数値など) の入力表示ラベルと出力表示ラベルは、「文字列」の表示ラベルに置き換えられることがあります。これはエージェントのロジックや推論には影響しませんが、使いやすさを考慮して、表示ラベルをアセットライブラリの MCP ツールアクションまたは MCP ツールの入力スキーマまたは出力スキーマの元の値に置き換えることをお勧めします。修正が進行中です。
  • [参照アクション種別] 項目は空で表示されます。参照アクションが入力されるため、アクションは必須項目として識別されていても、参照アクション種別なしで実行できます。[参照アクション種別] 項目をクリックまたは変更すると、参照アクションはリセットされ、MCP ツールに手動でリセットすることはできません。この場合、エージェントからアクションを削除して、アセットライブラリから再追加します。修正が進行中です。
  • MCP サーバーおよびツールの場合、プロパティは 255 文字以下にする必要があります。255 文字を超えるプロパティは現在サポートされていません。
• MCP サーバの応答には、次のタイムアウト期間が適用されます。可能な場合は、これらの制限に合わせて応答を調整します。
  • MCP クライアントのタイムアウト制限は 60 秒です。たとえば、サーバーが使用できない場合や、応答に 60 秒以上かかる場合などです。
  • Atlas 推論エンジンのタイムアウトは 120 秒です。たとえば、複数のサーバーがコールされ、その応答に合計で 120 秒以上かかった場合などです。