Codex、Cursor、Claude Code 与 Cherry Studio 接入

用同一个 Remote MCP 地址配置四个客户端，完成 OAuth，并按连接阶段排查。

核心步骤

本文目录

四种客户端都使用 https://mcp.gugudata.com/mcp。开始前确认网络能访问服务、账号拥有所需 API 权限，以及当前客户端版本支持远程 HTTP 与 OAuth。无需在配置中填写 API AppKey。

本页配置依据客户端官方文档与 GuGuData 当前服务说明核对。客户端界面名称可能随版本变化，遇到不同菜单时优先搜索 MCP 设置，避免照抄旧版 SSE 配置。

先安装或更新 Codex CLI。在终端添加远程服务，使用 --url 指定 Streamable HTTP 地址：

codex mcp add gugudata --url https://mcp.gugudata.com/mcp

如果添加过程中尚未完成授权，执行下面的命令，按浏览器提示登录咕咕数据账号并确认授权：

codex mcp login gugudata

随后检查服务配置：

codex mcp list

配置通常保存在 ~/.codex/config.toml；若设置了 CODEX_HOME，以该目录为准。已有同名服务时先检查其地址，不要重复添加或覆盖其他 MCP 配置。无需填写 API AppKey，也不要将它误填为 MCP Bearer Token。

回到 Codex，重新打开会话后查看 MCP 工具，并执行一次范围明确的最小查询。codex mcp list 中出现服务只表示配置已保存；仍需确认 OAuth 已完成、工具能加载且实际调用返回预期结果。

如果提示找不到 codex 命令，先检查 CLI 安装与终端 PATH；授权失败时重新执行 codex mcp login gugudata。桌面应用或 IDE 中没有同步显示时，检查它们是否使用同一用户、运行主机与配置目录。

在项目级 .cursor/mcp.json 配置远程服务；若希望跨项目使用，可使用用户级 ~/.cursor/mcp.json 配置。不要同时在多个作用域重复添加同名服务。

{
  "mcpServers": {
    "gugudata": {
      "url": "https://mcp.gugudata.com/mcp"
    }
  }
}

保存后进入 MCP 设置，启用服务并完成弹出的浏览器授权。若文件已包含其他服务，只合并 gugudata 条目，不覆盖整个文件。工具列表出现后，再选择与你任务相关的工具执行最小查询。

在终端添加远程 HTTP 服务，然后在 Claude Code 会话中通过 /mcp 检查连接和完成授权。配置作用域沿用命令默认值；团队共享配置前应先了解官方文档中的作用域区别。

claude mcp add --transport http gugudata https://mcp.gugudata.com/mcp

/mcp

若同名服务已经存在，先查看已有配置，不重复创建。授权后检查工具状态；不要把交互式 /mcp 命令当作普通 shell 命令执行。

打开设置中的 MCP 服务器管理，添加服务器，名称填写 gugudata，类型选择 Streamable HTTP，URL 填写以下地址。保存并启用后，按照客户端提示完成 OAuth，再在需要的助手或会话中启用相关工具。

https://mcp.gugudata.com/mcp

不同 Cherry Studio 版本对传输类型、授权按钮和助手工具开关的命名可能不同。若仅提供旧 SSE 选项或无法启动 OAuth，请先更新客户端并检查官方说明，不将服务地址擅自改为 /sse。

确认授权账号正确、服务状态正常、工具列表已加载。若能发现工具但调用失败，继续检查业务权限、参数与调用频率。配置文件可分享，但不要分享 OAuth 令牌、授权 Cookie 或含个人信息的日志。更多排查见 MCP 总览。