Tezga eKasa über MCP mit Gemini 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 + Gemini

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 Gemini 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.

Gemini CLI liest MCP-Server aus ~/.gemini/settings.json (unter Windows %USERPROFILE%\.gemini\settings.json). Füge hinzu:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Erstelle in AnythingMCP unter MCP Servers → dein Server → API keys einen MCP-API-Key und setze ihn anstelle von YOUR_MCP_API_KEY ein.
2. Speichere die Datei und starte gemini neu.
3. Führe in der Gemini CLI /mcp aus (oder gemini mcp list im Terminal): anythingmcp sollte als verbunden erscheinen.
4. Leg los: Gemini CLI kann jetzt die Tezga eKasa-Tools aufrufen.

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

Wo sucht Gemini CLI nach MCP-Servern? In ~/.gemini/settings.json für deinen Benutzer oder in .gemini/settings.json innerhalb eines Projekts. gemini mcp list zeigt jeden Server und ob er sich verbindet.

Nächste Schritte

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