结论先说
- 服务端直连,免去自建 MCP 客户端循环:在 Messages API 请求里声明
mcp_servers和mcp_toolset,Anthropic 服务端会自动连接你的远程 MCP 地址、拉取工具列表并在同一次请求内完成调用与结果回传。 - 必须携带专用 Beta 标识:当前调用需在 HTTP 头传入
"anthropic-beta": "mcp-client-2025-11-20"(使用官方 SDK 时走client.beta.messages.create并传betas=["mcp-client-2025-11-20"])。 - 只支持远程 HTTP 传输,不支持本地
stdio:目标 MCP 服务器必须提供公网可达的 HTTPS 地址(支持 Streamable HTTP 或 SSE 传输),且目前只支持 MCP 的 Tools(工具) 能力,不支持 Resources 和 Prompts。 - 生产环境务必用
mcp_toolset做工具收敛:通过default_config和configs可以只放行必要的几个工具,或开启defer_loading避免一次性把几十个工具描述全塞进上下文。 - 国内免卡开通与账号服务入口:自有账号免上号自助开通可见本站 Claude Pro 充值页 与 Claude Max 充值页;缺可用账号或遇身份核验可查看 Claude 注册说明 与 Claude KYC 认证协助。

图:本站根据 Claude 官方文档:MCP connector 整理的示意图
本文根据 Claude 开发者平台官方文档《MCP connector》整理,资料核对于 2026-11-18。配图为本站整理的示意图,不是界面截图。本站(bigolab.com)不是 Anthropic 官方网站。
适用于谁
- 搜「claude api mcp connector」「claude messages api 调用远程 mcp」的后端与全栈开发者;
- 想让线上业务接口直接调用 Notion、Linear 或公司自建远程 MCP 工具,不想自己在业务服务里维护一套 MCP 客户端状态机的人;
- 连上远程 MCP 后发现工具太多导致输入 token 激增,想按白名单筛选工具的人。
如果你不是自己写 API 代码,而是想在网页版或本地命令行里直接挂载现成连接器,可以看 /guides/claude-connectors 或 /guides/claude-code-mcp-setup。
一、最小可用请求怎么写(Python 与 cURL)
与常规客户端工具(详见 /guides/claude-tool-use-basics)最大的区别在于:使用 MCP Connector 时,你需要在请求体顶层传 mcp_servers 定义连接信息,再在 tools 数组里用 mcp_toolset 引用该服务器的 name。
按官方文档整理的 Python SDK 最小调用示例:
python
import anthropic
client = anthropic.Anthropic()
response = client.beta.messages.create(
model="claude-sonnet-5-5",
max_tokens=1024,
messages=[
{"role": "user", "content": "帮我查一下当前远程服务里有哪些可用工具,并查询最新一条工单状态。"}
],
mcp_servers=[
{
"type": "url",
"url": "https://example-server.modelcontextprotocol.io/sse",
"name": "ticket-mcp",
"authorization_token": "YOUR_OAUTH_BEARER_TOKEN",
}
],
tools=[
{
"type": "mcp_toolset",
"mcp_server_name": "ticket-mcp",
}
],
betas=["mcp-client-2025-11-20"],
)
print(response.content)
对应的原生 cURL 请求头与核心结构如下:
bash
curl https://api.anthropic.com/v1/messages \
-H "content-type: application/json" \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "anthropic-beta: mcp-client-2025-11-20" \
-d '{
"model": "claude-sonnet-5-5",
"max_tokens": 1024,
"messages": [{"role": "user", "content": "查询最新工单状态"}],
"mcp_servers": [{
"type": "url",
"url": "https://example-server.modelcontextprotocol.io/sse",
"name": "ticket-mcp",
"authorization_token": "YOUR_OAUTH_BEARER_TOKEN"
}],
"tools": [{"type": "mcp_toolset", "mcp_server_name": "ticket-mcp"}]
}'
同一条请求里可以配置多个远程 MCP 服务器,只要每个条目在 mcp_servers 里的 name 唯一,并在 tools 里各自配一条对应的 mcp_toolset 即可,也可以和普通自定义工具或联网搜索工具混用。
二、认证方式与工具白名单过滤
把远程 MCP 接进生产接口时,有两项配置不能省:
1. Bearer 令牌认证(authorization_token)
大多数远程业务 MCP 服务器都受 OAuth 或 API 密钥保护。你在 mcp_servers 条目里填入 authorization_token 后,Anthropic 服务端向该 URL 发起请求时会自动带上 Authorization: Bearer <token> 请求头。注意,MCP Connector 本身不替你跑浏览器 OAuth 跳转或刷新过期令牌,你的应用后端需要先拿好有效访问令牌再传给 Messages API。
2. 用 default_config 与 configs 控制暴露哪些工具
一个成熟的第三方 MCP 服务器动辄暴露二三十个增删改查工具,全量挂载既浪费输入 token,又有误触写操作的风险。官方推荐在 mcp_toolset 中用「默认全关 + 显式白名单」的写法:
json
{
"tools": [
{
"type": "mcp_toolset",
"mcp_server_name": "ticket-mcp",
"default_config": {
"enabled": false,
"defer_loading": true
},
"configs": {
"list_tickets": { "enabled": true },
"get_ticket_detail": { "enabled": true }
}
}
]
}
- 白名单模式:设
default_config.enabled为false,只在configs里把只读或安全工具设为enabled: true; - 黑名单模式:保持默认启用,只在
configs里把高危删除工具设为enabled: false; - 按需延迟加载(
defer_loading):开启后可避免在开局一次性加载冗长的工具 Schema,适合挂载大型工具集的场景。
Claude 会员充值与成品号提示:国内银行卡在结账页被拒时,可通过本站支付宝、微信支付或 AlipayHK 获取 iOS 订阅卡密自助开通 Claude Pro 或高配额 Claude Max(全程无需上号交密码);需要现成账号可了解 Claude Pro 成品号 与 Claude Max 5x 成品号(注:Anthropic 消费者条款禁止共享转让账号且违规可终止无退款,成品号均明确标注不质保封号)。
三、响应结构怎么读与常见报错排查
请求返回后,响应的 content 数组里会出现两类专门针对 MCP 的内容块,无需你的客户端再去跑工具回传:
mcp_tool_use:记录 Claude 决定调用哪个服务器(server_name)、哪个工具(name)以及传入的参数(input);mcp_tool_result:记录远程 MCP 服务器返回的执行结果或报错信息(is_error),紧接着 Claude 会基于结果生成最终的text回复。

图:本站根据 Claude 官方文档:MCP connector 整理的示意图
如果联调报错(通用状态码对照见 /guides/claude-api-error-codes),优先核对以下四条官方限制:
- 只支持 Tools 原语:MCP 规范里的 Resources(资源读取)和 Prompts(提示模板)目前不会通过 API 的 MCP Connector 暴露;
- 必须是公网可达 HTTPS:不能填
localhost、127.0.0.1或本地命令行npx启动的stdio服务;内网服务若要接入,需走安全网关或官方受控隧道方案; - 检查 Beta 头拼写:漏传
mcp-client-2025-11-20或拼错名称,API 会直接报参数不识别(400invalid_request_error); - 计费说明:MCP Connector 本身不收额外功能费,但远程服务器返回的工具描述和
mcp_tool_result内容都会计入标准输入输出 token。如果团队日常更多是在本地终端用现成的编程代理调 MCP,直接开通 Claude Code 订阅服务 会比自己手写一套 API 工具链省事得多。
常见问题
问:MCP Connector 需要我的客户端收到 mcp_tool_use 后自己去请求远程服务器吗?
答:不需要。只要是配在 mcp_servers 里的远程服务器,Anthropic 服务端会在单次 API 调用内部自动完成工具列表拉取和远程执行,直接把结果拼好返回给你。
问:能不能在 Amazon Bedrock 或 Google Vertex AI 上用这个 MCP Connector?
答:官方Availability 说明中,服务端直连的外部网络类工具在不同云托管平台的支持进度与原生 Claude API(api.anthropic.com)存在差异,跨云调用前请先查核官方文档顶部的平台支持表。
问:多轮对话时,历史消息里的 mcp_tool_use 和 mcp_tool_result 要怎么传回下一轮?
答:和普通多轮 Messages 调用一样,直接把上一轮助手返回的完整 response.content 原样追加进 messages 历史列表即可,不要手动删改其中的工具调用块。
问:人在国内没有外币信用卡,怎么订阅或升级 Claude 付费套餐?
答:可在本站 AI 会员充值总览页 选择 Claude Pro 自助充值 或 Claude Max 充值,付款后即时发卡密、24 小时自助兑换且可开具增值税发票;实时价格与售后边界(含封号不质保)以商品页当天展示为准。
相关教程
- Claude Tool Use(工具调用 / Function Calling)入门:定义工具与返回 tool_result
- Claude API Python 快速上手
- Claude Connectors(连接器)怎么用:连接 Google Drive、Gmail 等与推荐
- Claude Code MCP 配置教程:claude mcp add、配置文件位置与常用 MCP
- Claude API 报错 400 / 401 / 403 / 413 / 500 怎么排查
参考资料
- Claude 开发者平台文档:MCP connector — https://platform.claude.com/docs/en/agents-and-tools/mcp-connector
0 条评论
还没有评论,来抢沙发~