MCP 连接器
Claude 的模型上下文协议(MCP)连接器功能使您能够直接从 Messages API 连接到远程 MCP 服务器,无需单独的 MCP 客户端。
此功能需要测试版标头:"anthropic-beta": "mcp-client-2025-04-04"
主要特性
- 直接 API 集成:无需实现 MCP 客户端即可连接到 MCP 服务器
- 工具调用支持:通过 Messages API 访问 MCP 工具
- OAuth 认证:支持 OAuth Bearer 令牌用于已认证的服务器
- 多服务器:在单个请求中连接到多个 MCP 服务器
限制
- 在 MCP 规范的功能集中,目前仅支持工具调用。
- 服务器必须通过 HTTP 公开暴露。本地 STDIO 服务器无法直接连接。
- MCP 连接器目前不支持 Amazon Bedrock 和 Google Vertex。
在 Messages API 中使用 MCP 连接器
要连接到远程 MCP 服务器,请在 Messages API 请求中包含 mcp_servers
参数:
MCP 服务器配置
mcp_servers
数组中的每个 MCP 服务器支持以下配置:
字段描述
属性 | 类型 | 必填 | 描述 |
---|---|---|---|
type | string | 是 | 目前仅支持 “url” |
url | string | 是 | MCP 服务器的 URL。必须以 https:// 开头 |
name | string | 是 | 此 MCP 服务器的唯一标识符。它将在 mcp_tool_call 块中用于识别服务器并向模型区分工具。 |
tool_configuration | object | 否 | 配置工具使用 |
tool_configuration.enabled | boolean | 否 | 是否启用此服务器的工具(默认:true) |
tool_configuration.allowed_tools | array | 否 | 限制允许的工具列表(默认情况下,允许所有工具) |
authorization_token | string | 否 | 如果 MCP 服务器需要,则提供 OAuth 授权令牌。参见 MCP 规范。 |
响应内容类型
当 Claude 使用 MCP 工具时,响应将包含两种新的内容块类型:
MCP 工具使用块
MCP 工具结果块
多个 MCP 服务器
您可以通过在 mcp_servers
数组中包含多个对象来连接到多个 MCP 服务器:
认证
对于需要 OAuth 认证的 MCP 服务器,您需要获取访问令牌。MCP 连接器测试版支持在 MCP 服务器定义中传递 authorization_token
参数。
API 消费者需要在进行 API 调用之前处理 OAuth 流程并获取访问令牌,以及根据需要刷新令牌。
获取测试用的访问令牌
MCP 检查器可以指导您完成获取测试用访问令牌的过程。
-
使用以下命令运行检查器。您需要在机器上安装 Node.js。
-
在左侧边栏中,对于”传输类型”,选择”SSE”或”可流式 HTTP”。
-
输入 MCP 服务器的 URL。
-
在右侧区域,在”需要配置认证?“后点击”打开认证设置”按钮。
-
点击”快速 OAuth 流程”并在 OAuth 屏幕上授权。
-
按照检查器的”OAuth 流程进度”部分中的步骤操作,并点击”继续”直到达到”认证完成”。
-
复制
access_token
值。 -
将其粘贴到 MCP 服务器配置中的
authorization_token
字段中。
使用访问令牌
一旦您使用上述任一 OAuth 流程获得了访问令牌,您可以在 MCP 服务器配置中使用它:
有关 OAuth 流程的详细说明,请参阅 MCP 规范中的授权部分。