ToolSocket / 教程 / 指南
Claude Code、Cursor、Codex、ChatGPT 配置远程 MCP 服务器(附可复制配置)
一篇收齐主流 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 桌面版
- 设置 → Connectors → Add custom connector(添加自定义连接器)。
- 名称填
ToolSocket,URL 填https://toolsocket.top/mcp,点添加。 - 点 Connect,登录,点 Allow。
- 新建对话,在输入框下方的工具菜单里确认连接器已启用。
自定义连接器需要 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
- 设置 → Apps & Connectors → Advanced settings → 打开 Developer mode(开发者模式)。
- 回到 Apps & Connectors → Create。MCP 服务器 URL 填
https://toolsocket.top/mcp,认证方式选 OAuth。 - 登录 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 这类能读技能文件、能执行命令的智能体,可以直接对它说:
它会读这份说明,之后用 curl 调用 REST 接口,不需要任何配置。
怎么确认接好了
接好后问一句:
天气是免费工具,不扣余额。如果 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
相关阅读
- 实操教程 · 中文用 3 个免费工具让 AI 写技术周报:GitHub + Hacker News + arXiv(附真实调用)让 Claude 或 ChatGPT 自动收集本周 GitHub 热门项目、Hacker News 首页和 arXiv 最新论文,整理成一份技术周报。本文每一步都是真实调用记录,附提问模板、返回结果和一个常见误区:按相关度搜索拿到的不是「最新」。全程免费。
- 指南 · 中文让 Claude 直接读抖音数据:热榜、视频、评论、博主(MCP 接入教程)不用写爬虫、不用申请抖音开放平台,5 分钟让 Claude、ChatGPT 或 Cursor 读到抖音热榜、视频详情、评论和博主作品。本文给出接入步骤、可以直接复制的提问方式、每一步用到的工具和真实价格。
- 实操教程 · 中文免费:让 Claude 查链上 TVL、协议收入、稳定币和收益率(附真实调用)用 ToolSocket 的免费 DefiLlama 工具,让 Claude、ChatGPT 或 Cursor 直接回答「哪条链 TVL 最高」「哪些协议最赚钱」「USDC 哪里收益最高」。本文 4 个步骤全部是真实调用,附输入、耗时和返回结果,不花一分钱。