MCP 連接器

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

MCP 設定分為兩個步驟：

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

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

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

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

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

AGENT_ID=$(ant beta:agents create \
  --name "GitHub Assistant" \
  --model claude-opus-4-7 \
  --mcp-server '{type: url, name: github, url: "https://api.githubcopilot.com/mcp/"}' \
  --tool '{type: agent_toolset_20260401}' \
  --tool '{type: mcp_toolset, mcp_server_name: github}' \
  --transform id --raw-output)

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

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

session = client.beta.sessions.create(
    agent=agent.id,
    environment_id=environment.id,
    vault_ids=[vault.id],
)

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

支援的 MCP 伺服器類型

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

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