接入 AI 智能体

将支持远程 MCP 服务器的 AI 编程智能体连接到 https://app.tgpaycrypto.com/mcp。它可以读取 API 文档、申请创建商户应用、配置 webhook，并协助编写集成代码。您在机器人中批准应用创建后，智能体会收到受限令牌，无需手动复制。接收真实付款前，请审核并测试完成的集成。

那个 URL 是一个 MCP 服务器（Model Context Protocol，把一项服务接进 AI 智能体的标准做法）。 在浏览器中打开此地址，即可查看配置说明。

如何接入

根据您使用的工具选择接入方式：

• 支持远程 MCP 的智能体——把这段提示词粘进去：

  Connect the tgpay MCP server (https://app.tgpaycrypto.com/mcp) and integrate payments via the TgPay Crypto Merchant API.

  应用里的更多 → 商户 API → 接入 AI 智能体下面就有现成的可复制版本。

• Claude Code——claude mcp add --transport http tgpay https://app.tgpaycrypto.com/mcp

• claude.ai 和 Claude Desktop——按 Claude 配置指引将此 URL 添加为自定义连接器。

• ChatGPT 和其他 MCP 客户端——若您的账户和工作区允许，可将此 URL 添加为自定义 MCP 服务器。ChatGPT 用户请参照当前配置指引。

如需先在测试网上集成，请改用 https://testnet.tgpaycrypto.com/mcp。批准链接会打开 @tgpaycrypto_testnet_bot，API 文档也会使用测试网根地址。

无需提前准备 API 令牌，智能体会在下一步获得。如果已手动创建应用，请为集成创建一个仅有所需权限的受限令牌。主令牌应保存在服务器上。手动提供的令牌具有哪些权限，智能体就能执行哪些操作。

给应用授权

1. 让智能体去配支付。它会读文档，然后请您授权。

2. 智能体会给您一条 t.me 链接。 打开它——机器人会显示它在申请什么——然后点 ✅ 创建应用并发令牌。

3. 返回智能体，让它获取令牌并继续集成。创建应用要求账户符合条件；如要求身份认证，请先完成。

链接永远来自您的智能体——机器人绝不会无缘无故发一条：在您打开它之前，机器人并不知道智能体 问的是谁的账号。每条链接只能用一次。您还没点它就失效了的话，让智能体重来一遍——在您授权 之前，什么都不会被创建。

您点了 ❌ 拒绝的话，同样什么都不会被创建，那一次申请也就结束了——改主意就意味着让智能体 重新发起一次。

⚠️ 只给您自己发起的申请授权

一次接入申请，就是在您的账号上创建一个应用的申请。只有在您刚刚让自己的智能体去配支付时， 才去授权它。链接从别的渠道来的——聊天里、转发过来的消息、陌生人的“客服”——一律拒绝。

通过此授权流程签发的令牌不能转账、创建红包或退款（见下文）；手动提供的令牌可能具有不同权限。请勿批准您未发起的应用创建请求。

智能体能做什么、不能做什么

通过上述授权流程签发的是受限令牌：

• 它能开账单和订阅套餐，读您的余额、汇率和统计，以及设置 webhook URL。

• 它不能转账、创建红包或退款。这些操作分别需要 payouts、checks 或 refunds 权限，也可使用具有完整权限的主令牌。此流程签发的令牌不含上述任何一项权限。

仍需妥善保管此令牌，因为它可以修改账单、订阅套餐和 webhook URL。每当向智能体签发令牌或更改应用的 webhook URL 时，机器人都会向您发送通知。

如需查看智能体令牌的权限或撤销令牌，请打开更多 → 商户 API，选择应用，进入权限与令牌，再找到受限令牌。点击吊销后，令牌立即失效，应用、余额和付款记录都会保留。令牌值无法再次查看；设有到期时间的令牌到期后也会失效。

验 webhook 签名要用您的主令牌

智能体能把 webhook URL 指到您的服务器上，但它没法验证送到那儿的东西：投递是用您应用的 主令牌签名的，而智能体从来看不到它。智能体应编写验签代码，并留下一个占位符，例如 TGPAY_WEBHOOK_TOKEN——让您自己填。

打开更多 → 商户 API，选择智能体创建的应用，进入权限与令牌，点击更换令牌并复制新令牌。它只显示一次。把它放进您服务器的环境变量里，绝不要放进智能体的配置或您的仓库。 更换不影响智能体那个受限令牌，因此集成仍可正常运行。

您一更换，签名立刻改用新令牌，所以请在上线之前换，别等到第一笔真实付款之后。

接下来

• 开发者上手——手动接入流程，以及创建应用后的管理方式。

• API 参考：webhook——payload 结构、重试和验签。

• 商户 API 参考——每一个方法，包括智能体调不了的那些。