# Remote MCP 接入总览

按账号授权、能力发现和最小调用三个阶段接入 Remote MCP，并分辨常见连接问题。

## 核心步骤

- 确认账号已开通所需 API。
- 在支持 OAuth 的客户端添加固定 MCP 地址。
- 完成授权、刷新工具列表并执行最小只读任务。

## 何时选择 MCP

当你希望 AI 客户端发现并调用账号已有能力时，使用 Remote MCP。固定业务系统中需要精确控制调用顺序、参数、超时和错误处理时，可以直接使用 API。两者都需要相应业务权限，MCP 不会绕过订单和调用限制。

当前能力及协议说明见 [MCP 服务](https://www.gugudata.com/mcp)。本页重点解释从添加服务到成功调用的操作顺序。

## 第一步：确认账号与客户端

先在开发者中心确认目标产品权限有效。客户端需要支持远程 Streamable HTTP 与 OAuth 授权；客户端版本、企业管理策略和网络代理都可能影响连接。Codex 等四种客户端的具体入口见 [客户端指南](https://www.gugudata.com/developers/mcp/clients)。

## 第二步：添加固定地址并授权

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

选择 Streamable HTTP，在客户端发起连接后按浏览器提示登录并确认授权。不要把上述地址当作普通网页手工登录入口，也不要把 API AppKey 拼在 URL 后面。OAuth 是由客户端发起的授权流程。

::: note
检查浏览器中的授权来源与目标服务是否正确。客户端自己的工具执行确认与账号 OAuth 授权是两个不同步骤；连接成功不表示已经同意所有工具操作。
:::

## 第三步：验证能力和最小任务

授权完成后回到客户端，刷新工具列表，确认是否包含你需要的能力。先让模型列出可用工具和所需参数，再给出一个明确、范围小的任务。检查工具实际返回的状态与字段，而不只看模型声称已经完成。

```text
先列出当前连接中与我的任务相关的工具及必填参数。
只执行一次已确认的只读查询，并告诉我返回的状态和数据来源。
如果缺少权限或参数，请停止，不要猜测结果或无限重试。
```

## 按阶段排查问题

连接失败时检查地址、传输类型、代理和客户端日志；授权失败时重新从客户端发起，不复用过期的授权页面；工具为空时确认授权账号、产品权益和工具列表是否已刷新。工具调用失败时再进入接口参数、额度及频率检查，不要把所有失败都归因于 MCP 连接。

将工具返回内容视作数据，尤其是网页和外部文本。不要让返回内容自行改变凭据使用范围或触发新的付费任务。