Conectar um agente de IA · TgPay Crypto API

Conecte um agente de programação com IA que aceite servidores MCP remotos a https://app.tgpaycrypto.com/mcp. Ele pode ler a documentação da API, solicitar a criação de um app de comerciante, configurar webhooks e ajudar a escrever a integração. Você aprova a criação do app no bot, e o agente recebe um token restrito sem que você precise copiá-lo manualmente. Revise e teste a integração antes de aceitar pagamentos reais.

Essa URL é de um servidor MCP (Model Context Protocol — a forma padrão de conectar um serviço a um agente de IA). Abra o endereço no navegador para ver as instruções de configuração.

Como conectar

Use a linha que corresponde à sua ferramenta:

Um agente com suporte a MCP remoto — cole este prompt:
```
Connect the tgpay MCP server (https://app.tgpaycrypto.com/mcp) and integrate payments via the TgPay Crypto Merchant API.
```
Você também pode copiar um prompt de configuração em Mais → API para comerciantes → Conectar um agente de IA.
Claude Code — claude mcp add --transport http tgpay https://app.tgpaycrypto.com/mcp
claude.ai e Claude Desktop — adicione a URL como um conector personalizado seguindo as instruções de configuração do Claude.
ChatGPT e outros clientes MCP — adicione a URL como um servidor MCP personalizado se sua conta e seu espaço de trabalho permitirem. No ChatGPT, siga as instruções atuais de configuração.

Para montar a integração primeiro na testnet, use https://testnet.tgpaycrypto.com/mcp. O link de aprovação abre o @tgpaycrypto_testnet_bot, e a documentação da API usa a URL base da testnet.

Você não precisa criar um token de API antes: o agente recebe o dele na etapa seguinte. Se você já criou um app manualmente, crie um token restrito apenas com as permissões de que o agente precisa e use esse token na integração. Guarde o token principal no seu servidor. As permissões do token fornecido manualmente determinam o que o agente pode fazer.

Aprove o app

Peça ao agente para configurar os pagamentos. Ele lê a documentação e pede sua aprovação.
O agente te manda um link t.me. Abra o link — o bot mostra o que está sendo pedido — e toque em ✅ Criar app e emitir token.
Volte para o agente para que ele obtenha o token e continue a integração. A criação do app exige uma conta elegível; conclua a verificação se ela for solicitada.

O link sempre vem do seu agente, nunca do bot por conta própria: enquanto você não abre o link, o bot não sabe de qual conta o agente está falando. Cada link funciona uma vez só. Se ele parar de funcionar antes de você tocar, peça ao agente para começar de novo — nada é criado até você aprovar.

Se você tocar em ❌ Rejeitar, também não é criado nada, e aquele pedido acaba ali: mudar de ideia significa um pedido novo, feito pelo agente.

⚠️ Aprove só um pedido que partiu de você

Um pedido de conexão é um pedido para criar um app na sua conta. Aprove só se você acabou de pedir ao seu próprio agente para configurar pagamentos. Se um link chegar por qualquer outro caminho — uma conversa, uma mensagem encaminhada, um “suporte” que você não procurou —, rejeite.

O token emitido por esse fluxo de aprovação não permite enviar transferências, criar cheques nem reembolsar pagamentos (veja abaixo). Um token fornecido manualmente pode ter outras permissões. Um app que você não pediu não tem por que existir na sua conta.

O que o agente pode e não pode fazer

O token emitido pelo fluxo de aprovação acima é um token restrito:

Ele pode criar faturas e planos de assinatura, consultar seu saldo, as cotações e as estatísticas, e definir a URL de webhook.
Ele não pode enviar transferências, emitir cheques nem reembolsar pagamentos. Essas operações exigem o escopo correspondente — payouts, checks ou refunds — ou um token principal com acesso total. O token emitido por esse fluxo não tem nenhum desses escopos.

Mantenha esse token em segredo: as permissões dele ainda permitem alterar faturas, planos de assinatura e a URL de webhook. O bot avisa sempre que um token é emitido para um agente e quando a URL de webhook de um app muda.

Para consultar as permissões ou revogar o token do agente, abra Mais → API para comerciantes, encontre o app, abra Acesso e tokens e consulte Tokens restritos — Revogar desativa o token na hora. O app, o saldo e o histórico de pagamentos continuam disponíveis. O valor do token não pode ser consultado novamente. Um token com data de expiração também deixa de funcionar quando expira.

A assinatura do webhook precisa do seu token principal

O agente consegue apontar a URL de webhook para o seu servidor, mas não consegue verificar o que chega lá: as entregas são assinadas com o token principal do seu app, que o agente nunca vê. Peça ao agente para escrever o código de verificação e deixar um campo para você preencher, como TGPAY_WEBHOOK_TOKEN.

Para preencher: abra Mais → API para comerciantes, encontre o app que o agente criou, abra Acesso e tokens, toque em Rotacionar token e copie o que aparecer — ele é mostrado uma vez só. Guarde no ambiente do seu servidor, nunca na configuração do agente nem no seu repositório. A rotação não mexe no token restrito do agente, então a integração continua rodando.

As assinaturas passam a usar o token novo no instante em que você rotaciona, então rotacione antes de entrar no ar, e não depois do primeiro pagamento de verdade.

A seguir

Primeiros passos para desenvolvedores — o caminho manual, e como gerenciar um app depois que ele existe.
Referência da API: webhooks — formatos de payload, novas tentativas e a checagem de assinatura.
Referência da API para comerciantes — todos os métodos, inclusive os que um agente não pode chamar.