---
title: "适用于 13 个客户端和 60 个服务器的 MCP 配置生成器 · DotsAgent"
description: "选择服务器和客户端，即可生成符合其格式要求的配置文件：mcp.json、config.toml、YAML 或 settings.json，并获取 CLI 命令。支持 13 个客户端和 60 个服务器。"
url: https://dotsagent.io/zh/mcp/config
---

连接 · 工具

# MCP 配置生成器

选择客户端和所需的服务器，即可获取符合该客户端格式要求的配置、相应的 CLI 命令（如果支持），以及无法运行的项目提示。

客户端

操作系统

范围

服务器（3）

- **GitHub**
- **Context7**
- **Playwright** 本地

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

`.mcp.json`

```
{
  "mcpServers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/"
    },
    "context7": {
      "type": "http",
      "url": "https://mcp.context7.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 --transport http --scope project context7 https://mcp.context7.com/mcp
claude mcp add --scope project playwright -- npx @playwright/mcp@latest
```

[Claude Code 的完整配置说明 →](https://dotsagent.io/zh/mcp/clients/claude-code)

## 输出说明

### 托管或本地

托管服务器是客户端通过 Streamable HTTP 访问的 URL；服务器由供应商运行，无需安装任何内容。本地服务器通过 npx、uvx 或 docker 作为子进程启动，并使用这台机器的访问权限运行。如果服务器同时提供这两种方式，生成器会优先选择托管模式，并允许你切换。

### 密钥不会写入文件

生成器绝不会写入真实密钥，而是使用各客户端自己的引用语法：Claude Code 中的 ${VAR}、Cursor 和 Windsurf 中的 ${env:VAR}、VS Code 中的 inputs 提示、Gemini CLI 中的 $VAR、Codex 中的 env_vars，以及 Continue 中的 ${{ secrets.VAR }}。其他客户端会使用 <VAR> 占位符，供你填写。

### 首次使用时进行 OAuth 授权

此处大多数托管服务器都通过 OAuth 登录。客户端会在首次连接时打开浏览器，也可以运行其登录步骤：在 Claude Code 中运行 /mcp，在 Codex 中运行 codex mcp login，在 Devin 中运行 devin mcp login，或在 OpenClaw 中运行 openclaw mcp login。Slack、Asana 和 HubSpot 只接受预先注册的客户端，请确认你的客户端受支持。

### 编辑后重新加载

Claude Desktop 会在启动时读取配置文件，因此修改后请退出并重新打开；在 macOS 上，其日志位于 ~/Library/Logs/Claude。如果新服务器没有出现在其他客户端中，请重启客户端或重新加载窗口。在 OpenClaw 中，运行 openclaw mcp doctor <name> --probe 可测试单个服务器。

## 配置常见问题

### Cursor 和 Claude Code 的 mcp.json 应放在哪里？

Cursor 会为每个项目读取项目中的 .cursor/mcp.json，或读取 ~/.cursor/mcp.json。Claude Code 会读取仓库根目录下的 .mcp.json 作为项目级配置，并将本地级和用户级配置保存在 ~/.claude.json 中。VS Code 使用 .vscode/mcp.json，Codex 则使用 ~/.codex/config.toml，而不是 JSON。

### 为什么 claude_desktop_config.json 无法加载远程服务器？

Claude Desktop 只会从该文件读取本地服务器。远程服务器需要在“设置 > 连接器”中添加为自定义连接器，并在此处粘贴 URL 和登录。因此，生成器会单独列出这些 URL。

### 如何避免将 API 密钥提交到 .mcp.json？

请引用环境变量，而不要直接粘贴密钥。Claude Code 会展开 ${VAR} 和 ${VAR:-default}，Cursor 会展开 ${env:NAME}，VS Code 则可以通过 inputs 条目提示输入密钥。启动客户端前，请在 shell 或密钥管理器中设置该变量。

### 能否在不同客户端之间共用一份 MCP 配置？

不能直接通用：大多数客户端使用顶层键 mcpServers，但 .vscode/mcp.json 使用 servers，Zed 使用 context_servers，Codex 使用 mcp_servers 表。有些客户端可以导入其他客户端的配置文件：VS Code 会发现 Claude Desktop、Cursor 和 Windsurf 的配置，Continue 可以直接导入 mcp.json，JetBrains AI Assistant 则提供“从 Claude 导入”选项。

### 为什么 Claude Desktop 在 Windows 上运行 npx 会失败？

MCP servers README 在 Windows 上通过 cmd 运行 npx：使用 command cmd，并将 /c、npx 和软件包作为参数。选择 Claude Desktop 和 Windows 后，生成器会自动添加此包装命令。

### 应该使用服务器的托管版本还是本地版本？

托管版更简单：无需安装运行时，而且 OAuth 可以取代保存在磁盘上的长期令牌。如果服务器需要访问本机文件或凭据，或者没有托管端点（例如 Filesystem、Playwright 或 AWS API server），则适合使用本地版。

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

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