Mascot Logo
ai-agents-tutorial

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 listclaude 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.jsonproject 服务器存储在项目根目录的 .mcp.json 文件中,你可以提交它,让整个团队获得相同的服务器。

项目作用域的服务器需要批准吗?

需要。Claude Code 在使用 .mcp.json 中定义的项目作用域服务器之前会请求你的批准,这样从版本控制拉取来的配置就不会未经你同意便运行工具。

如何查看或认证我的 MCP 服务器?

在 Claude Code 会话内使用 /mcp 查看每个服务器的状态与工具数量,并为需要 OAuth 的服务器完成登录。在终端,claude mcp list 列出所有已配置的服务器,claude mcp get <名称> 显示某个服务器的详情。