Claude Code MCP 集成
Model Context Protocol 让 Claude Code 通过明确的服务器连接使用外部上下文和工具。当仓库文件不足以完成任务时，MCP 是更合适的扩展路径。
- 最近核验
- 适用版本
- 适用于 Claude Code 2.1.x。本机使用 2.1.198 检查 CLI 拼写；当前官方文档可能包含更新的 2.1.x 行为。
- 核验方式
- 2026-07-19 对照官方文档、CLI reference 和 changelog。本机检查 MCP add/get/list/remove 语法；Notion 连通性、OAuth 和工具执行依据官方文档。
可复现实践
在 local scope 评估一个远程 MCP server
不嵌入凭据地添加官方示例 server，检查 scope 和批准状态，只测试必要能力，最后移除。
准备
- 可信的临时仓库，并获准连接对应 provider。
- 理解 provider 的数据访问和 OAuth scopes。
- 不把秘密直接放进受版本控制的 .mcp.json。
执行步骤
检查本机 MCP CLI
修改配置前确认 transport 和 scope 选项。
步骤 1 claude mcp --help claude mcp add --help按官方示例添加到 local scope
local scope 把配置限制在当前用户和项目。
步骤 2 claude mcp add --transport http --scope local notion https://mcp.notion.com/mcp使用前检查
检查 URL、scope、连接或 pending approval 状态和 OAuth 权限。
步骤 3 claude mcp get notion claude mcp list测试最小只读请求
预期结果
server 以预期 local scope 出现，认证状态明确，只暴露预期 tools 或 resources。
验证
- 把 claude mcp get 输出与目标 URL 和 scope 核对。
- 批准写请求前检查 tool list。
- 清理后 claude mcp get notion 不应再找到 local entry。
失败处理
Pending approval
在可信项目打开 Claude Code，检查 workspace trust 和 server approval。
认证或连接错误
检查 URL、provider 状态、OAuth scope、proxy/TLS，不要把 token 粘贴进对话。
清理或回退
- 运行 claude mcp remove --scope local notion。
- 如果完成 OAuth，还需在 provider 侧撤销授权。
边界与不适用场景
- MCP server 会引入外部内容和 prompt injection 风险，应逐个信任并最小化。
- 当前官方 reference 已弃用 SSE；provider 支持时优先 HTTP。
MCP 增加什么
MCP 可暴露设计文件、工单、内部 API、文档、数据库、搜索系统或自定义工具，减少复制粘贴上下文，让 Claude Code 使用当前外部状态。
适用场景
常见场景包括读取产品规格、查询 issue 详情、检查设计组件、查询内部服务，以及执行本地 shell 命令无法完成的组织内动作。
访问边界
排查 MCP 问题
当 MCP 工具行为异常时，先检查服务器是否配置、连接、授权，并在当前 Claude Code 会话中可见，再调整提示词。
| Command | Description |
|---|---|
/mcp | 在会话内配置和检查 MCP servers。 |
claude mcp | 在终端管理 MCP servers。 |
claude mcp login <server> | 不打开 UI 面板即可执行 MCP OAuth。 |
claude mcp
claude mcp login sentry
claude mcp logout sentry常见 MCP 服务器类型
团队常连接 issue 系统、设计工具、文档搜索、数据库和内部 API。每个 server 应只暴露该流程真正需要的工具。
Issue 和工单系统
读取 issue 详情、标签和验收标准，让修复基于最新 tracker 状态。
阅读指南设计和产品上下文
在实现 UI 时暴露组件、规格或 design tokens。
阅读指南内部 API 和文档
让 Claude Code 查询实时文档或服务元数据，而不是依赖过期粘贴内容。
阅读指南先只读调研
先从搜索和读取工具开始，只有流程可审计时才增加写操作。
阅读指南