# Codex、Cursor、Claude Code 与 Cherry Studio 接入

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

## 核心步骤

- 更新到支持远程 HTTP 与 OAuth 的客户端版本。
- 配置 https://mcp.gugudata.com/mcp 并完成浏览器授权。
- 刷新工具列表，验证所需能力与账号权限。

## 共同前提

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

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

## Codex

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

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

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

```bash
codex mcp login gugudata
```

随后检查服务配置：

```bash
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 中没有同步显示时，检查它们是否使用同一用户、运行主机与配置目录。

参考：[Codex MCP 官方文档](https://developers.openai.com/codex/mcp/)。

## Cursor

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

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

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

参考：[Cursor MCP 官方文档](https://cursor.com/docs/mcp)。

## Claude Code

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

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

```text
/mcp
```

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

参考：[Claude Code MCP 官方文档](https://code.claude.com/docs/zh-CN/mcp)。

## Cherry Studio

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

```text
https://mcp.gugudata.com/mcp
```

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

参考：[Cherry Studio 项目与文档入口](https://github.com/CherryHQ/cherry-studio)。

## 四种客户端的共同验收

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