用途
本技能用于把 MCP(Model Context Protocol,模型上下文协议)服务器连接到 Claude Code,从而接入 GitHub、Notion、数据库、项目管理工具以及自定义 API 等外部服务。
主要能力
- 支持三种传输方式:HTTP(远程,推荐)、stdio(本地)、SSE(已废弃,建议迁移到 HTTP)。
- 提供 Local(默认)、project(.mcp.json,可经 git 共享)、user(跨项目)三种配置作用域。
- 支持手动编写 .mcp.json 配置文件,包含 HTTP 与 stdio 两种服务器配置示例。
- 支持环境变量展开:
${VAR}与${VAR:-default},可用于命令路径、参数、环境设置和 HTTP 头。 - 支持 OAuth 2.0 认证(通过 /mcp 触发浏览器登录,令牌自动刷新)以及 API Token 认证(header 或环境变量方式)。
- 提供服务器管理命令:
claude mcp list、claude mcp get <name>、claude mcp remove <name>、claude mcp reset-project-choices。 - 支持通过
@引用资源、通过/mcp__servername__promptname调用提示。 - 可配置输出上限与超时:
MAX_MCP_OUTPUT_TOKENS、MCP_TIMEOUT。 - 提供企业集中配置与管理(managed-mcp.json、allowlist/denylist)。
使用方式
基本流程为:确定目标服务 → 选择传输方式 → 收集凭据 → 选择作用域 → 用 claude mcp add 添加 → 用 /mcp 认证 → 测试连接 → 使用资源与提示。
添加 HTTP 服务器:
claude mcp add --transport http <name> <url>
添加 stdio 服务器(注意 -- 分隔符,npx 需加 -y):
claude mcp add --transport stdio <name> <command> [args...]
带认证头:
claude mcp add --transport http secure-api https://api.example.com/mcp \
--header "Authorization: Bearer your-token-here"
指定项目作用域会生成 .mcp.json:
claude mcp add --transport http github https://mcp.github.com --scope project
资源与提示调用格式:
@server:protocol://resource/path
/mcp__servername__promptname [arguments]
适用场景
- 将 Claude Code 与 GitHub、Notion、Slack、Google Drive、Sentry、Linear 等服务集成。
- 接入本地文件系统、PostgreSQL、MongoDB、Redis、AWS、Airtable、Brave Search、Git 等服务器。
- 团队通过项目作用域共享集成配置,或个人跨项目统一配置。
- 企业由管理员集中下发 MCP 配置与允许/拒绝列表。
限制与注意事项
- 文档包含安全警告:使用第三方 MCP 服务器需自行承担风险,Anthropic 未验证所有服务器的正确性与安全性。
- 拉取不可信内容的服务器可能带来提示注入风险,建议使用可信来源、限制权限并定期审查。
- 凭据管理建议使用环境变量,避免将令牌硬编码或提交到 git。
- 默认输出限制为 1 万 token 警告阈值、2.5 万 token 上限;MCP 服务器启动超时默认 5 秒。
- 文档在“Troubleshooting”处结束,未提供后续故障排查内容。
- 关于收费、价格、具体平台支持范围等事实,资料中暂未提供。