Überblick
KLARA MCP ist ein Server nach dem offenen Model Context Protocol (MCP), betrieben von ePost Service AG. Er verbindet MCP-fähige KI-Assistenten – zum Beispiel Claude oder ChatGPT – mit deinem KLARA-Mandanten. Der Assistent kann damit Kundschaft und Artikel suchen und pflegen, Rechnungen mit Positionen und Empfängerbezug erstellen, Buchungen samt Belegen erfassen und variable Lohnpositionen auf offene Lohnabrechnungen buchen.
- Server-Adresse:
https://mcp.klara.ch/mcp - Transport: Streamable HTTP · Anmeldung: OAuth 2.0 mit persönlichem KLARA-API-Key
- 34 Tools über vier Bereiche, siehe Verfügbare Tools
Verbinden
Schritt 1 für alle Clients: API-Key in KLARA erstellen. In KLARA unter Benutzer einen neuen API-Key anlegen. Gib ihm nur die Rollen, die du wirklich brauchst – KLARA MCP erreicht genau das, was die Rolle des Keys öffnet. Die Anmeldung funktioniert ausschliesslich mit einem API-Key; dein KLARA-Passwort gibst du nur bei KLARA selbst ein, nie auf anderen Seiten.
Mit Claude verbinden
- In Claude unter Einstellungen → Connectors auf Custom Connector hinzufügen gehen und
https://mcp.klara.ch/mcpeintragen – oder den KLARA-Eintrag im Connector-Verzeichnis wählen. - Claude öffnet die KLARA-MCP-Anmeldeseite: API-Key einfügen und verbinden.
Mit ChatGPT verbinden
- chatgpt.com/plugins öffnen und auf das Plus «Neues Plugin» klicken. Als Adresse
https://mcp.klara.ch/mcpeintragen. - Beim ersten Verbinden öffnet sich die KLARA-MCP-Anmeldeseite: API-Key einfügen und verbinden.
Starte mit dem Prompt «KLARA whoami» – der Assistent zeigt dir dann, mit welcher Firma du verbunden bist und welche Bereiche deine Rolle öffnet.
Beispiele
So sehen typische Aufträge an deinen KI-Assistenten aus (alle Angaben erfunden):
Fähigkeiten
| Bereich | Was der Assistent kann | Zugriff |
|---|---|---|
| Kundschaft & Artikel | Suchen, anlegen und ändern: Kundschaft mit Adressen, Kontakten, UID und MWST-Nummer; Artikel mit Preisen, MWST und Bildern; Kategorien und Filter. | Lesen Schreiben |
| Rechnungen & Aufträge | Rechnungen mit Positionen und Empfängerbezug erstellen und als PDF abrufen; Versand über E-Mail, ePost, eBill oder Post; Auftragsdokumente nachschlagen. | Lesen Code |
| Buchhaltung | Manuelle Buchungen mit Belegen erfassen, Kontenplan und MWST-Kataloge nachschlagen, offene Positionen der Bank-Abstimmung und MWST-Abrechnungen lesen. | Lesen Code |
| Lohn | Mitarbeitendenverzeichnis durchsuchen und variable Lohnpositionen (Stunden, Zulagen, Boni) auf offene Lohnabrechnungen buchen. | Lesen Code |
Das Bestätigungs-Gate
Alles Unumkehrbare läuft zweistufig: der Assistent bereitet die Aktion vor und zeigt dir eine Zusammenfassung mit einem einmaligen Bestätigungscode. Erst wenn du den Code nennst, wird ausgeführt – und jede Aktion genau einmal. Das gilt immer für: Löschen, Rechnungen erstellen und versenden, Buchungen, Belege, Lohnpositionen, Nummernkreise, Firmenstamm und Abonnemente. Nicht bestätigte Vorbereitungen verfallen nach 30 Minuten von selbst.
Verfügbare Tools
KLARA MCP stellt 34 Tools bereit. Lesen ruft nur Daten ab, Schreiben wird direkt ausgeführt, Code braucht deine Bestätigung mit dem einmaligen Code.
Kontext und Referenzdaten
| Tool | Zweck | Zugriff |
|---|---|---|
klara_whoami | Verbundene Firma, Anmeldeart und welche Bereiche deine Rolle öffnet | Lesen |
klara_reference_data | Kontenplan, MWST-Kataloge und -Fälle, Buchungsarten, Vorlagen, Bankkonten, Wechselkurse, Städte, Artikelkategorien und -filter | Lesen |
Kundschaft und Artikel
| Tool | Zweck | Zugriff |
|---|---|---|
klara_search_customers | Kundschaft suchen über Name, E-Mail, Telefon oder Kundennummer | Lesen |
klara_get_customer | Eine Kundschaft im Detail, auf Wunsch mit Ansprechpersonen und Zusatzadressen | Lesen |
klara_search_articles | Artikel per Volltextsuche oder Liste nach Produkttyp | Lesen |
klara_article_details | Ein Artikel mit Varianten, Set-Bestandteilen und Bild | Lesen |
klara_lookup_articles | Artikel gezielt nach Artikelnummern oder als aufgelöste Variantenliste | Lesen |
klara_prepare_customer | Kundschaft anlegen oder ändern – inklusive UID, MWST- und Handelsregister-Nummer | Schreiben Löschen: Code |
klara_prepare_customer_contact | Ansprechperson einer Kundschaft anlegen oder ändern | Schreiben Löschen: Code |
klara_prepare_customer_address | Zusatzadresse einer Kundschaft anlegen oder ändern | Schreiben Löschen: Code |
klara_prepare_article | Artikel anlegen oder ändern – inklusive MWST-Art, -Fall und -Code | Schreiben Löschen: Code |
klara_prepare_articles_bulk | Mehrere Artikel in einem Aufruf anlegen | Schreiben |
klara_prepare_article_catalog | Artikelkategorien und -filter anlegen, ändern, Artikeln zuweisen | Schreiben Löschen: Code |
klara_prepare_article_image | Artikelbild hinzufügen oder ersetzen (PNG/JPEG) | Schreiben Löschen: Code |
Rechnungen und Auftragsdokumente
| Tool | Zweck | Zugriff |
|---|---|---|
klara_get_invoice | Eine Rechnung mit Empfänger, Positionen und Buchungsstatus | Lesen |
klara_recent_invoices | Protokoll der über KLARA MCP erstellten Rechnungen (die KLARA-API hat keine Rechnungsliste) | Lesen |
klara_invoice_pdf | Rechnung als PDF abrufen und den Text auslesen | Lesen |
klara_order_documents | Auftragsdokumente nachschlagen und die Nummerierungs-Konfiguration lesen | Lesen |
klara_prepare_invoice | Rechnung mit Empfänger und Positionen erstellen oder einen Entwurf ändern | Code |
klara_prepare_send_invoice | Verbuchte Rechnung zustellen: Smart Delivery oder fester Kanal (E-Mail, ePost, eBill, Post) | Code |
klara_prepare_next_number | Nächste Auftrags- oder Dokumentnummer ziehen (rückt den Zähler unwiderruflich vor) | Code |
Buchhaltung
| Tool | Zweck | Zugriff |
|---|---|---|
klara_bank_open_positions | Offene Positionen der Bank-Abstimmung | Lesen |
klara_vat_report | MWST-Abrechnung einer Periode lesen (ohne Neuberechnung) | Lesen |
klara_prepare_booking | Manuelle Buchung erfassen, auf Wunsch direkt mit Beleg-PDF; Soll/Haben wird vorab geprüft | Code |
klara_prepare_receipt_attachment | Beleg-PDF an eine bestehende Buchung hängen | Code |
Lohn
| Tool | Zweck | Zugriff |
|---|---|---|
klara_search_employees | Mitarbeitendenverzeichnis mit Suche, Filter und Sortierung | Lesen |
klara_addable_salary_items | Welche Lohnarten auf die offene Lohnabrechnung einer Person dürfen | Lesen |
klara_payroll_export | Lohn-Interface-Datei erzeugen (Inhalt nur auf ausdrückliches Verlangen) | Lesen |
klara_prepare_salary_item | Variable Lohnposition (Stunden, Zulagen, Boni) auf einer offenen Lohnabrechnung erfassen | Code |
Mandant und Bestätigungs-Gate
| Tool | Zweck | Zugriff |
|---|---|---|
klara_prepare_profile | Firmenstamm des eigenen Mandanten ändern oder anlegen | Code |
klara_prepare_subscription | KLARA-Abonnement anlegen (kostenpflichtig, eigene Vertragsbedingungen) | Code |
klara_pending_actions | Vorbereitete, noch nicht bestätigte Aktionen anzeigen | Lesen |
klara_confirm | Eine vorbereitete Aktion mit dem Bestätigungscode ausführen | Code |
klara_cancel_pending | Eine vorbereitete Aktion verwerfen | Schreiben |
Sicherheit & Daten
- Anmeldung über OAuth 2.0, ausschliesslich mit API-Key. Der KI-Assistent erhält nie deinen KLARA-API-Key – er bleibt verschlüsselt auf dem KLARA-MCP-Server (betrieben von ePost Service AG, gehostet in Frankfurt) und wird nur für die Aufrufe an KLARA verwendet. Ein Login mit KLARA-Benutzername und Passwort gibt es bewusst nicht: dein Passwort gehört nur auf die KLARA-Anmeldeseite.
- Deine Rolle bestimmt den Zugriff. KLARA MCP erreicht exakt die Bereiche, die die Rolle deines API-Keys in KLARA öffnet – nicht mehr.
- Datensparsamkeit. AHV-Nummern, Geburtsdaten und Personalnummern verlassen den Server nie. In Listen werden E-Mail-Adressen maskiert. Lohn-Exportdateien geben standardmässig nur Format und Grösse zurück, nicht den Inhalt.
- Was der KI-Assistent sieht. Die Ergebnisse der Tools – etwa gefundene Kundschaft oder eine Rechnungszusammenfassung – fliessen in dein Gespräch ein und werden vom jeweiligen Anbieter (z. B. Anthropic oder OpenAI) wie deine übrigen Chat-Inhalte verarbeitet.
- Freiwilliger Zusatzservice. Der AI-Connector gehört nicht zur normalen KLARA-Nutzung – du aktivierst ihn bewusst und entscheidest selbst, mit welchem KI-Dienst du KLARA verbindest. Der gewählte Anbieter verarbeitet die abgerufenen Inhalte nach seinen eigenen Bedingungen, unter Umständen ausserhalb der Schweiz. Die Anmeldeseite weist beim Verbinden darauf hin.
- Löschfristen. Anmeldelinks und Einmalcodes werden nach Ablauf gelöscht. Beleg-Inhalte vorbereiteter Aktionen fallen unmittelbar nach Ausführung, Abbruch oder Verfall weg, die Zusammenfassungen nach 30 Tagen. Verbindungen, die 180 Tage nicht benutzt wurden, werden samt verschlüsseltem API-Key gelöscht; das Rechnungsprotokoll nach einem Jahr.
- Datenschutz. Einzelheiten zur Datenbearbeitung bei KLARA findest du in der Datenschutzerklärung.
- Zugriff beenden. Lösche den API-Key in KLARA unter Benutzer – damit ist der Zugriff sofort und vollständig beendet. Den Connector kannst du zusätzlich in deinem KI-Assistenten entfernen.
Troubleshooting
«Zugriff verweigert» oder ein Bereich fehlt
Der Rolle deines API-Keys fehlt die Berechtigung, oder deiner Firma das passende KLARA-Abo – ohne Abo bleibt eine Funktion auch für Administratoren zu. Frag den Assistenten nach «KLARA whoami»: die Antwort zeigt, welche Bereiche offen sind. Für mehr Zugriff in KLARA unter Benutzer einen Key mit passender Rolle erstellen und neu verbinden.
Eine Ortschaft wird beim Anlegen abgelehnt
KLARA prüft Ortschaften gegen sein eigenes Verzeichnis und kennt manche nur mit Kantonszusatz – zum Beispiel «Studen BE» statt «Studen». Schreibweise anpassen und erneut versuchen; die Fehlermeldung weist darauf hin.
Rechnung erstellen verlangt eine Dokumentnummer
Deine Firma nummeriert Rechnungen manuell. Dann zieht KLARA MCP bewusst keine Nummer aus dem Zähler – nenn dem Assistenten die nächste Nummer deiner Belegserie, sie wird als Dokumentnummer übernommen. Bei automatischer Nummerierung passiert das von selbst.
Beim Verbuchen entsteht kein Rechnungs-PDF
Das ist Verhalten der KLARA-API: anders als die Oberfläche erzeugt sie beim Verbuchen kein Dokument. Bitte den Assistenten anschliessend, das PDF zu erstellen – auf Wunsch hängt er es danach an die Buchung an.
Neue Funktionen tauchen nicht auf
KI-Assistenten merken sich die Werkzeugliste eines Servers beim Verbinden. Nach Updates von KLARA MCP einmal trennen und neu verbinden.
Die erste Antwort dauert lange
Nach längerer Pause startet der Server neu (Kaltstart). Die erste Anfrage kann darum einige Sekunden dauern, danach ist es schnell.
«Diese Aktion ist nicht mehr gültig»
Vorbereitete Aktionen verfallen nach 30 Minuten ohne Bestätigung – aus Sicherheit. Bitte den Assistenten einfach, die Aktion neu vorzubereiten.
Serverfehler mit Vorfall-id bei Verbuchen, PDF oder Versand
Bekannte Fehler der KLARA-Schnittstelle (Stand August 2026, KLARA gemeldet): das Verbuchen von Rechnungen, das PDF-Rendern und der Versand können über die Schnittstelle mit einem Serverfehler enden, obwohl dieselbe Aktion in der KLARA-Oberfläche funktioniert. Führe die Aktion in KLARA aus; die Vorfall-id aus der Meldung hilft dem Support.
Support
Fragen, Probleme oder Sicherheitsanliegen zu KLARA MCP: support@klara.ch
Hilfreich für eine schnelle Antwort: die Fehlermeldung aus deinem KI-Assistenten – sie enthält bei KLARA-Fehlern eine Vorfall-id, die den Fall eindeutig macht. Bitte nie API-Keys oder Passwörter mitschicken.
Mehr zu KLARA: klara.ch · Für Entwicklerinnen und Entwickler: developer.klara.ch