Integrationen / KI-Assistenten / MCP server pre AI asistentov
MCP-Server für KI-Assistenten
VerfügbarDas Verteco-Portal hat einen eigenen Server für das Model Context Protocol (MCP), den offenen Standard, über den sich KI-Assistenten wie Claude Code, Claude Desktop, Cursor oder VS Code Copilot mit externen Systemen verbinden. Der Assistent meldet sich mit einem gewöhnlichen API-Schlüssel Ihres Kontos an, erhält sechs Werkzeuge und sieht nie mehr als Ihr Konto. Der Versand einer Rechnung ist rechtlich bindend, deshalb lehnt das Werkzeug send_document einen Aufruf ohne das Argument confirm = true ab.
So funktioniert es
- 1Öffnen Sie im Portal API-Tokens (linkes Menü) und den Reiter MCP-Server. Klicken Sie auf Schlüssel für KI-Assistenten erstellen: es entsteht ein eigener API-Schlüssel nur für den Assistenten, den Sie jederzeit widerrufen oder auf dem Reiter API-Schlüssel auf IP-Adressen beschränken. Der Schlüssel wird nur einmal angezeigt.
- 2Kopieren Sie die fertige Konfiguration für Ihren Assistenten: Claude Code (Befehl claude mcp add mit dem Transport http und der Kopfzeile Authorization: Bearer), Claude Desktop (claude_desktop_config.json über die Brücke mcp-remote, braucht Node.js), Cursor (mcp.json) oder VS Code (.vscode/mcp.json). Die Serveradresse ist https://peppol.verteco.digital/api/mcp.
- 3Beginnen Sie ein Gespräch. Der Assistent lädt mit dem Werkzeug list_companies die Unternehmen Ihres Kontos und beantwortet dann Fragen wie „Welche Rechnungen vom letzten Monat sind noch nicht zugestellt, und warum?“ oder „Prüfe, ob dieser Kunde im Peppol-Netzwerk ist“.
- 4Eine Rechnung sendet der Assistent erst nach Ihrer ausdrücklichen Zustimmung zur konkreten Rechnung und zum Empfänger; das Werkzeug send_document lehnt einen Aufruf ohne confirm = true ab. Jeden Aufruf des Assistenten sehen Sie auf dem Reiter API-Log.
Was die Integration löst
- ✓Sechs Werkzeuge: list_companies, list_documents, get_document, check_participant, validate_document und send_document
- ✓Streamable HTTP und zustandsloses JSON-RPC 2.0: POST an /api/mcp mit der Kopfzeile Authorization: Bearer und Ihrem API-Schlüssel
- ✓Rechnungsdetail inklusive MLS-Zustellbestätigung, Meldung an die Finanzverwaltung und optional dem UBL XML bis 1 MB
- ✓Live-Prüfung des Empfängers im Peppol-Netzwerk (SML/SMP) und Validierung der Rechnung gegen EN 16931 und Peppol BIS 3.0
- ✓Versand nur mit confirm = true nach Ihrer ausdrücklichen Zustimmung; die Schranke des Verifizierungsmerkmals gilt wie beim Versand aus dem Portal
- ✓Der Assistent sieht nie mehr als Ihr Konto; den Schlüssel widerrufen Sie mit einem Klick, beschränken ihn auf IP-Adressen, und jeder Aufruf steht im API-Log und im Sicherheitsprotokoll des Kontos
Häufige Fragen: E-Rechnungen für MCP server pre AI asistentov
- Welche KI-Assistenten unterstützt der MCP-Server?
- Jeden Client, der mit MCP über Streamable HTTP arbeiten kann: Claude Code (Befehl claude mcp add), Claude Desktop über die Brücke mcp-remote (braucht Node.js, weil Claude Desktop eigene Kopfzeilen noch nicht direkt unterstützt), Cursor (mcp.json) und VS Code mit GitHub Copilot im Agent-Modus. Fertige Konfigurationen liegen im Portal auf der Seite API-Tokens im Reiter MCP-Server. Die Web- und Mobilversion von Claude (claude.ai) verbindet entfernte Server nur über OAuth, das wir noch nicht anbieten.
- Kann der Assistent eine Rechnung ohne mein Wissen senden?
- Nein. Das Werkzeug send_document lehnt einen Aufruf ohne das Argument confirm = true ab, und die Serveranweisungen tragen dem Assistenten auf, Ihre ausdrückliche Zustimmung zur konkreten Rechnung und zum Empfänger einzuholen. Es gilt auch die Versandschranke (das Verifizierungsmerkmal) wie beim Versand aus dem Portal: senden kann nur ein Unternehmen, das die Auswahl des Anbieters auf dem Portal der Finanzverwaltung abgeschlossen hat.
- Was sieht der Assistent und wo prüfe ich das?
- Genau das, worauf Ihr Konto Zugriff hat, und nichts mehr; die Rechnungsdaten bleiben bei uns in der EU und der Assistent erhält nur, wonach er fragt. Jeden Aufruf des Schlüssels sehen Sie auf dem Reiter API-Log der Seite API-Tokens und im Sicherheitsprotokoll des Kontos. Wir empfehlen einen eigenen Schlüssel nur für den Assistenten, damit Sie ihn jederzeit ohne Auswirkung auf andere Integrationen widerrufen können.
- Was brauche ich vor der Verbindung?
- Ein Konto auf peppol.verteco.digital mit mindestens einem Unternehmen, weil ein API-Schlüssel an die Unternehmen des Kontos gebunden ist. Der einfachste Weg ist die Auswahl von Verteco als Anbieter auf dem Portal der Finanzverwaltung (Anmeldung mit eID oder mit den Zugangsdaten zum FS-Portal); das Unternehmen wird auf Ihrem Konto automatisch angelegt und gleich danach erzeugen Sie den Schlüssel.
- Was kostet das?
- Die Anbindung ist kostenlos. Der Dienst kostet ab €2/Monat zzgl. MwSt. je Unternehmens-ID (IČO), die sendet oder das Datenarchiv eingeschaltet hat; Empfang mit ausgeschaltetem Archiv ist kostenlos (bis 1.000 Rechnungen pro Monat). Während der freiwilligen Phase vor der Pflicht ab 1. 1. 2027 ist alles kostenlos.
Starten Sie heute: die Auswahl auf dem Portal der Finanzverwaltung genügt
Wie läuft die Auswahl ab? (3 Schritte, ~2 Minuten)
- 1Klicken Sie auf die Schaltfläche oben. Die offizielle Seite der Finančná správa „Výber certifikovaného poskytovateľa" (Auswahl des zertifizierten Anbieters) öffnet sich mit vorausgewähltem Verteco. Klicken Sie auf „Pokračovať" (Weiter).
- 2Melden Sie sich beim Portal der Finančná správa an, über slovensko.sk (eID / Personalausweis mit Chip) oder mit Ihren PFS-Zugangsdaten, und bestätigen Sie die Anbieterauswahl.
- 3Fertig. Sie erhalten eine E-Mail mit den Anmeldedaten. Konto, Unternehmen und Peppol-Netzwerkregistrierung erstellen wir automatisch. Hält bereits ein anderer Anbieter Ihren Empfangseintrag, übernehmen wir ihn nicht: Sie erhalten die Anleitung mit dem Migrationscode, oder Sie legen im Portal fest, dass der Empfang dort bleibt und Sie über uns nur versenden.
- Keine eID? Beim Portal der Finančná správa können Sie sich auch mit PFS-Kennung und Passwort anmelden. Oder registrieren Sie sich hier mit E-Mail und Passwort, fügen Sie Ihr Unternehmen manuell hinzu und schließen Sie die Auswahl später ab.
- Ihr Unternehmen erscheint nicht bei der Auswahl des Steuersubjekts? Angezeigt werden nur Subjekte, für die Sie im FS-Portal autorisiert sind. Fügen Sie die Autorisierung in der Persönlichen Internetzone hinzu (Autorizácie → Pridať autorizovaného používateľa) und schließen Sie die Auswahl ab.
- Ausführliche Anleitung zur Auswahl im FS-Portal (auf Slowakisch) →
Verwandt: Peppol-Prüfung eines Unternehmens · Leitfaden E-Rechnung 2027 · Preisliste · alle Integrationen