DataGate MCP

DataGate + AI - 适用于 Claude、ChatGPT、Codex、Cursor，以及任何支持 MCP 的 Agent

非官方。由社区构建的 Claude Code Skill 和 MCP 服务，用于访问 DataGate 电信计费 API。与 DataGate 无关联，未获其认可或赞助。DataGate 是其各自所有者的商标。

将 DataGate 客户、协议和发票查询添加到你已在使用的 AI 中—— Claude Code、Claude Desktop、ChatGPT（Plus/Pro+，此连接器重新发布前暂停；请参阅 mcp-install.md）、Codex、Cursor、 Windsurf、Cline、Continue、Gemini 或 GitHub Copilot。免费、开源， 可在笔记本电脑上运行。本地 SQLite 镜像意味着重复查询无需手动翻查实时 API，也不会 占用 DataGate 的每账户速率限制。专为通过 DataGate 计费的 MSP 和电信经销商打造。无需编写代码。

适用于你的 Agent

安全提示（此连接器重新发布前）。 请勿运行 HTTP 模式 （--transport http），即使是在 localhost 上也不行。此版本会检查令牌，但 早于修复版，尚未加入请求大小和时间限制。MCP 工具也可以使用你的凭据 执行更改。请使用默认的 stdio 传输方式。如果你为远程 Agent 设置了隧道，请将其 关闭。修复版即将推出。

你的 AI Agent	如何安装 DataGate Skill
Claude Desktop	运行安装程序，然后前往 Settings > Extensions 注册 datagate-mcp（无需编辑 JSON）。
ChatGPT（付费套餐）	此连接器重新发布前暂停：ChatGPT 需要使用其 HTTP 模式，而此版本的该模式会检查令牌，但尚无请求大小或时间限制。请参阅 mcp-install.md 中的安全提示。
Claude Code	粘贴下方的安装提示词。
Codex CLI	粘贴下方的安装提示词。

ChatGPT 需要远程 HTTPS 服务，这意味着要使用此连接器的 HTTP 模式。连接器重新发布前，该模式暂停使用：此版本的该模式会检查令牌，但尚无请求大小或时间限制。请参阅 mcp-install.md 中的安全提示。

还适用于 Cursor、Windsurf、Cline、Continue.dev、Zed、GitHub Copilot 和 Gemini CLI，也适用于任何支持 MCP 的 Agent，可通过 MCP 和预配置的 Skill frontmatter 使用。各工具的完整接入说明：docs/which-agent.md。

安装

macOS / Linux：

bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/datagate/install.sh)

Windows（PowerShell）：

iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/datagate/install.ps1 | iex

两个安装程序都会检测你的操作系统和架构，从此仓库的 Releases 下载 datagate-cli 和 datagate-mcp 二进制文件，将其写入 ~/.local/bin （macOS/Linux）或 %LOCALAPPDATA%\Programs\msp-skills\（Windows），清除 macOS Gatekeeper 隔离标记，并遵循 DRY_RUN=1 设置。

身份验证

export DATAGATE_API_KEY="<your Bearer token>"
export DATAGATE_CLIENT_ID="<your ClientId GUID>"
datagate-cli doctor

这两个值都来自你自己的 DataGate 账户——无需 OAuth 流程，没有令牌过期，也无需刷新。doctor 会确认两项值均已设置且 API 可访问。

为什么使用本地镜像而不是封装器

大多数精简的 DataGate 封装器都会将每个问题代理为实时 API 调用。查询一位客户时这没问题，但如果要检查大量客户名单或反复提取发票，调用次数就会累积——每次调用都会计入 DataGate 的速率限制（每账户每分钟 60 次、每天 5,000 次）。此 Skill 会将客户、协议和发票同步到带有全文搜索功能的本地 SQLite 镜像中，因此重复查询只需执行一次本地查询：即时完成、可离线使用，且不会产生额外的 API 调用。

涵盖内容

跨 DataGate 的资源组执行只读操作（列出、获取、搜索）：客户、客户用户、协议、服务项目、分配、费率卡、站点、产品模板、套件模板、发票、产品、交付方式、产品交易记录和客户经理。有关完整的读写明细，请参阅 governance.md；有关所有命令，请参阅 guide.md。

示例命令

datagate-cli customers list --json
datagate-cli agreements list --select id,customerId,name,status --json
datagate-cli invoices --period-start 2026-08-01T00:00:00Z --period-end 2026-08-31T23:59:59Z --json
datagate-cli sync
datagate-cli search "<customer name or invoice number>"

已知不足

此版本有意设为只读——DataGate 的 CRUD 功能已编写文档，但此连接器尚未实现创建、更新或删除。少数端点路径（站点、产品、产品模板、套件模板、交付方式、产品交易记录、客户经理）是根据 DataGate 自身的命名惯例推导得出的，并未逐一通过实际租户确认。如果你在自己的账户上运行时发现问题，请提交报告（参阅 CONTRIBUTING.md 第 2 步——附有实际租户证据的错误报告，比无法复现的报告更有价值）。

许可证

Apache-2.0。参阅 cli/LICENSE 和 cli/NOTICE。