T-Bank Business zu MCP: Konten, Kontoauszüge und Acquiring in jedem KI-Agent

Nur selbst gehostet. Die T-API von T-Bank weist sich mit einem TLS-Zertifikat der Russian Trusted Root CA aus, der AnythingMCP Cloud nicht vertraut. Deshalb gibt es diesen Connector nicht in AnythingMCP Cloud. Er funktioniert mit einer AnythingMCP-Instanz, die du selbst betreibst, sobald dieses Stammzertifikat in ihrem Trust Store liegt, wie unten beschrieben.

T-Bank Business

T-Bank Business (T-API, früher Tinkoff Business): Firmendaten, Konten und Salden, Kontoauszüge mit Gegenparteien, Zahlungsbestätigungen, Status ausgestellter Rechnungen sowie Acquiring-Terminals und Kartenumsätze. Nur lesend.

Einrichtung

Die Einrichtung dauert etwa 10 Minuten. Du brauchst ein Firmenkonto bei T-Bank Business und ein selbst gehostetes AnythingMCP, das der Russian Trusted Root CA vertraut (siehe Zertifikate unten).

1. Öffne in T-Business (business.tbank.ru) Integrations > T-API und klick auf Issue token.
2. Trag die IP-Adressen ein, von denen die Aufrufe kommen, oder wähle als kleines oder mittleres Unternehmen Disable address check. Die Aufrufe kommen von der Adresse deines AnythingMCP-Servers, also erlaube diese Adresse oder schalte die Prüfung ab.
3. Hake unter What the API may access mindestens Firmeninformationen (T-Business ID), Kontoinformationen (bank-accounts/get) und Kontobewegungen (Auszüge) an; nimm Acquiring-Terminals, Rechnungen und Webhooks dazu, wenn du diese Tools willst. Du kannst den Token auf bestimmte Konten beschränken.
4. Kopiere den Token in TBANK_API_TOKEN. Er gilt 90 Tage ab der letzten Nutzung, ein regelmäßig genutzter Token läuft also nicht ab. Um Adressen oder Zugriffe zu ändern, stellst du einen neuen Token aus.
5. Setze TBANK_API_URL auf https://business.tbank.ru/openapi. Für die Sandbox nimmst du https://business.tbank.ru/openapi/sandbox mit dem Token TBankSandboxToken; ihre Antworten hängen nicht von deinen Daten ab.
6. Installiere den Connector und rufe tbank_get_company auf, um den Token zu prüfen.

Zertifikate: Die T-API weist sich mit einem TLS-Zertifikat des russischen Digitalministeriums aus (Russian Trusted Root CA); die alten öffentlichen Zertifikate wurden widerrufen. Ein Server, der dieser Wurzel nicht vertraut, scheitert mit einem Zertifikatsfehler, noch bevor ein HTTP-Status kommt. Füge das Stammzertifikat (von gosuslugi.ru/crt) dem Node-Trust-Store deines AnythingMCP-Backends hinzu, zum Beispiel NODE_EXTRA_CA_CERTS=/path/russian_trusted_root_ca.pem, und starte es neu.

Was er liest: die Firma hinter dem Token (voller und kurzer Name, INN, KPP, OGRN, Rechtsform, Steuerregime, Geschäftsadresse, Registrierungsdatum und Bankverbindung); die Firmenkonten mit Status, Typ, Währung, Tarif und Salden; Kontoauszüge ab Juni 2023 mit Betrag, Richtung, Kategorie, Verwendungszweck und Gegenpartei (Name, INN, KPP, Konto, BIC der Bank) jeder Buchung; die Bankbestätigung einer ausgeführten Buchung als PDF; den Status von Rechnungen, die über die T-API ausgestellt wurden; die Acquiring-Terminals und ihre Kartenumsätze; und die eingerichteten Webhooks.

So arbeitet die KI damit: Salden kommen aus tbank_list_accounts, wobei balance.otb das ist, was jetzt verfügbar ist. Für einen Auszug ruft sie tbank_get_statement mit account_number und from (und to) auf und blättert mit cursor = nextCursor, bis es fehlt; typeOfOperation Credit ist Geldeingang, Debit Geldausgang, und counterparty_inns filtert nach Gegenpartei. Als Nachweis einer Zahlung holt sie tbank_get_payment_document mit operationId und operationDate aus dem Auszug, und nur, wenn du das Dokument willst, denn das PDF ist groß. Fürs Karten-Acquiring listet sie die Terminals mit tbank_list_terminals und ruft dann tbank_list_terminal_operations pro Terminal und Tag auf.

Nur lesend: Alle 8 Tools lesen nur. Es werden keine Zahlungen angelegt oder signiert, deshalb gibt es nichts zu bestätigen, und kein Tool ist bei der Installation ausgeschaltet.

Datum und Beträge: Zeitangaben in Parametern und Antworten sind ISO 8601 in UTC; Buchungen am Wochenende werden am nächsten Werktag gebucht. Beträge stehen in der Kontowährung (Rubel mit Kopeken als Nachkommastellen), außer Acquiring-Umsätzen, die in Kopeken kommen.

Limits: Auszüge 20 Aufrufe pro Sekunde, Konten und Firma 6, Zahlungsdokumente und Acquiring 1 pro Sekunde. Auszüge beginnen im Juni 2023.

Häufige Fehler: 401 heißt, dass der Token falsch oder abgelaufen ist oder der Aufruf von einer Adresse kommt, die der Token nicht erlaubt. 403 heißt, dass dem Token der Zugriff für diese Methode fehlt (stell einen neuen Token mit diesem Häkchen aus) oder das Konto für diesen Token nicht freigegeben ist. 422 nennt einen ungültigen Parameter, etwa eine Kontonummer, die nicht 20 Stellen hat. Jeder Fehler hat eine errorId, die du dem T-Bank-Support nennen kannst.

Der Connector führt keine Zahlungen, Gehaltslisten oder Auszahlungen an Selbstständige aus und deckt weder die Kartenmethoden hinter mTLS (secured-openapi) noch die Partner-Integration (OAuth) ab.

Fragt vor jeder Änderung: TBANK_API_URL, TBANK_API_TOKEN

Connector lokal installieren

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

1. Öffne http://localhost:3000 und registriere dich. Das erste Konto wird Admin.
2. Öffne den Connector-Store (http://localhost:3000/connectors/store), wähle T-Bank Business, trag die abgefragten Zugangsdaten ein (manche Connectors brauchen keine) und installiere ihn.
3. Leg unter MCP Servers einen Server an und weise ihm den T-Bank Business-Connector zu. Kopiere auf der Seite des Servers den MCP endpoint (http://localhost:4000/mcp/<server-id>) und erzeuge unter API keys einen Schlüssel.

Der Quickstart lauscht nur auf localhost. Für eine Instanz, die andere Personen oder KI-Clients in der Cloud erreichen, klonst du das Repository und startest ./setup.sh. Das Skript richtet Domain, HTTPS und OAuth ein (Deployment-Anleitung).

Verfügbare Tools

Beispiel-Prompts

• „Wie hoch sind gerade die Salden aller unserer T-Bank-Konten, und wie viel ist heute verfügbar?“
• „Zeig mir die Geldeingänge der letzten Woche auf unserem Hauptkonto mit Gegenpartei und Verwendungszweck.“
• „Wie viel haben wir in diesem Quartal an die Gegenpartei mit der INN 7707083893 gezahlt?“
• „Hol mir die Bankbestätigung der größten ausgehenden Zahlung von gestern als PDF.“
• „Wie viel haben unsere Acquiring-Terminals gestern mit Kartenzahlungen eingenommen?“

Nächste Schritte

• Mit Claude verbinden
• Mit ChatGPT verbinden