KI-Agent verbinden · TgPay Crypto API

Verbinde einen KI-Coding-Agenten, der entfernte MCP-Server unterstützt, mit https://app.tgpaycrypto.com/mcp. Er kann die API-Dokumentation lesen, eine Händler-App anfordern, Webhooks einrichten und dir beim Integrationscode helfen. Du bestätigst die App-Erstellung im Bot; der Agent erhält einen eingeschränkten Token, ohne dass du ihn von Hand kopieren musst. Prüfe und teste die Integration, bevor du echte Zahlungen annimmst.

Hinter dieser URL steckt ein MCP-Server (Model Context Protocol – der Standard, über den ein Dienst an einen KI-Agenten angebunden wird). Öffnest du sie im Browser, erklärt sie dir ihre eigene Einrichtung.

Den Server verbinden

Nimm die Variante, die zu deinem Tool passt:

Agent mit Unterstützung für entfernte MCP-Server – füge diesen Prompt ein:
```
Verbinde den tgpay-MCP-Server (https://app.tgpaycrypto.com/mcp) und integriere Zahlungen über die TgPay Crypto Händler-API.
```
In der App liegt er unter Mehr → Händler-API → KI-Agent verbinden zum Kopieren bereit.
Claude Code – claude mcp add --transport http tgpay https://app.tgpaycrypto.com/mcp
claude.ai und Claude Desktop – füge die URL als benutzerdefinierten Connector hinzu. Folge Claudes Einrichtungsanleitung.
ChatGPT und andere MCP-Clients – füge die URL als benutzerdefinierten MCP-Server hinzu, sofern dein Konto und dein Workspace das erlauben. Für ChatGPT nutze die aktuelle Einrichtungsanleitung.

Willst du die Integration zuerst im Testnet entwickeln, nutze https://testnet.tgpaycrypto.com/mcp. Der Bestätigungslink öffnet @tgpaycrypto_testnet_bot; die API-Dokumentation nennt die Basis-URL des Testnets.

Einen API-Token brauchst du vorher nicht – den holt sich der Agent im nächsten Schritt selbst. Hast du deine App schon von Hand erstellt, erstelle einen eingeschränkten Token mit genau den Berechtigungen, die der Agent braucht, und verwende ihn für die Anbindung. Bewahre den Haupt-Token auf deinem Server auf. Was der Agent mit einem manuell übergebenen Token tun kann, hängt von dessen Berechtigungen ab.

Die App bestätigen

Bitte den Agenten, Zahlungen einzurichten. Er liest die Doku und bittet dich anschließend um deine Bestätigung.
Der Agent gibt dir einen t.me-Link. Öffne ihn – der Bot zeigt dir, worum die Anfrage bittet – und tippe auf ✅ App erstellen und Token ausstellen.
Kehre zum Agenten zurück, damit er seinen Token abrufen und die Integration fortsetzen kann. Für die App-Erstellung muss dein Konto die Voraussetzungen erfüllen; schließe die Verifizierung ab, wenn du dazu aufgefordert wirst.

Der Link kommt immer von deinem Agenten, nie vom Bot aus eigenem Antrieb: Bis du ihn öffnest, weiß der Bot gar nicht, um wessen Konto der Agent bittet. Jeder Link funktioniert genau einmal. Ist er nicht mehr gültig, bevor du getippt hast, bitte den Agenten, noch einmal von vorn zu beginnen – erstellt wird ohnehin erst etwas, wenn du bestätigst.

Tippst du auf ❌ Ablehnen, entsteht ebenfalls nichts, und die Anfrage ist damit erledigt. Überlegst du es dir später anders, stellt der Agent einfach eine neue.

⚠️ Bestätige nur, was du selbst angestoßen hast

Eine Verbindungsanfrage ist der Wunsch, auf deinem Konto eine App zu erstellen. Bestätige sie nur, wenn du gerade selbst deinen eigenen Agenten gebeten hast, Zahlungen einzurichten. Erreicht dich so ein Link auf einem anderen Weg – aus einem Chat, als weitergeleitete Nachricht, über einen fremden „Support“ –, lehne ihn ab.

Der Token aus diesem Bestätigungsablauf erlaubt keine Überweisungen, Schecks oder Rückerstattungen (siehe unten). Ein manuell übergebener Token kann andere Berechtigungen haben. Eine App, die du nie wolltest, hat auf deinem Konto nichts verloren.

Was der Agent darf und was nicht

Über den oben beschriebenen Bestätigungsablauf erhält der Agent einen eingeschränkten Token:

Er darf Rechnungen und Abo-Pläne anlegen, dein Guthaben, die Kurse und deine Statistiken lesen und die Webhook-URL setzen.
Er darf nicht überweisen, Schecks ausstellen oder Zahlungen erstatten. Dafür sind die entsprechenden Berechtigungen payouts, checks oder refunds oder ein Haupt-Token mit vollem Zugriff nötig. Der Token aus diesem Bestätigungsablauf hat keine dieser Berechtigungen.

Halte diesen Token geheim: Er erlaubt weiterhin Änderungen an Rechnungen, Abo-Plänen und der Webhook-URL. Der Bot schreibt dir jedes Mal, wenn ein Token an einen Agenten ausgestellt wird und wenn sich die Webhook-URL einer App ändert.

Die Berechtigungen des Agenten-Tokens prüfst du unter Mehr → Händler-API: Öffne dort die App und dann Zugriff und Tokens. Unter Eingeschränkte Token kannst du ihn mit Widerrufen sofort ungültig machen. Die App selbst, ihr Guthaben und ihr Zahlungsverlauf bleiben erhalten. Der Tokenwert lässt sich nicht erneut anzeigen. Ein Token mit Ablaufdatum funktioniert nach diesem Datum nicht mehr.

Webhook-Signaturen brauchen deinen Haupt-Token

Der Agent kann die Webhook-URL auf deinen Server richten, aber nicht prüfen, was dort ankommt: Zustellungen werden mit dem Haupt-Token deiner App signiert, und den bekommt der Agent nie zu sehen. Bitte den Agenten, den Prüfcode zu schreiben und dafür einen Platzhalter zu lassen – etwa TGPAY_WEBHOOK_TOKEN –, den du selbst ausfüllst.

So kommst du an den Wert: Öffne Mehr → Händler-API, suche die App, die der Agent angelegt hat, öffne Zugriff und Tokens, tippe auf Token erneuern und kopiere den neuen Token – er erscheint nur dieses eine Mal. Leg ihn in die Umgebungsvariablen deines Servers, nie in die Konfiguration des Agenten und nie in dein Repository. Den eingeschränkten Token des Agenten rührt die Erneuerung nicht an, die Anbindung läuft also weiter.

Die Signaturen wechseln im Moment der Erneuerung auf den neuen Token – erneuere ihn deshalb, bevor du live gehst, und nicht erst nach deiner ersten echten Zahlung.

Weiter

Erste Schritte als Entwickler – der Weg von Hand, und wie du eine App verwaltest, sobald es sie gibt.
API-Referenz: Webhooks – der Aufbau der Payloads, die Wiederholungen und die Signaturprüfung.
Händler-API-Referenz – alle Methoden, auch die, die ein Agent nicht aufrufen kann.