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. Über den MCP-Server kann der Agent nur Zahlungen entgegennehmen, unabhängig vom verwendeten Token (siehe unten).

Füge den MCP-Server in den Verbindungseinstellungen deines Clients mit dem Header TgPayCrypto-API-Token: <token> (oder Authorization: Bearer <token>) hinzu. So übergibst du den Token direkt; eine Bestätigung ist dann nicht nötig. Nicht jeder Client hat ein Feld für eigene Header (die Connectors von claude.ai und ChatGPT haben keins, und der Server bietet keine Anmeldung per OAuth); nutze dort die Bestätigung unten. Der Agent kann einen Token auch bei einem einzelnen Werkzeugaufruf als Argument api_token übergeben, sofern sein Client ein Argument senden lässt, das das Werkzeug nicht deklariert.

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.

Die App und der Token des Agenten entstehen, wenn der Agent die Anfrage nach deinem Tippen das nächste Mal prüft – meist innerhalb weniger Sekunden. Die Anfrage gilt 10 Minuten ab dem Moment, in dem der Agent sie stellt: Prüft er sie nicht rechtzeitig, wird nichts erstellt, obwohl der Bot dein Tippen schon bestätigt hat, und der Agent muss von vorn beginnen. Für die App-Erstellung muss dein Konto die Voraussetzungen erfüllen; ist eine Verifizierung nötig, erhält der Agent bei dieser Prüfung einen Fehler – schließe die Verifizierung ab und lass den Agenten innerhalb derselben 10 Minuten erneut prüfen oder neu beginnen.

Mit der Bestätigung akzeptierst du die Bedingungen der Händler-API für die App, die dabei entsteht – genauso wie beim Erstellen einer App in der Mini App.

Der Link kommt immer von deinem Agenten, nie vom Bot aus eigenem Antrieb: Bis du ihn öffnest, weiß der Bot gar nicht, auf wessen Konto sich die Anfrage des Agenten bezieht. Solange du noch auf keine Schaltfläche getippt hast, zeigt der Link beim erneuten Öffnen dieselbe Anfrage; nach ✅ App erstellen und Token ausstellen oder ❌ Ablehnen oder nach 10 Minuten funktioniert er nicht mehr. 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.

Über den MCP-Server erlaubt kein Token Überweisungen, Schecks oder Rückerstattungen – auch nicht der Token aus diesem Bestätigungsablauf (siehe unten). 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 anlegen und löschen, Abo-Pläne anlegen und archivieren, das Abo eines Abonnenten kündigen, dein Guthaben, die Kurse und deine Statistiken lesen sowie die Webhook-URL und den Namen der App ändern.
Er darf nicht überweisen, Schecks ausstellen oder Zahlungen erstatten: Der Token hat keine der Berechtigungen payouts, checks oder refunds.

Der MCP-Server begrenzt den Zugriff zusätzlich: Seine Werkzeuge zum Senden von Guthaben – transfer, transferBatch, createCheck und refundInvoice – sind derzeit deaktiviert. Der Agent sieht sie nicht, und jeder Aufruf wird abgelehnt, auch mit einem Haupt-Token mit vollem Zugriff. Weder ein geleakter Agenten-Token noch eine schädliche Anweisung in einem gelesenen Text, etwa im Kommentar eines Zahlers, kann so über MCP Guthaben aus deiner App versenden.

Über die API direkt sind Überweisungen, Schecks und Rückerstattungen weiterhin möglich: Dein Servercode ruft /pay/api mit einem Token auf, der die jeweils nötige Berechtigung payouts, checks oder refunds hat. Für Auszahlungen kannst du auch die App nutzen: Öffne Mehr → Händler-API, wähle deine App und dann Auszahlungen.

Halte diesen Token geheim: Er erlaubt weiterhin Änderungen an Rechnungen, Abo-Plänen, Abos, der Webhook-URL und dem Namen der App. 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 Erneuerung bestätigst du mit deiner PIN oder Face ID. Eine über den Agenten erstellte App kann zu einem Konto ohne PIN gehören. Zum Erneuern brauchst du jedoch eine aktive PIN: Richte sie zuerst unter Sicherheit ein und warte, bis sie aktiv ist.

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.