8 MCP 接入：让 Claude Code 连接文档、浏览器和内部工具

查看大图

前面几篇讲的是让 Claude Code 更懂你的项目。MCP 解决的是另一件事：让它连接项目以外的工具。

比如文档系统、浏览器、GitHub、数据库只读查询、设计稿、监控平台、内部知识库。没有 MCP 时，你只能把信息复制到对话里；有 MCP 后，Claude Code 可以通过配置好的 server 调用工具，拿到更真实的上下文。

MCP 的价值是把外部系统接进 Claude Code，但我会先接只读文档、issue、浏览器检查这类低风险工具。写权限和生产系统要等流程成熟后再考虑。

查看大图

这张图的重点是顺序：先让工具提供上下文，再让人确认行动，再逐步开放执行能力。这样不会因为接了 MCP 就把边界全部打穿。

MCP 适合解决什么问题

适合 MCP 的场景：

查看大图

接入 MCP 时，先列清工具用途、可读写范围、鉴权方式、失败处理和日志边界。

• 查官方文档，不靠模型记忆。
• 搜 GitHub issue 或 PR。
• 从内部知识库查项目约定。
• 读取监控或日志摘要。
• 连接浏览器检查页面。
• 对数据库做只读查询。

不适合 MCP 的场景：

• 把生产数据库写权限直接交出去。
• 把服务器 root 权限暴露成工具。
• 把密钥写进可提交的配置文件。
• 为了省一步复制，把敏感系统全接上。

MCP 是连接能力，不是越多越好。接得越多，权限设计越重要。

基本管理命令

官方 MCP 文档里列了几个常用命令：

查看大图

看完《MCP 接入：让 Claude Code 连接文档、浏览器和内部工具》后，建议用一分钟复盘：关键概念是否分清、练习步骤是否可复现、结论能不能换成自己的话。

claude mcp list
claude mcp get github
claude mcp remove github

在 Claude Code 会话中，也可以用：

/mcp

/mcp 面板可以查看 server 状态和工具数量。如果 server 暴露了工具能力但没有工具，面板里也会提示。实际排查 MCP 问题时，这个面板很有用。

推荐的第一套 MCP

新手不要一口气接十个 server。我建议先从三类开始：

1. 文档类：查 API 文档、框架文档、项目手册。
2. 代码协作类：GitHub issue、PR、review comment。
3. 浏览器类：打开页面、截图、检查交互。

这三类最容易提升工作质量，也相对容易做权限控制。数据库、生产日志、内部平台，可以等你熟悉后再接。

配置要区分作用域

项目共享的 MCP 配置和个人 MCP 配置不要混在一起。团队项目里可以提交只读、低风险、大家都需要的 server 配置。个人 token、私有工具、实验性 server，放个人目录或本机配置。

如果一定要在项目里写 MCP 配置，也要避免把密钥写死。用环境变量，并确认 .gitignore 不会漏。

一个实用工作流

比如你想让 Claude Code 根据官方文档修改一个 API 调用，可以这样说：

查看大图

读完《MCP 接入：让 Claude Code 连接文档、浏览器和内部工具》后，可以先挑一个小样例走完整流程，再判断哪些步骤已经能独立完成。

查看大图

读到这里，可以把《MCP 接入：让 Claude Code 连接文档、浏览器和内部工具》整理成一张复盘表：先说清主线，再拿一个小任务检查结果。

请先通过 MCP 查询当前官方文档，再检查项目里的调用方式。
不要凭记忆改。列出文档依据后，再给修改计划。

这句话很关键：先查资料，再改代码。AI 工具最怕的是用旧知识写新接口，MCP 能明显降低这个问题。

下一篇讲 Subagents。MCP 是接工具，Subagents 是把任务分给不同角色处理。

参考资料：

• Connect Claude Code to tools via MCP
• Claude Code settings
• Extend Claude Code