MCP 連接器

Claude Managed Agents 支援將 Model Context Protocol (MCP) 伺服器連接到您的代理程式。這讓代理程式能夠透過標準化協定存取外部工具、資料來源和服務。

MCP 設定分為兩個步驟：

代理程式建立：透過名稱和 URL 宣告代理程式連接的 MCP 伺服器。
工作階段建立：透過參照預先註冊的 vault 為這些伺服器提供驗證。

這種分離方式讓機密資訊不會出現在可重複使用的代理程式定義中，同時允許每個工作階段使用自己的憑證進行驗證。

所有 Managed Agents API 請求都需要 managed-agents-2026-04-01 beta 標頭。SDK 會自動設定 beta 標頭。

在代理程式上宣告 MCP 伺服器

在建立代理程式時，於 mcp_servers 陣列中指定 MCP 伺服器。每個伺服器需要一個 type、一個唯一的 name 以及一個 url。此階段不提供驗證權杖。

您在 MCP 伺服器陣列中指定的 name 用於參照工具陣列中的 mcp_toolset 項目。

agent_response=$(curl -sS --fail-with-body https://api.anthropic.com/v1/agents \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: managed-agents-2026-04-01" \
  -H "content-type: application/json" \
  -d @- <<'EOF'
{
  "name": "GitHub Assistant",
  "model": "claude-sonnet-4-6",
  "mcp_servers": [
    {
      "type": "url",
      "name": "github",
      "url": "https://api.githubcopilot.com/mcp/"
    }
  ],
  "tools": [
    {"type": "agent_toolset_20260401"},
    {"type": "mcp_toolset", "mcp_server_name": "github"}
  ]
}
EOF
)
agent_id=$(jq -r '.id' <<<"$agent_response")

MCP 工具集預設的權限政策為 always_ask，這需要在每次工具呼叫前取得使用者核准。請參閱權限政策以設定此行為。

在工作階段建立時提供驗證

啟動工作階段時，傳遞 vault_ids 以為您的 MCP 伺服器提供憑證。Vault 是您一次性註冊並透過 ID 參照的憑證集合。請參閱使用 vault 進行驗證以了解如何建立 vault 和管理憑證。

如果 vault 中提供的授權憑證無效，工作階段建立仍會成功，且互動仍可進行。系統會發出 session.error 事件，描述 MCP 驗證失敗的情況。您可以決定是否要在此錯誤上封鎖進一步的互動、觸發憑證更新，或允許工作階段在沒有 MCP 的情況下繼續。驗證重試將在下一次 session.status_idle 到 session.status_running 的轉換時發生。請參閱工作階段事件串流以了解使用 session.error 和其他事件的詳細資訊。

支援的 MCP 伺服器類型

Claude Managed Agents 連接到公開 HTTP 端點的遠端 MCP 伺服器。伺服器必須支援 MCP 協定的可串流 HTTP 傳輸。

有關 MCP 和建立 MCP 伺服器的更多資訊，請參閱 MCP 文件。

session_response=$(curl -sS --fail-with-body https://api.anthropic.com/v1/sessions \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: managed-agents-2026-04-01" \
  -H "content-type: application/json" \
  -d @- <<EOF
{
  "agent": "$agent_id",
  "environment_id": "$environment_id",
  "vault_ids": ["$vault_id"]
}
EOF
)
session_id=$(jq -r '.id' <<<"$session_response")