---
title: "Claude Code MCP 配置：文件路径、键和示例 · DotsAgent"
description: "从 Anthropic 向 Claude Code 添加 MCP 服务器：了解配置文件位置、顶层键和格式、远程 OAuth 支持，以及配置示例。"
url: https://dotsagent.io/zh/mcp/clients/claude-code
---

Anthropic

# 向 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。

`.mcp.json`

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

`shell`

```
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 配置 →](https://dotsagent.io/zh/mcp/config#client=claude-code)

## 其他客户端

[Claude Desktop](https://dotsagent.io/zh/mcp/clients/claude-desktop)

[Cursor](https://dotsagent.io/zh/mcp/clients/cursor)

[VS Code (GitHub Copilot)](https://dotsagent.io/zh/mcp/clients/vscode-copilot)

[Windsurf / Devin Desktop](https://dotsagent.io/zh/mcp/clients/windsurf)

[Zed](https://dotsagent.io/zh/mcp/clients/zed)

[OpenAI Codex CLI](https://dotsagent.io/zh/mcp/clients/codex-cli)

[Gemini CLI](https://dotsagent.io/zh/mcp/clients/gemini-cli)

[ChatGPT](https://dotsagent.io/zh/mcp/clients/chatgpt)

[OpenClaw](https://dotsagent.io/zh/mcp/clients/openclaw)

[Cline](https://dotsagent.io/zh/mcp/clients/cline)

[Continue](https://dotsagent.io/zh/mcp/clients/continue)

[JetBrains AI Assistant](https://dotsagent.io/zh/mcp/clients/jetbrains-ai)

## 来源

1. [code.claude.com](https://code.claude.com/docs/en/mcp)/docs/en/mcp

为 AI agent 开发者提供的独立参考资料。与此处提及的任何厂商均无关联。

© 2026 DotsAgent · 事实核查日期：2026年10月1日