天聚数行（TianAPI）已逐步适配开放提供 MCP（Model Context Protocol） 支持，允许开发者在 AI 编程助手（如 GitHub Copilot、Cherry Studio 等）中直接调用平台内的各种 API接口，实现智能上下文感知的代码生成与数据查询。为帮助您在支持 MCP 的 AI 编程环境中快速接入我们的天气预报数据服务，本文将举例介绍如何在 Cherry Studio 和 GitHub Copilot 中完成MCP配置。
注册并登录天聚数行账号，进入控制台→ 数据管理→我的API 密钥，复制您的专属 PIKEY。
确认您已申请并启用某个支持MCP服务的接口，下文以「天气预报」举例。
在接口文档顶部有MCP标签的接口标识已完成适配，可以直接使用。
天聚数行提供的 MCP 服务采用动态 URL 模板，您需将 {APIKEY} 替换为您自己的密钥：
{
"mcpServers": {
"tianapi-tianqi": {
"url": "https://mcp.tianapi.com/tianqi/{APIKEY}"
}
}
}替换后：
"url": "https://mcp.tianapi.com/tianqi/abc123def456ghi789"
该端点已内置认证逻辑，无需额外设置 Bearer Token 或 Headers，只需在 URL 中包含有效 APIKEY 即可调用。
Cherry Studio 原生支持 MCP 服务注册。请按以下步骤操作：
1，打开设置
启动 Cherry Studio，点击左下角 ⚙️ Settings → 进入 AI Assistants → 选择 MCP Servers。
2，添加 MCP 服务
点击 + Add Server，填写如下信息：
Server Name: tianapi-tianqi（建议与配置键一致）
Server URL: https://mcp.tianapi.com/tianqi/您的APIKEY
请确保将 您的APIKEY 替换为实际密钥，例如：https://mcp.tianapi.com/tianqi/abcd1234efgh5678
3，保存并启用
点击 Save，Cherry Studio 将自动加载服务元数据。
随后，您可在聊天或代码辅助中直接使用自然语言请求天气数据，例如：
“查询上海未来三天的天气情况”
系统将通过 MCP 自动调用天聚数行服务并返回结构化结果。
目前 GitHub Copilot 对第三方 MCP 服务的支持依赖于 IDE 插件生态（如 VS Code 的 Copilot Labs 或自定义 MCP 扩展）。若您使用的环境支持 MCP 配置，请按以下方式操作：
1，确认 IDE 支持 MCP
请确保您已安装支持 MCP 协议的扩展（例如：Copilot for CLI、MCP Client for VS Code 等）。
2，配置 MCP 服务
在插件设置中添加如下配置项（以 JSON 格式为例）：
{
"mcpServers": {
"tianapi-tianqi": {
"url": "https://mcp.tianapi.com/tianqi/您的APIKEY"
}
}
}3，使用服务
配置生效后，在 Copilot 聊天窗口或代码注释中输入：
获取上海当前温度和天气状况
Copilot 将通过天聚数行 MCP 服务获取实时数据，并生成适合人类阅读的回答。
Q1：调用返回 “Invalid APIKEY” 或 403 错误？
请检查：
APIKEY 是否正确复制（无多余空格）；
是否已在天聚数行控制台 开通天气预报接口（ID: 72）；
接口已停用或调用次数超限（控制台 - 数据管理）。
Q2：是否支持 HTTPS 和高并发？
是的，mcp.tianapi.com 全站启用 HTTPS，服务部署于高可用集群，可稳定支持生产级调用。
Q3：MCP 调用是否计费？
每次 MCP 请求等同于一次标准 API 调用，按接口自身的计费规则扣减次数或消耗天豆。MCP服务本身，目前免费。
