让 AI Agent 安全调用咕咕数据 API

通过一个 Remote MCP 地址完成能力发现、OAuth 授权和账号权限同步。

兼容 MCP 2026-07-28 与现有客户端;原有 HTTP API 调用方式继续保留。

首次配置或授权遇到问题?阅读 MCP 客户端接入指南

业务技能 Skills业务目标与操作步骤
连接与授权 MCP发现能力与账号权限
数据执行 API请求契约与结果返回

三步完成接入

确认账号权益,添加固定服务地址,再由客户端拉起浏览器完成 OAuth 授权。

01

确认接口权益

在开发者中心确认已购买接口。MCP 不额外收费,能力范围随当前账号的有效权益同步。

02

添加服务地址

在客户端中添加 https://mcp.gugudata.com/mcp,传输类型选择 Streamable HTTP。

03

登录并授权

客户端打开浏览器后,登录 GuGuData 开发者账号,核对授权范围并返回客户端。

客户端只看到当前账号可以使用的能力

Remote MCP 把账号已有的数据服务权益转换为 Agent 可发现、可理解、可调用的标准能力。

客户端获得

  • 按账号权限动态暴露的 tools
  • 可读取接口说明和结构的 resources
  • 辅助 API 选择与结果解释的 prompts
  • 顺序稳定并带私有缓存提示的能力列表
  • 同一接口继续支持原有 HTTP 请求

服务端负责

  • 统一 OAuth 授权,不在客户端配置中保存 AppKey
  • 已购买接口可见,未购买接口不暴露
  • 自动汇总账号下的有效服务权益
  • 协议版本协商与断线后的干净重连
  • 开放能力与接口状态页保持同步

按客户端选择接入方式

服务地址始终相同;配置文件、命令与界面字段由各客户端决定,不把单一 JSON 结构称为通用标准。

Remote MCP 服务地址

适用于支持 Remote MCP 与 Streamable HTTP 的客户端。

https://mcp.gugudata.com/mcp

配置示例最后核对:2026-08-17。客户端更新后,请同时以对应客户端文档为准。

当前支持、兼容范围与后续方向分开说明

协议版本是可验证的兼容信息,不作为长期业务价值的唯一表达。

状态能力说明
当前支持MCP 2026-07-28

server/discover、无状态请求、每请求能力协商和能力列表缓存提示。

当前支持OAuth 安全授权

受保护资源发现、Client ID Metadata Documents、PKCE、资源绑定令牌与授权方校验。

兼容保留现有初始化握手客户端

同一入口兼容基于 initialize 的旧版流程;具体能力仍取决于客户端版本。

兼容保留Dynamic Client Registration

仅为不支持 Client ID Metadata Documents 的客户端保留,不建议新客户端优先采用。

评估中Tasks、MCP Apps、Skills over MCP

适合长任务、交互式数据界面与 Skill 分发;完成实现和客户端兼容验证后再开放。

授权范围在浏览器中确认

登录页依赖客户端发起的 OAuth 请求。客户端发现授权服务后打开浏览器,用户核对范围,再返回客户端使用能力。

01

发现授权服务

客户端读取受保护资源与授权服务器元数据。

02

浏览器登录

浏览器打开 GuGuData 登录与授权页面。

03

核对账号范围

用户确认当前账号与需要开放的 MCP 服务范围。

04

返回客户端

客户端安全保存授权结果并开始发现可见能力。

安全边界

访问令牌只通过 Authorization 请求头发送,不写入 URL;服务端校验令牌受众、授权方与账号权益。

常见问题

咕咕数据支持哪些 MCP 协议版本?

支持 MCP 2026-07-28,包括 server/discover、无状态请求和能力列表缓存提示;同时兼容基于初始化握手的现有客户端。

接入 MCP 需要额外收费吗?

不需要。购买已开放接口后,可使用当前账号对应的 MCP 能力,原有 HTTP API 调用方式继续保留。

为什么客户端只显示部分接口?

客户端只展示当前账号已经开通、处于开放状态且能够通过 MCP 使用的接口能力。

MCP 调用时还要手动传 AppKey 吗?

不需要。客户端通过 OAuth 完成账号授权,服务端按账号有效权益提供可用能力。

配置为什么按客户端分别提供?

MCP 统一协议与传输,但客户端的配置文件、命令和界面字段并不属于协议本身,因此需要分别核对。

连接中断后会怎样?

客户端可以重新连接并再次发现能力。若调用在响应完成前中断,是否重试取决于操作是否安全且幂等。

把已经购买的数据能力接入 Agent

已有账号可直接查看订单与权限;还在选择接口,可先浏览接口目录与状态页。