# Claude Code、Cursor、Codex、ChatGPT 配置远程 MCP 服务器（附可复制配置）

> 一篇收齐主流 AI 客户端添加远程 MCP 服务器的方法：Claude.ai、Claude Code、ChatGPT、Cursor、VS Code、Windsurf、Codex，以及只支持本地命令的客户端。附 OAuth 和 API Key 两种写法、验证方法和常见报错。

Published 2026-11-15 · https://toolsocket.top/blog/mcp-setup-claude-code-cursor

远程 MCP 服务器就是一个网址。不同客户端添加它的方式不一样，这里一次收齐。下面以 ToolSocket 的地址 `https://toolsocket.top/mcp` 为例，换成其他远程 MCP 服务器时，把网址替换掉即可。

不清楚 MCP 是什么，可以先看 [MCP 是什么？](https://toolsocket.top/blog/what-is-mcp)。

## 两种登录方式

远程 MCP 一般支持两种认证，二选一：

- **OAuth（推荐）**：添加网址后，客户端会打开服务商的登录页，你登录后点「允许」。不用复制密钥，可以随时在服务商后台撤销。
- **API Key**：在服务商的控制台创建一个 Key（ToolSocket 的 Key 以 `ts_live_` 开头），写进请求头 `Authorization: Bearer ts_live_…`。适合脚本、服务器和不支持 OAuth 的客户端。

> API Key 等同于你的账户余额，不要提交到 Git 仓库，也不要贴到公开的地方。建议给每个 Key 设置消费上限。

## Claude.ai 和 Claude 桌面版

1. 设置 → **Connectors** → **Add custom connector**（添加自定义连接器）。
2. 名称填 `ToolSocket`，URL 填 `https://toolsocket.top/mcp`，点添加。
3. 点 **Connect**，登录，点 **Allow**。
4. 新建对话，在输入框下方的工具菜单里确认连接器已启用。

自定义连接器需要 Claude 付费套餐。Team 和 Enterprise 版可能需要管理员先在组织设置里添加。

## Claude Code

```bash
# OAuth：添加后在 Claude Code 里输入 /mcp，选 toolsocket → Authenticate
claude mcp add --transport http toolsocket https://toolsocket.top/mcp

# 或者用 API Key
export TOOLSOCKET_API_KEY=ts_live_…
claude mcp add --transport http toolsocket https://toolsocket.top/mcp \
  --header "Authorization: Bearer $TOOLSOCKET_API_KEY"
```

`claude mcp list` 可以查看已添加的服务器和连接状态。

## ChatGPT

1. 设置 → **Apps & Connectors** → Advanced settings → 打开 **Developer mode**（开发者模式）。
2. 回到 Apps & Connectors → **Create**。MCP 服务器 URL 填 `https://toolsocket.top/mcp`，认证方式选 **OAuth**。
3. 登录 ToolSocket 并允许，然后在对话里启用这个连接器。

## Cursor

编辑 `~/.cursor/mcp.json`（全局）或项目里的 `.cursor/mcp.json`：

```json
{
  "mcpServers": {
    "toolsocket": {
      "url": "https://toolsocket.top/mcp",
      "headers": { "Authorization": "Bearer ts_live_…" }
    }
  }
}
```

去掉 `headers` 这一项，就会改用 OAuth 登录。保存后到 Cursor 设置的 MCP 页面，确认 toolsocket 显示为已连接。

## VS Code（GitHub Copilot）

在项目里创建 `.vscode/mcp.json`：

```json
{
  "servers": {
    "toolsocket": { "type": "http", "url": "https://toolsocket.top/mcp" }
  }
}
```

打开文件后点上方出现的 **Start**，按提示登录。在 Copilot Chat 里切到 Agent 模式才能调用 MCP 工具。

## Windsurf

编辑 `~/.codeium/windsurf/mcp_config.json`：

```json
{
  "mcpServers": {
    "toolsocket": {
      "serverUrl": "https://toolsocket.top/mcp",
      "headers": { "Authorization": "Bearer ts_live_…" }
    }
  }
}
```

注意 Windsurf 用的字段名是 `serverUrl`，不是 `url`。

## Codex

编辑 `~/.codex/config.toml`：

```toml
[mcp_servers.toolsocket]
url = "https://toolsocket.top/mcp"
bearer_token_env_var = "TOOLSOCKET_API_KEY"
```

然后在终端里 `export TOOLSOCKET_API_KEY=ts_live_…` 再启动 Codex。

## 只支持本地命令的客户端（Cline、Zed 等）

有些客户端只能启动本地程序（stdio），不能直接填网址。可以用一个本地桥接程序转发：

```json
{
  "mcpServers": {
    "toolsocket": {
      "command": "npx",
      "args": ["-y", "toolsocket", "mcp"],
      "env": { "TOOLSOCKET_API_KEY": "ts_live_…" }
    }
  }
}
```

需要本机装有 Node.js 18 或更高版本。通用的替代方案是 `npx -y mcp-remote https://toolsocket.top/mcp --header "Authorization: Bearer ts_live_…"`。

## 不想配 MCP：用 SKILL.md

Claude Code、Codex、OpenClaw 这类能读技能文件、能执行命令的智能体，可以直接对它说：

> 对你的智能体说: "set up https://toolsocket.top/SKILL.md"

它会读这份说明，之后用 `curl` 调用 REST 接口，不需要任何配置。

## 怎么确认接好了

接好后问一句：

> 对你的智能体说: "用 ToolSocket 查一下东京未来 3 天的天气。"

天气是免费工具，不扣余额。如果 AI 回复了具体的温度和天气，并且能看到它调用了 `discover_tools` 和 `run_tool`，就说明连接正常。

## 常见报错

| 现象 | 原因和解决 |
|---|---|
| 401 / `AUTH_REQUIRED` | 没登录或 Key 不对。OAuth 方式重新点一次 Authenticate；Key 方式检查请求头是不是 `Bearer ` 加完整的 Key |
| 402 / `INSUFFICIENT_BALANCE` | 余额不足。到控制台充值，或者让 AI 调用 `create_topup_link` 生成一个付款链接给你 |
| 402 / `DAILY_LIMIT` | 达到了你自己设置的每日消费上限 |
| 工具列表是空的 | 客户端没刷新。重启客户端，或在 Cursor / VS Code 里关掉再打开这个服务器 |
| AI 说「我无法访问抖音」 | 连接器没在当前对话里启用，或者 AI 没意识到可以用工具。直接说「用 ToolSocket 查」 |
| 429 / `RATE_LIMITED` | 调用太快（每个账号每分钟 60 次），等几秒再试 |

## 常见问题

### 一个客户端可以同时连多个 MCP 服务器吗？

可以。每个服务器起一个不同的名字就行。不过工具太多会占用上下文，也会让模型选错工具，用不到的服务器建议关掉。

### OAuth 登录后，换电脑要重新登录吗？

看客户端。Claude.ai 和 ChatGPT 的连接器跟着账号走，换电脑不用重新登录；Claude Code、Cursor 这类本地客户端的授权保存在本机，换电脑要重新登录一次。用 API Key 的话，在新电脑上配置同一个 Key 即可。

### 公司网络连不上怎么办？

远程 MCP 走普通的 HTTPS（443 端口）。如果公司代理拦截了 `toolsocket.top`，需要请 IT 放行，或者在客户端里配置代理。
