用途:在 Claude Code 中按项目管理和维护 MCP 服务器,把 Claude Code 连接到外部工具与数据源。
主要能力:支持两类传输——本地 stdio 服务器(通过 npx、bunx、uvx、go run 等命令启动,无需认证)和远程 HTTP+SSE 服务器(基于 URL,使用 OAuth 2.1 认证,headers 中用 ${VAR_NAME} 引用令牌而非硬编码)。可在运行时通过 /mcp 查看全部服务器及连接状态,用 /mcp enable <server>、/mcp disable <server> 临时启停(仅当前会话生效,永久修改需编辑 .mcp.json)。支持远程服务器的 OAuth 授权、按 URL 缓存元数据与提权(step-up)重授权;支持声明 {"tools": {"listChanged": true}} 的服务器在工具集变化时推送 list_changed 通知,无需重启会话即可刷新工具。
使用方式:配置分三种范围——项目级 .mcp.json(推荐,可提交团队或加入 .gitignore)、用户级 ~/.claude/settings.json、插件级 plugin.json。可用 jq 检查配置,如 jq -r '.mcpServers | keys[]' .mcp.json、jq empty .mcp.json。注意:新增项目级 .mcp.json 服务器后需用户一次性批准(通过 /mcp 或重启 CLI 会话)才能调用,此为预期行为;OAuth 配置过期可先 disable 再 enable 刷新。
适用场景:新项目搭建 MCP、交互式安装服务器、配置 OAuth 远程服务器、MCP 配置合规检查、连接失败排查、实现动态发现、生成项目标准报告。
限制:资料未提供具体价格、平台支持范围与性能数据;细节(OAuth 流程、动态发现、排查脚本、配置模式示例)需参阅 REFERENCE.md。