Part 2 · 第 14 课,共 16 课
在 Claude Code 中连接 MCP 服务器
让 Claude 能访问你的工具与数据。
11 min
第 1 步 / 共 5 步 · 什么是 MCP
到目前为止,Claude Code 处理的是你的文件和终端。而 MCP——模型上下文协议(Model Context Protocol)——让它能触及更远:你的问题追踪系统、数据库、监控面板,以及其他数百种工具。
MCP 是把 AI 工具连接到外部系统的开放标准。你连接一个服务器(对应某个具体工具,如 GitHub 或 Sentry),Claude 就能直接读取并操作该系统——而不必你把数据来回复制粘贴到对话里。
第 2 步 / 共 5 步 · 用 `claude mcp add` 添加服务器
你在终端中(而非会话内)用 claude mcp 命令添加服务器。大多数云端工具提供远程 HTTP 服务器:
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp有些工具则作为本地进程运行在你的机器上。这类服务器使用 stdio 传输方式,命令写在 -- 分隔符之后:
claude mcp add --transport stdio playwright -- npx -y @playwright/mcp@latest第 3 步 / 共 5 步 · 选择作用域(scope)
作用域决定一个服务器在哪些项目中加载,以及是否同时提供给你的团队:
local(默认)——只对你、只在当前项目。存储在~/.claude.json。project——通过项目根目录下的.mcp.json文件与团队共享,该文件可提交到版本控制。user——只对你,但在你的所有项目中可用。
claude mcp add --transport http paypal --scope project https://mcp.paypal.com/mcp第 4 步 / 共 5 步 · 管理与使用你的服务器
在终端中你可以运行 claude mcp list、claude mcp get <名称> 和 claude mcp remove <名称>。而在会话内部,/mcp 命令会显示每个服务器的状态和工具数量,也是你为需要 OAuth 的服务器完成登录的地方:
/mcp服务器连接好后,直接用自然语言提问——“过去 24 小时 Sentry 上最常见的错误是什么?”——Claude 就会使用该服务器的工具。有些服务器还会暴露可用 @ 提及引入的数据,例如 @github:issue://123。
第 5 步 / 共 5 步 · 检查点与本节回顾
本节回顾
- MCP 通过服务器把 Claude Code 连接到外部工具与数据。
- 在终端添加:
claude mcp add --transport http <名称> <url>(或--transport stdio … -- <命令>)。 - 作用域:
local(默认,仅你)、project(通过.mcp.json共享)、user(你的所有项目)。 - 用
claude mcp list/get/remove管理;在会话内用/mcp查看状态并完成认证。 - 项目服务器会请求批准;只连接你信任的服务器。
常见问题
如何在 Claude Code 中添加 MCP 服务器?
在终端运行 claude mcp add。远程工具:claude mcp add --transport http <名称> <url>(例如 claude mcp add --transport http sentry https://mcp.sentry.dev/mcp)。本地工具:claude mcp add --transport stdio <名称> -- npx -y <包名>。然后在会话内运行 /mcp 确认是否已连接。
MCP 服务器存储在哪里?
取决于作用域。local(默认)和 user 服务器存储在 ~/.claude.json。project 服务器存储在项目根目录的 .mcp.json 文件中,你可以提交它,让整个团队获得相同的服务器。
项目作用域的服务器需要批准吗?
需要。Claude Code 在使用 .mcp.json 中定义的项目作用域服务器之前会请求你的批准,这样从版本控制拉取来的配置就不会未经你同意便运行工具。
如何查看或认证我的 MCP 服务器?
在 Claude Code 会话内使用 /mcp 查看每个服务器的状态与工具数量,并为需要 OAuth 的服务器完成登录。在终端,claude mcp list 列出所有已配置的服务器,claude mcp get <名称> 显示某个服务器的详情。