Claude Code

MCP 配置与推荐

让 Claude Code 安全连接 GitHub、浏览器、文档和数据库

MCP（Model Context Protocol）让 Claude Code 调用外部工具。例如，它可以读取 GitHub Issue、测试网页或查询数据库。

配置作用域

作用域	可用范围	适合场景
`local`	当前用户的当前项目	个人测试，默认选择
`project`	当前项目，可通过 `.mcp.json` 与团队共享	团队统一工具配置
`user`	当前用户的所有项目	每个项目都需要的个人工具

团队共享 .mcp.json 时不要写入真实令牌。使用环境变量引用凭证，并把本地密钥文件加入 .gitignore。

基本命令

在普通终端中执行以下命令，不要在 Claude 对话框中执行：

# 添加远程 HTTP 服务
claude mcp add --transport http <名称> <URL>

# 添加本地 stdio 服务
claude mcp add --transport stdio <名称> -- <启动命令> [参数]

# 管理服务
claude mcp list
claude mcp get <名称>
claude mcp remove <名称>

stdio 命令中的 -- 用来分隔 Claude 参数和 MCP 服务启动命令。

推荐服务

Context7：查询最新库文档

claude mcp add --transport http context7 https://mcp.context7.com/mcp

适合查询框架和库文档。添加后用 claude mcp get context7 检查配置。

Playwright：浏览器自动化

claude mcp add --transport stdio playwright -- npx -y @playwright/mcp@latest

它可以打开网页、点击和截图。不要让它访问包含私人数据的浏览器配置文件。

GitHub：Issue、PR 和仓库操作

claude mcp add --transport http github https://api.githubcopilot.com/mcp/ \
  --header "Authorization: Bearer ${GITHUB_PAT}"

为令牌只授予任务所需的仓库和操作权限。不要把真实令牌写进 .mcp.json 或 shell 历史。

Filesystem：额外目录访问

claude mcp add --transport stdio filesystem \
  -- npx -y @modelcontextprotocol/server-filesystem /允许访问的/目录

Claude Code 本身已经可以访问当前项目。只有确实需要项目外文件时才添加，并指定最小目录。

数据库

数据库 MCP 的实现和参数差异较大。配置时遵循以下规则：

使用只读数据库账号。
限制可访问的库、schema 和来源 IP。
凭证放在环境变量或本地密钥管理器中。
先连接测试库，不要直接连接生产库。
要求 Claude 在执行查询前展示 SQL。

验证连接

claude mcp list

进入 Claude Code 后输入：

/mcp

确认服务状态正常。再用只读任务测试，例如“查询 React useEffect 的最新文档”，不要一开始就执行写操作。

该装多少个

只添加当前任务需要的服务。每个 MCP 都会增加工具描述和上下文负担，也扩大可访问范围。新手可以从 Context7 或 Playwright 中选一个开始。

常见问题

MCP 显示连接失败

先运行 claude mcp get <名称> 检查命令、URL 和环境变量。stdio 服务首次通过 npx 下载时可能较慢，也可能受 Node.js 版本影响。

当前项目看不到 MCP

检查添加时使用的作用域。local 配置只在添加它的项目中可用。需要跨项目使用时，以 --scope user 重新添加。

修改 .mcp.json 后没有生效

先检查 JSON 语法，再完全退出当前 Claude Code 会话并重新启动。项目级服务首次使用时可能需要确认信任。

更多配置方式以 Claude Code 官方 MCP 文档为准。

加群 & 客服