tgpay cryptoAPI
在 Telegram 上咨询
crypto-paymcpaiagent

接入 AI 智能体

阅读约 1 分钟最后更新： 2026年11月2日

将支持远程 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 令牌，智能体会在下一步获得。如果已手动创建应用，请为集成创建一个仅有所需权限的受限令牌。 主令牌应保存在服务器上。无论使用哪种令牌，智能体通过 MCP 服务器都只能收款（见下文）。

要将此令牌提供给 MCP 服务器，请在客户端连接设置中添加服务器，并设置请求头 TgPayCrypto-API-Token: <token> 或 Authorization: Bearer <token>。这样就无需执行批准步骤。并非所有客户端都能填写自定义请求头（claude.ai 和 ChatGPT 的连接器没有这个选项，服务器也不支持 OAuth 登录）；在这类客户端中，请使用下文的批准流程。智能体也可以在单次工具调用中通过 api_token 参数传入令牌，前提是其客户端允许发送工具未声明的参数。

给应用授权

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

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

  3. 返回智能体，让它获取令牌并继续集成。

应用和智能体的令牌会在您点按后、智能体再次查询该请求时创建，通常只需几秒。请求自智能体创建起 10 分钟内有效：如果智能体没有及时查询，即使机器人已经确认了您的操作，也不会创建任何内容，智能体需要重新开始。创建应用要求账户符合条件；如需身份认证，智能体会在那次查询时收到错误——请完成认证，并让智能体在同样的 10 分钟内再次查询，或重新开始。

批准请求即表示您接受适用于所创建应用的商户 API 条款，与在 Mini App 中自行创建应用时相同。

链接永远来自您的智能体——机器人绝不会无缘无故发一条：在您打开它之前，机器人并不知道智能体 问的是谁的账号。在您点任何按钮之前，再次打开链接会显示同一个请求；点按 ✅ 创建应用并发令牌 或 ❌ 拒绝 后，或 10 分钟过后，链接即失效。您还没点它就失效了的话，让智能体重来一遍——在您授权 之前，什么都不会被创建。

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

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

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

通过 MCP 服务器，任何令牌都不能转账、创建红包或退款，包括通过此授权流程签发的令牌（见下文）。 请勿批准您未发起的应用创建请求。

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

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

  • 它能开具和删除账单、创建和归档订阅套餐、取消订阅者的订阅，读您的余额、汇率和统计，以及修改 webhook URL 和应用名称。

  • 它不能转账、创建红包或退款，因为此令牌不含 payouts、checks 或 refunds 权限。

MCP 服务器本身还有一道限制：用于从应用余额支出资金的工具 transfer、transferBatch、createCheck 和 refundInvoice 目前均已停用。 智能体看不到这些工具，调用也会被拒绝，即使使用具有完整权限的主令牌也不例外。 因此，无论是智能体令牌泄露，还是智能体读到的内容中藏有恶意指令，例如付款人的备注，都无法通过 MCP 将资金转出应用。

转账、创建红包和退款仍可直接通过 API 操作：在服务器代码中调用 /pay/api，并使用具有相应 payouts、checks 或 refunds 权限的令牌。 如需在应用中付款，请打开更多 → 商户 API，选择应用，再进入批量付款。

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

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

验 webhook 签名要用您的主令牌

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

打开更多 → 商户 API，选择智能体创建的应用，进入权限与令牌，点击更换令牌并复制新令牌。它只显示一次。把它放进您服务器的环境变量里，绝不要放进智能体的配置或您的仓库。 更换不影响智能体那个受限令牌，因此集成仍可正常运行。 更换令牌需要通过 PIN 码或 Face ID 确认。智能体创建的应用可能属于尚未设置 PIN 码的账户，但更换令牌需要已生效的 PIN 码。请先在安全中设置，并等待生效。

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

接下来

相关文章

商户 API（开发者）开发者上手商户 API（开发者）商户 API 是什么？商户 API（开发者）API 参考：webhook