Tezga eKasa über MCP mit Claude verbinden

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → Tezga eKasa klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein git clone, kein lokaler Server.

Tezga eKasa + Claude

Tezga eKasa, die Online-Fiskalkasse für serbische Unternehmen: Fiskaleinstellungen und Steuerkennzeichen, Status und Fiskaldaten ausgestellter Belege sowie Banktransaktionen. Belege ausstellen, stornieren oder erstatten und Kunden und Artikel schreiben sind enthalten, aber bei der Installation deaktiviert.

Voraussetzungen

Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:

TEZGA_API_KEY

Schritt 1 — Zugangsdaten holen

Die Einrichtung dauert etwa 3 Minuten. Du brauchst ein Tezga-Konto in einem Tarif mit API-Zugriff und einen API-Key.

1. Der API-Zugriff gehört zu den Tarifen Posao und Biznis (oder zur Enterprise-Stufe). In anderen Tarifen antwortet jeder Aufruf mit 402.
2. Öffne in Tezga Podešavanja > Integracije > API ključevi, gib einem Key einen Namen (z. B. AnythingMCP) und erstelle ihn. Er wird nur einmal angezeigt: Kopiere ihn in TEZGA_API_KEY. Keys beginnen mit tzg_, gefolgt von 48 Hex-Zeichen. Nutze für diesen Connector einen eigenen Key, damit du ihn allein pausieren oder löschen kannst; dort kannst du ihn auch an die IP-Adressen deines AnythingMCP-Servers binden.
3. Installiere den Connector und rufe tezga_get_account_setup auf, um den Key zu prüfen und die Umgebung zu sehen.

Der Key reist im Header X-Tezga-Api-Key. Keys wechseln alle 90 Tage: Tezga schickt an Tag 76 eine Erinnerung per E-Mail, und du trägst den neuen Key im Connector ein, bevor der alte abgeschaltet wird. Für die lesenden Tools reicht ein Nur-Lese-Key; Schreibaufrufe damit antworten mit 403.

Zuerst die Umgebung: Test- und Produktions-Keys sehen gleich aus, denn die Umgebung gehört zum Konto. tezga_get_account_setup liefert okruzenje: produkcija (echte Belege, an die Steuerverwaltung gemeldet), sandbox (die offizielle Testumgebung), simulacija (Demo, PFR-Nummern beginnen mit MOCK) oder nepovezano (kein Sicherheitselement, Fiskalisierung wird abgelehnt). Die KI sagt dir vor jedem Schreibvorgang, welche es ist.

Was er liest: die Fiskaleinstellungen des Kontos (die Umgebung, ob das Unternehmen im Mehrwertsteuersystem und fiskalisierungspflichtig ist, und die Steuerkennzeichen); ein Dokument (Beleg, Proforma, Erstattung) über seine Tezga-ID oder das Dokument zu einer deiner Bestellnummern (externalId), mit Nummer, Typ, Status (nacrt Entwurf, izdat ausgestellt, storniran storniert), Summe inklusive Mehrwertsteuer, Zahlungsart, Fiskaldaten (PFR-Nummer und -Zeit, Belegzähler, Prüf-URL; null, wenn nicht fiskalisiert) und dem öffentlichen PDF-Link javniPdfUrl, der sich ohne Anmeldung öffnet; und die aus Kontoauszügen importierten Banktransaktionen des Unternehmens, die neuesten zuerst (smer uplata für Eingänge, isplata für Ausgänge, since für einen Startzeitpunkt), um Zahlungen Rechnungen zuzuordnen.

Bei der Installation deaktiviert: tezga_issue_receipt (ein Fiskalbeleg oder eine Proforma, oder mit tok sef eine E-Rechnung an SEF; idempotent pro externalId, dieselbe Bestellnummer erzeugt also nie einen zweiten Beleg), tezga_refund_document (Storno oder Erstattung, ausgestellt als neues Dokument mit Bezug auf das Original), tezga_upsert_customers und tezga_upsert_products (Abgleich über PIB, E-Mail oder Name bzw. über die Artikelnummer; gelöscht wird nichts). Ein Fiskalbeleg lässt sich nicht rückgängig machen, nur erstatten, deshalb schaltet ein Administrator diese Tools bewusst ein. Auch dann zeigt dir die KI Positionen, Beträge und Umgebung und wartet auf dein Ja.

Beträge und Steuern: Preise sind in RSD inklusive Mehrwertsteuer (cenaSaPdv). Steuersätze sind 20, 10, 0 oder oslobodjeno (befreit). Bei einem Unternehmen außerhalb des Mehrwertsteuersystems wird jede Position als befreit erfasst, egal welcher Satz gesendet wird.

Limits: standardmäßig 240 Lese- und 120 Schreibvorgänge pro Minute und Unternehmen; Antworten tragen X-RateLimit-Limit, X-RateLimit-Remaining und X-RateLimit-Reset, und 429 kommt mit Retry-After. Höchstens 500 Positionen pro Beleg und 500 Kunden oder Artikel pro Aufruf; Anfragen bis 512 KB.

Häufige Fehler: 401 bedeutet einen fehlenden oder falschen Key. 402 bedeutet einen Tarif ohne API-Zugriff oder ein inaktives Abo (error sagt, was zutrifft). 403 bedeutet einen Nur-Lese-Key bei einem Schreibvorgang, einen Key eines Kassenterminals oder eine Anfrage von einer IP, die nicht in der Liste des Keys steht. 404 heißt, dass das Dokument in deinem Unternehmen nicht existiert. 409 heißt, dass die Aktion nicht erlaubt ist (nicht ausgestellt, schon teilweise erstattet) oder dieselbe externalId gerade verarbeitet wird. 422 listet Feld- oder Regelfehler in fields auf. 202 bei einem Schreibvorgang heißt, dass das Dokument existiert, die Steuerverwaltung es aber noch nicht angenommen hat; Tezga wiederholt das selbst, deshalb schickt die KI es nicht noch einmal.

Schritt 2 — Adapter 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

Schritt 3 — Connector in Claude hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese Anleitung YOUR_SERVER_ID zeigt.

Empfohlener Weg: funktioniert auf claude.ai web ohne Anfassen einer Konfigurationsdatei.

1. Öffne in Claude Customize → Connectors.
2. Klicke auf + und dann auf Add custom connector.
3. Gib einen Namen ein, z. B. Tezga eKasa, und die Remote-MCP-Server-URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, dann klicke auf Add.
4. Klicke auf Connect und melde dich bei AnythingMCP an (OAuth), um den Zugriff zu erlauben.

Alle unten gelisteten Tools erscheinen in deinem Chat: Leg los mit Prompts.

Verfügbare Tools

Beispiel-Prompts

• „In welcher Umgebung läuft unser Tezga-Konto, und ist das Unternehmen im Mehrwertsteuersystem?“
• „Hat Bestellung 10452 schon einen Fiskalbeleg? Gib mir die PFR-Nummer und den öffentlichen PDF-Link.“
• „Liste die eingegangenen Bankzahlungen seit Montag auf, damit ich sie unseren Rechnungen zuordnen kann.“
• „Ist der Beleg zu Bestellung 10398 ausgestellt oder storniert, und wie hoch war die Summe?“
• „Welche Steuerkennzeichen nutzt unser Konto, und für welchen Satz steht jedes?“

FAQ

Funktioniert es mit Claude Code genauso wie mit Claude Desktop? Ja, beide auf https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID zeigen lassen.

Nächste Schritte

• Connector-Startseite
• Mit ChatGPT verbinden
• Mit Cursor verbinden
• Mit Gemini verbinden
• Mit Meta Muse verbinden
• Mit Microsoft Copilot verbinden