天聚数行 MCP 服务配置指南

栏目分类:帮助教程 发布时间:2025-11-07 阅读次数:857

天聚数行(TianAPI)已逐步适配开放提供 MCP(Model Context Protocol) 支持,我们将复杂的 API 调用过程封装为语义清晰、参数规范的“工具函数”,使大语言模型(LLM)驱动的智能体能够在推理过程中安全、可靠地调用服务。开发者或普通用户无需编程即可轻松实现在支持MCP协议的AI 客户端(如 GitHub Copilot、Cherry Studio 等)中直接调用 API接口,实现智能上下文感知数据查询。为帮助您在支持 MCP 的 AI 环境中快速接入我们的数据服务,本文将举例介绍如何在 Cherry Studio 和 GitHub Copilot 中完成MCP配置。


 前提准备

注册并登录天聚数行账号,进入控制台→ 数据管理→我的API 密钥,复制您的专属 PIKEY。

确认您已申请并启用某个支持MCP服务的接口,下文以「天气预报」举例。


 哪些接口支持MCP服务?

在接口文档顶部有标有MCP的接口已完成开放适配,可以直接使用。提示:新闻类接口请统一使用“分类新闻”这个接口的MCP服务。

(推荐)在控制台 - 数据管理 - MCP服务中添加工具集合,随时可以把多个接口注册到同一个MCP地址中,方便AI自动发现和协同。

   天气预报API接口


MCP 服务配置信息

天聚数行提供的 MCP 服务采用动态 URL 模板,xxx为工具名(例如tianqi),您需将 {APIKEY} 替换为您自己的密钥:

{
  "mcpServers": {
      "tianapi-xxx": {
            "url": "https://mcp.tianapi.com/xxx/{APIKEY}"    
              }  
         }
}


该端点已内置认证逻辑,无需额外设置 Bearer Token 或 Headers,只需在 URL 中包含有效 APIKEY 即可调用。


 在 Cherry Studio 中配置

Cherry Studio 原生支持 MCP 服务注册。请按以下步骤操作:


 1,打开设置

启动 Cherry Studio,点击左下角 ⚙️ Settings → 进入 AI Assistants → 选择 MCP Servers。

 在 Cherry Studio 中配置

 

2,添加 MCP 服务

点击 + Add Server,填写如下信息:

Server Name: tianapi-tianqi(建议与配置键一致)

Server URL: https://mcp.tianapi.com/tianqi/您的APIKEY

(提示:请确保将 您的APIKEY 替换为实际密钥,例如:https://mcp.tianapi.com/tianqi/abcde12345678)


 3,保存并启用

点击 Save,Cherry Studio 将自动加载服务元数据。

Cherry Studio 将自动加载服务元数据


随后,您可在聊天或代码辅助中直接使用自然语言请求天气数据,例如:

“查询上海未来三天的天气情况”

系统将通过 MCP 自动调用天聚数行服务并返回结构化结果。


_20251107190306_5_1007.png


在 GitHub Copilot 中配置

目前 GitHub Copilot 对第三方 MCP 服务的支持依赖于 IDE 插件生态(如 VS Code 的 Copilot Labs 或自定义 MCP 扩展)。若您使用的环境支持 MCP 配置,请按以下方式操作:


在 GitHub Copilot 中配置


1,确认 IDE 支持 MCP

请确保您已安装支持 MCP 协议的扩展(例如:Copilot for CLI、MCP Client for VS Code 等)。


2,配置 MCP 服务

在插件设置中添加如下配置项(以 天气查询“tianqi ”为例):

{  
     "mcpServers": {    
            "tianapi-tianqi": {      
                     "url": "https://mcp.tianapi.com/tianqi/您的APIKEY"    
                     }  
                 }
}


3,使用服务

配置生效后,在 Copilot 聊天窗口或代码注释中输入:获取上海当前温度和天气状况

Copilot 将通过天聚数行 MCP 服务获取实时数据,并生成适合人类阅读的回答。


4,注意事项

请务必保管好接口密钥apikey,如果泄漏请控制台 - 数据管理 - 重置KEY。

按照最小权限规则,不用的接口请及时在控制台 - 数据管理中关闭。

AI工具在回答普遍问题时,可能会选择性调用接口数据,请及时关注接口计费情况。

MCP服务是代理模式调用的,因此接口请求来源是内部IP无法溯源,因此请严格保管接口密钥。

请注意:请不要把配置信息或者配置信息中的URL字段复制发送给第三方,否则会泄漏接口密钥。


5,常见问题解答

Q1:调用返回 “Invalid APIKEY” 或 403 错误?

请检查:

APIKEY 是否正确复制(无多余空格);

是否已在天聚数行控制台 开通天气预报接口(ID: 72);

接口已停用或调用次数超限(控制台 - 数据管理)。


Q2:是否支持 HTTPS 和高并发?

是的,mcp.tianapi.com 全站启用 HTTPS,服务部署于高可用集群,可稳定支持生产级调用。


Q3:MCP 调用是否计费?

MCP服务本身免费,但每次 MCP 请求等同于一次标准 API 调用,按接口自身的计费规则扣减次数或消耗天豆。



其他推荐OTHER API 更多>

开通会员专享福利
工单 客服