在 Claude Code 中配置 MCP 服务器：实用入门指南

AI 编程助手的实用程度取决于它能触及的工具。开箱即用的它虽然可以读取和编辑文件，但无法查阅最新的库文档、驱动浏览器或读取错误追踪器。MCP 服务器填补了这一空白，而且配置只需几分钟。

今天是 2026 年 10 月 26 日。团队不断引入更多的 AI 工具，而每款新工具都会引发一个合情合理的问题：它能接触什么，我又该如何保证它的安全性？正因如此，了解 MCP 的配置原理才尤为重要，而不是盲目地粘贴命令。

什么是 MCP 服务器

MCP 代表 Model Context Protocol（模型上下文协议）。MCP 服务器是一个向助手公开一组工具的小程序。某个服务器可能负责搜索文档，另一个可能控制网络浏览器，还有一个可能查询数据库。助手能够识别这些工具，并在任务需要时调用它们。

服务器有两种运行方式：

• 本地（stdio）： 助手会在你的机器上启动一个程序，通常使用 npx 或 uvx.
• 远程（http）： 助手连接到一个 URL，你通过 OAuth 或 API 密钥登录。

第 1 步：确定作用域

Claude Code 主要可以在两个位置存储服务器：

• 用户作用域： 在你机器上的每个项目中均可用。
• 项目作用域： 保存在项目文件夹中的 .mcp.json 文件内，因此配置会随项目一同传递。

对于初学者配置，项目作用域是更为清爽的选择。任何打开该文件夹的人都能获得相同的工具。

第 2 步：使用命令行添加服务器

通用格式为 claude mcp add，接着是名称，然后是启动服务器的命令。以下是几个不需要 API 密钥的服务器：

claude mcp add -s project context7 -- npx -y @upstash/context7-mcp
claude mcp add -s project playwright -- npx -y @playwright/mcp@latest --headless
claude mcp add -s project filesystem -- npx -y @modelcontextprotocol/server-filesystem /path/to/project
claude mcp add -s project --transport http sentry https://mcp.sentry.dev/mcp

Context7 为助手提供最新的库文档。Playwright 允许它在真实的浏览器中打开网页并进行测试。Filesystem 服务器仅在你列出的文件夹内进行读写。Sentry 是远程的，因此首次使用时会要求你登录。

需要密钥的服务器工作方式相同，密钥作为环境变量传入：

claude mcp add -s project firecrawl -e FIRECRAWL_API_KEY=$FIRECRAWL_API_KEY -- npx -y firecrawl-mcp

第 3 步：或者直接编写配置文件

上述命令只是写入一个 .mcp.json 文件。你可以手动创建它，这样更容易进行审查并纳入版本控制：

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"]
    },
    "playwright": {
      "command": "npx",
      "args": ["-y", "@playwright/mcp@latest", "--headless"]
    },
    "sentry": {
      "type": "http",
      "url": "https://mcp.sentry.dev/mcp"
    }
  }
}

第 4 步：检查一切是否连接正常

在项目文件夹中重启 Claude Code。首次检测到该文件时，它会提示你批准项目服务器。然后，在终端中运行 claude mcp list ，或在会话内运行 /mcp 。你应该能看到每个服务器以及它是否已连接。像 Sentry 这样的远程服务器在同一界面上完成登录。

第 5 步：添加需要凭据的服务器

一旦基础功能正常运行，即可添加项目真正需要的服务：

• Git 和 GitHub： uvx mcp-server-git 用于本地仓库，或使用带有个人访问令牌的 GitHub 远程服务器。
• 搜索： Exa 或 Brave Search，两者均提供免费层。
• 数据库： Postgres 服务器或 Supabase 服务器。
• 基础设施： Kubernetes、Docker、AWS 和 Cloudflare 服务器。

至关重要的安全习惯

• 切勿将机密写入配置文件。 .mcp.json 支持 ${VAR} 变量展开，因此请引用环境变量而不是直接粘贴密钥。在使用 -e KEY=$KEY之后请检查该文件，因为字面值可能会被直接写入其中。
• 尽可能使用只读权限。 仅能读取的数据库角色或权限受限的云凭据可以限制误操作造成的损害。
• 尽可能暴露最小范围的文件夹 给 Filesystem 服务器。
• 仅安装你使用的工具。 每个服务器都会将其工具列表添加到助手的上下文中，这会占用空间，并可能对工具的选择产生干扰。
• 关注内存占用。 无头浏览器资源开销较大。一次只运行一个大型任务。

结语

添加 MCP 服务器只需少量配置即可获得显著提升。从包含几个免密钥服务器的项目级 .mcp.json 入手，确认它们连接成功，然后再添加需要凭据的服务器。在批准之前，请仔细审查每个服务器可以接触的内容。

优点

• 为助手提供实时文档、浏览器测试和错误数据。
• 项目级的 .mcp.json 使团队中的每个人都能复现相同的配置。
• 许多服务器都是免费的或提供免费层。
• 服务器可以在数秒内添加或移除。

缺点

• 每个服务器都会增加助手的上下文大小。
• 具有数据库或云账户写入权限的服务器如果被误用，可能会造成严重损害。
• 包名称和参数标志会随时间变化，因此命令可能会过时。
• 远程服务器依赖第三方服务的正常运行时间和登录流程。

注意事项

本文仅供学习参考。作者已尽力确保文中的包名、URL 和参数标志准确无误，但它们变动频繁，因此在安装前请查阅各服务器的官方文档。请将所有占位符路径、令牌和项目引用替换为你自己的值，切勿提交真实的密钥，并在批准前核实服务器可以访问的内容。

常见问题解答

• 什么是 MCP 服务器？ — 为 AI 助手提供额外工具（如搜索文档或控制浏览器）的小程序或远程服务。
• Claude Code 在哪里存储 MCP 设置？ — 存储在你的用户设置中，或者在使用项目作用域时存储在项目文件夹的 .mcp.json 文件中。
• MCP 服务器需要 API 密钥吗？ — 并非全部需要。Context7、Playwright、Filesystem 和 Sentry 无需密钥即可工作；Firecrawl、Exa 和 Brave 则需要密钥。
• 如何检查服务器是否正常运行？ — 在终端中运行 claude mcp list ，或在会话内运行 /mcp 以查看连接状态。
• 是否可以安全地将 API 密钥存入 .mcp.json? — 不可以。请使用环境变量引用，以便安全地共享或提交该文件。
• 过多的 MCP 服务器会降低运行速度吗？ — 会的。每个服务器都会向上下文中添加工具描述，因此请仅安装你实际使用的服务器。
• stdio 与 http 服务器之间有什么区别？ — Stdio 服务器作为由你启动的本地进程运行；http 服务器则是你连接到的远程 URL，通常带有 OAuth 认证。
• 数据库服务器是否应该获得写入权限？ — 除非确实需要写入，否则建议优先使用只读角色，并先在非生产副本上进行测试。

标签

#MCP #ModelContextProtocol #ClaudeCode #AITools #DeveloperTools #Playwright #Context7 #Automation #Productivity #CodingAssistant