向 Claude Code 添加 MCP 服务器

Claude Code 通过 claude mcp add 命令，或仓库根目录中的 .mcp.json 文件获取服务器配置。

macOS

~/.claude.json

Windows

~/.claude.json

Linux

~/.claude.json

项目文件

.mcp.json

顶层键

mcpServers

格式

json

远程服务器的 OAuth

●是

配置示例

此示例按该客户端所需的格式，添加 GitHub 托管的服务器和作为本地服务器的 Playwright。

{
  "mcpServers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/"
    },
    "playwright": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "@playwright/mcp@latest"
      ]
    }
  }
}

claude mcp add --transport http --scope project github https://api.githubcopilot.com/mcp/
claude mcp add --scope project playwright -- npx @playwright/mcp@latest

注意事项和特殊情况

• 默认的本地作用域和用户作用域配置保存在 ~/.claude.json 中；项目作用域配置位于 .mcp.json 中。
• 每个包含 url 的条目还必须指定 http 等 type；仅填写 url 会导致错误。
• 文件中的值支持展开 ${VAR} 和 ${VAR:-default}。
• 在会话中运行 /mcp，即可登录 OAuth 服务器。对于预先注册的 OAuth 应用，请传入 --client-id、--client-secret 和 --callback-port。

生成 Claude Code 配置 →

其他客户端