Agentforce トラブルシューティング用 MCP

エージェントが MCP サーバーを見つけられない。

Salesforce に登録された MCP サーバーから応答がありません。

• ネットワーク接続を確認します。
• MCP サーバが正しく稼働していることを確認します。
• MCP サーバーの登録設定を確認します。URL など、サーバー側で何か変更されていますか?このツールは MCP Server で引き続き使用できますか?必要に応じて登録設定を更新します。「Edit MCP Server Details」を参照してください。
• Salesforce でホストされる MCP サーバの場合は、「サーバ接続失敗」も参照してください。

問題を解決して、サーバーへの接続を再試行します。

エージェントが MCP サーバーツールにアクセスできない (認証エラー)。

認証エラーは、ログイン情報が正しくないか期限切れであるか、その他のサーバー側の変更によって発生する可能性があります。MCP for Agentforce では、次の種別がサポートされています。

• 認証なし
• OAuth 2.0 クライアントログイン情報

Salesforce が登録した MCP サーバーの認証設定を確認します。ログイン情報を更新する必要がありますか?サーバー側で他に何か変更がありますか?たとえば、以前は認証ログイン情報が必要ではなかったのに、サーバーで認証ログイン情報が必要になりましたか?それに応じて認証設定を更新します。「Edit MCP Server Details」を参照してください。

Salesforce でホストされる MCP サーバの場合は、「認証の問題」も参照してください。

エージェントに同期外エラーが表示される。

Salesforce に登録された MCP サーバーのサーバー側を変更すると、現在の登録と許可リスト設定が同期しなくなる可能性があります。たとえば、サーバーツールの更新 (説明の変更、入力または出力スキーマの違い、さらにはツールの削除など) は、そのツールに依存するエージェントに悪影響を及ぼす可能性があります。

MCP for Agentforce は、このような問題を特定し、登録済み MCP サーバまたはサーバ ツールに [非同期] のフラグを付けてシステム管理者に通知します。「Resolve Out-of-Sync MCP Server Issues」を参照してください。

エージェントに MCP タイムアウトエラーが表示される。

MCP 関連のタイムアウトエラーは、次の場合に発生します。

• Salesforce が登録した MCP サーバーツールが使用できないか、応答に 60 秒以上かかる
• 複数のサーバーがコールされ、全体として応答に 120 秒以上かかる (Atlas の推論エンジンのタイムアウト)

まず、高遅延の原因が MCP 関連の操作にあるかどうかを判断します。「リソースのトラブルシューティング」で説明されているデバッグ ツール(Agent Builder の Plan Tracer やトレース ログなど)を使用して、Agentforce ソリューションのタイムアウトが発生した場所を分離します。

MCP 操作でタイムアウトエラーが発生していることを確認した場合:

• ネットワーク接続を確認します。
• MCP サーバが正しく稼働していることを確認します。
• Salesforce でホストされる MCP サーバーの場合、管理ツールを使用して MCP 関連の操作による遅延をトラブルシューティングします。(サードパーティ MCP サーバに対する表示は制限されます)。

問題を解決し、修正をテストしてリリースし、タイムアウトの監視を続行します。

エージェントに他の MCP 関連の問題がある。

• Agentforce ソリューションが Requirements for MCP for Agentforce に準拠していることを確認します。
• 「Considerations for MCP for Agentforce」を参照して、Agentforce ソリューションで該当する変更が必要かどうかを判断します。
• 組織のサポートチャネルから Salesforce サポートにお問い合わせください。

トラブルシューティングリソース

Agentforce には、パターンの特定、根本原因の調査、および是正措置の実行に役立つツールと機能があります。

• エージェントビルダーで、会話プレビューパネルのプラントレーサーを使用して、クライアントと MCP サーバー間のネットワークトラフィックエラーを分離します。会話またはワークフローテスト中にエージェントが実行する詳細なステップごとの決定とアクションを確認します。MCP 関連の操作に焦点を絞ります。
• 拡張イベントログを使用して、エージェントの会話に関する詳細な詳細を提供します。
• Agent Analytics を使用して、エージェントのパフォーマンスを監視し、エラーのトレンドを検出します。セッションレベルでパターンと根本原因を調査する (「Analyze Data with Agent Optimization (エージェント最適化を使用したデータの分析)」を参照)。
• エージェント状態監視で、エージェントのパフォーマンスがしきい値レベルを超えた場合に通知をトリガーするアラートしきい値を設定します。
• Salesforce でホストされる MCP サーバーの場合、MCP サーバーに付属する管理ツールを使用して問題を診断し、対処します。