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

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 Microsoft Copilot 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.

Microsoft Copilot nutzt MCP-Server über Agents, die du in Copilot Studio baust: Du fügst AnythingMCP einem Agent als Tool hinzu und veröffentlichst den Agent dann in Microsoft 365 Copilot und Teams. Copilot Studio verbindet sich aus der Cloud von Microsoft per Streamable HTTP, das AnythingMCP unterstützt.

1. Öffne in Copilot Studio deinen Agent (oder leg einen an), geh zu Tools und wähle Add a tool → New tool → Model Context Protocol.
2. Trag einen Server name ein (zum Beispiel AnythingMCP), eine Server description, die sagt, was der Connector kann, und die Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Anhand der Beschreibung entscheidet Copilot Studio, wann es den Server aufruft.
3. Wähle bei der Authentifizierung API key, setze Type auf Header und den Header-Namen auf X-API-Key und klicke auf Create.
4. Wähle in Add tool die Option Create a new connection, füge einen MCP-API-Key aus AnythingMCP ein (MCP Servers → dein Server → API keys) und klicke auf Add to agent.
5. Probier es im Test-Bereich des Agents aus: Bitte um etwas, wofür er die Tezga eKasa-Tools braucht.
6. Klicke auf Publish, dann auf Channels → Microsoft 365 and Microsoft Teams, lass Make agent available in Microsoft Copilot aktiviert und wähle Add channel. See agent in Teams installiert den Agent für dich; in Microsoft 365 Copilot tippst du @ und wählst den Agent aus.

Lieber eine Anmeldung pro Person? Wähle statt API key OAuth 2.0 → Dynamic discovery: Dann meldet sich jede Person beim ersten Aufruf des Agents bei AnythingMCP an.

Du hostest selbst? Nimm statt https://cloud.anythingmcp.com die öffentliche HTTPS-Adresse deiner Instanz. Copilot Studio verbindet sich aus der Cloud von Microsoft, localhost funktioniert deshalb nicht.

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

Für welchen Copilot gilt das? Für Microsoft 365 Copilot im Unternehmen, über Agents aus Copilot Studio. Die Microsoft-Copilot-App für private Konten bietet keine Möglichkeit, einen eigenen MCP-Server hinzuzufügen.

Was brauche ich? Ein Arbeitskonto mit Zugang zu Copilot Studio (Lizenz oder Testversion), um den Agent zu bauen. Wer ihn in Microsoft 365 Copilot oder Teams nutzen soll, braucht Zugriff auf den Agent: Teile ihn oder lass ihn von einem Admin für die Organisation veröffentlichen. Wendet deine Organisation Datenrichtlinien auf Power-Platform-Connectors an, gelten sie auch für MCP-Server.

Der Agent ruft die Tools nicht auf. Prüfe, dass der Header-Name genau X-API-Key lautet und der Schlüssel zum selben MCP-Server gehört wie die URL, und formuliere die Server description konkret: Copilot Studio entscheidet anhand der Beschreibung, wann es den Server aufruft. Veröffentliche den Agent nach jeder Änderung erneut; in einem offenen Chat holst du die neue Version mit „start over“.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden
• Mit Cursor verbinden
• Mit Gemini verbinden
• Mit Meta Muse verbinden