ToolSocket / 教程 / 指南

Claude Code、Cursor、Codex、ChatGPT 配置远程 MCP 服务器(附可复制配置)

指南 · · 4 分钟读完 · ToolSocket 团队

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

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

不清楚 MCP 是什么,可以先看 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

# 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:

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

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

VS Code(GitHub Copilot)

在项目里创建 .vscode/mcp.json:

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

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

Windsurf

编辑 ~/.codeium/windsurf/mcp_config.json:

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

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

Codex

编辑 ~/.codex/config.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),不能直接填网址。可以用一个本地桥接程序转发:

{
  "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 放行,或者在客户端里配置代理。

开始用 ToolSocket

一个 MCP 地址接入 881 个数据工具:抖音、小红书、微信、微博、B站、TikTok、YouTube、DeFi……按次计费,失败自动退款。

Claude Code 里一行接入: claude mcp add --transport http toolsocket https://toolsocket.top/mcp

相关阅读