用途:该技能帮助在 Claude Code CLI 中安装、配置和管理 MCP(Model Context Protocol)服务器,把 Claude Code 连接到外部工具、数据库和 API。
主要能力:支持三种传输协议——HTTP(远程服务)、SSE(Server-Sent Events 远程服务)、Stdio(本地进程);支持三种配置范围——本地(默认,仅当前项目)、项目(通过项目根目录 .mcp.json 与团队共享)、用户(本机所有项目可用),同名服务器优先级为本地 > 项目 > 用户。提供 OAuth 2.0 认证流程(凭据存于 ~/.mcp-auth/)以及 API Key、自定义请求头和 Stdio 环境变量传参。
常用命令:列出服务器 claude mcp list;查看详情 claude mcp get <server-name>;删除 claude mcp remove <server-name>;在 Claude Code 内用 /mcp 查看状态。添加示例:claude mcp add --transport http notion https://mcp.notion.com/mcp;claude mcp add --transport sse webflow https://mcp.webflow.com/sse;claude mcp add --transport stdio airtable --env AIRTABLE_API_KEY=YOUR_KEY -- npx -y airtable-mcp-server。Stdio 需用 -- 分隔环境变量与命令。还支持 claude mcp add-from-claude-desktop(仅 macOS 与 WSL)和 claude mcp add-json <name> '<json-config>'。
排查与调试:连接失败时检查 URL、网络与凭据;OAuth 未授权会显示“⚠ Needs authentication”,可通过使用该服务器工具触发浏览器授权,重置凭据用 rm -rf ~/.mcp-auth;项目范围服务器首次使用需批准,可用 claude mcp reset-project-choices 重置。调试可运行 claude --mcp-debug 或 claude --debug。
限制与说明:MCP 工具输出默认上限 25,000 tokens,可用 MAX_MCP_OUTPUT_TOKENS 调整;.mcp.json 支持 ${VAR} 与 ${VAR:-default} 环境变量展开;配置文件位置为本地 .claude/settings.local.json、项目 .mcp.json、用户 ~/.claude/settings.json。具体服务器清单与更多细节见资料中的 references/mcp_documentation.md。