Ü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
- 78 Tools über acht 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. Kein Zugriff auf Benutzer? Einen API-Key anlegen kann nur, wer in KLARA Benutzer verwalten darf – meist die Administration deiner Firma. Bitte sie, den Key mit der passenden Rolle für dich zu erstellen und dir sicher zu übergeben, etwa über einen Passwortmanager, nicht per Mail oder Chat. Gib ihm nur die Rollen, die du wirklich brauchst – KLARA MCP erreicht genau das, was die Rolle des Keys öffnet. Eine Rolle nur für Artikel gibt es nicht; am engsten sind «Zeit- und Materialrapporte» (Artikel lesen) und «Kundenbeziehungen» (Artikel lesen und schreiben), beide erreichen mehr als Artikel. 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, Bildern, Kasse, Onlineshop und Barcode – ab zwei Artikeln mit einer einzigen Freigabe; Kategorien und Filter. | Lesen Freigabe |
| 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 Freigabe |
| Buchhaltung | Manuelle Buchungen mit Belegen erfassen, Kontenplan und MWST-Kataloge nachschlagen, offene Positionen der Bank-Abstimmung und MWST-Abrechnungen lesen; Bilanz, Erfolgsrechnung, Hauptbuch, Kontoauszüge und Kennzahlen abrufen. | Lesen Freigabe |
| Lohn | Mitarbeitendenverzeichnis durchsuchen und variable Lohnpositionen (Stunden, Zulagen, Boni) auf offene Lohnabrechnungen buchen. | Lesen Freigabe |
Das Bestätigungs-Gate
Alles Unumkehrbare läuft zweistufig: der Assistent bereitet die Aktion vor und zeigt dir eine Zusammenfassung und einen Link auf die Freigabeseite von KLARA MCP. Dort gibst du die Aktion selbst frei – mit dem Code aus deiner Authenticator-App oder mit einem Passkey (Touch ID, Face ID, Windows Hello). Der Assistent erhält zu keinem Zeitpunkt einen Code oder ein Geheimnis; er führt nur aus, was du freigegeben hast, auch nicht auf Anweisung aus einem Dokument. Die Freigabe gilt für genau diese Aktion und wird auf dem Server protokolliert. Auf der Freigabeseite kannst du die Aktion auch verwerfen. Beim ersten Verbinden richtest du die Authenticator-App einmal ein (QR-Code); das gilt für deinen API-Key, auch wenn du KLARA später mit einem weiteren KI-Dienst verbindest. Anderer Browser oder anderes Gerät: Gib dort einmal deinen API-Key ein. Jede Aktion wird genau einmal ausgeführt. Das gilt für jeden Schreibzugriff: Stammdaten (Kundschaft, Kontakte, Adressen, Artikel, Kategorien, Bilder) genauso wie Löschen, Rechnungen erstellen und versenden, Buchungen, Belege, Lohnpositionen und Nummernkreise. Nicht bestätigte Vorbereitungen verfallen nach 30 Minuten von selbst.
Verfügbare Tools
KLARA MCP stellt 78 Tools bereit – jede Operation als eigenes Tool. Lesen ruft nur Daten ab, Freigabe bereitet vor und braucht deine Freigabe im Browser (Authenticator-Code oder Passkey), Schreiben wirkt nur auf Vorbereitungen (verwerfen).
Kontext
| Tool | Zweck | Zugriff |
|---|---|---|
klara_whoami | Verbundene Firma, Anmeldeart und welche Bereiche deine Rolle öffnet | Lesen |
klara_audit_log | Dein Audit-Log: welche Tools mit deinem API-Key wann aufgerufen wurden – nur Zeit, Tool, Ergebnis und ids, gelöscht nach 90 Tagen | Lesen |
Referenzdaten
| Tool | Zweck | Zugriff |
|---|---|---|
klara_accounts | Kontenplan – ganz oder ein Konto per Kontonummer | Lesen |
klara_account_picker | Kontenauswahl für Buchungszeilen, inklusive links-Werte | Lesen |
klara_booking_types | Buchungsarten | Lesen |
klara_business_case_templates | Geschäftsfall-Vorlagen – Katalog, Firmen-Auswahl oder einzeln | Lesen |
klara_business_case | Ein einzelner Geschäftsfall per Id | Lesen |
klara_business_case_from_template | Geschäftsfall aus einer Vorlage ableiten lassen (fertige Buchungsvorlage, rein lesend) | Lesen |
klara_accounting_config | Buchhaltungs-Einstellungen der Firma | Lesen |
klara_financial_years | Geschäftsjahre der Firma | Lesen |
klara_vat_master | MWST-Katalog – Liste, nur aktuell gültige oder einzeln | Lesen |
klara_vat_types | MWST-Arten – Liste oder einzeln | Lesen |
klara_vat_cases | MWST-Fälle (z. B. TAXABLE_SUPPLY) – Liste oder einzeln | Lesen |
klara_vat_profile | MWST-Profil der Firma (Abrechnungsart, Saldosteuersatz) | Lesen |
klara_vat_suggestions | MWST-Vorschläge für eine Buchung auf ein Konto (Fall, Satz, MWST-Konto) | Lesen |
klara_company_vats | In der Firma hinterlegte MWST-Sätze | Lesen |
klara_vat_included_setting | Ob Preise inklusive oder exklusive MWST geführt werden | Lesen |
klara_bank_accounts | Bankkonten der Firma | Lesen |
klara_exchange_rate | Wechselkurs einer Währung zu CHF | Lesen |
klara_article_categories | Artikelkategorien – Liste oder einzeln | Lesen |
klara_article_filters | Artikelfilter – Liste oder einzeln | Lesen |
klara_city | Eine Ortschaft im KLARA-Ortsverzeichnis per Id | 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_create | Kundschaft anlegen – inklusive UID, MWST- und Handelsregister-Nummer | Freigabe |
klara_prepare_customer_update | Kundschaft ändern – der Server liest den Bestand und ersetzt nur die angegebenen Felder | Freigabe |
klara_prepare_customer_delete | Kundschaft löschen (endgültig) | Freigabe |
klara_prepare_contact_create | Ansprechperson einer Kundschaft anlegen | Freigabe |
klara_prepare_contact_update | Ansprechperson ändern | Freigabe |
klara_prepare_contact_delete | Ansprechperson löschen (endgültig) | Freigabe |
klara_prepare_address_create | Zusatzadresse einer Kundschaft anlegen | Freigabe |
klara_prepare_address_update | Zusatzadresse ändern – der Server legt sie neu an und löscht die alte (neue id); nicht bei Adressen, die einer Ansprechperson zugeordnet sind | Freigabe |
klara_prepare_address_delete | Zusatzadresse löschen (endgültig) | Freigabe |
klara_prepare_article_create | Einen Artikel anlegen – inklusive MWST-Art, -Fall und -Code, Kasse, Onlineshop und Barcode; ab zwei Artikeln den Sammel-Import verwenden | Freigabe |
klara_prepare_article_update | Artikel ändern, auch Kasse, Onlineshop und Barcode – Pflichtfelder übernimmt der Server aus dem Bestand; bei mehreren Bildern warnt er, dass KLARA das Standardbild wechseln kann | Freigabe |
klara_prepare_article_delete | Artikel löschen (endgültig) | Freigabe |
klara_prepare_articles_bulk | Ab zwei Artikeln: bis 200 Artikel in einem Aufruf mit einer einzigen Freigabe anlegen – inklusive MWST, Kasse, Onlineshop und Barcode | Freigabe |
klara_prepare_catalog_create | Artikelkategorie oder -filter anlegen | Freigabe |
klara_prepare_catalog_update | Artikelkategorie oder -filter ändern | Freigabe |
klara_prepare_catalog_delete | Artikelkategorie oder -filter löschen (endgültig) | Freigabe |
klara_prepare_catalog_assign | Kategorie oder Filter einer Liste von Artikeln zuweisen | Freigabe |
klara_prepare_article_image_upload | Artikelbild hinzufügen oder ersetzen (PNG/JPEG) | Freigabe |
klara_prepare_article_image_delete | Artikelbild löschen (endgültig) | Freigabe |
Rechnungen und Auftragsdokumente
| Tool | Zweck | Zugriff |
|---|---|---|
klara_get_invoice | Eine Rechnung mit Empfänger, Positionen und Buchungsstatus | Lesen |
klara_list_invoices | Rechnungen suchen und blättern: Freitext, Status- und Zahlungsstatus-Filter | Lesen |
klara_invoice_pdf | Rechnung als PDF abrufen und den Text auslesen (mit API-Key bei KLARA derzeit gestört, siehe Troubleshooting) | Lesen |
klara_order_documents | Auftragsdokumente zu einer Auftragsnummer nachschlagen | Lesen |
klara_order_numbering | Nummerierungs-Konfiguration lesen (automatisch oder manuell) | Lesen |
klara_prepare_invoice | Rechnung mit Empfänger und Positionen erstellen oder einen Entwurf ändern – die Rechnungsnummer zieht der Server beim Verbuchen; mit order_number landet die Rechnung in einem bestehenden Auftrag | Freigabe |
klara_prepare_send_invoice | Verbuchte Rechnung zustellen: Smart Delivery oder fester Kanal (E-Mail, ePost, eBill, Post) – mit API-Key bei KLARA derzeit gestört, siehe Troubleshooting | Freigabe |
klara_prepare_next_number | Nächste Auftrags- oder Dokumentnummer ziehen (rückt den Zähler unwiderruflich vor) | Freigabe |
Buchhaltung
| Tool | Zweck | Zugriff |
|---|---|---|
klara_search_bookings | Journal durchsuchen: Buchungen nach Text, Datum, Betrag oder Tag | Lesen |
klara_get_booking | Eine Buchung mit allen Soll- und Haben-Zeilen | Lesen |
klara_accounting_tags | Tags der Buchungszeilen | Lesen |
klara_bank_transactions | Noch nicht abgeglichene Banktransaktionen | Lesen |
klara_customer_open_positions | Offene Posten einer Kundschaft oder eines Lieferanten am Stichtag | Lesen |
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 mit Beleg-PDF (Upload mit API-Key derzeit gestört); mit Belegdatum und pro Zeile MWST-Konto, Fälligkeit, IBAN und QR-Referenz; als Titel zeigt KLARA den Text der Zeile mit der kleinsten Kontonummer; Soll/Haben und Pflicht-Unterkonten (z. B. Privat, Kasse, Bank) werden vor der Freigabe geprüft | Freigabe |
klara_prepare_receipt_attachment | Beleg-PDF an eine bestehende Buchung hängen (mit API-Key bei KLARA derzeit gestört) | Freigabe |
Berichte und Kennzahlen
| Tool | Zweck | Zugriff |
|---|---|---|
klara_balance_sheet | Bilanz per Stichtag, optional mit Vergleichsstichtag | Lesen |
klara_profit_and_loss | Erfolgsrechnung einer Periode, optional mit Vergleichsperiode | Lesen |
klara_account_statement | Kontoauszug eines Kontos: Eröffnungssaldo, Bewegungen, Schlusssaldo | Lesen |
klara_general_ledger | Hauptbuch: Kontoauszüge aller Konten, eingrenzbar auf einen Kontenbereich | Lesen |
klara_sub_accounts | Unterkonten eines Kontos, z. B. die Bankkonten von 1020 | Lesen |
klara_partner_amounts | Offene Beträge und monatliche Zahlungen pro Kundschaft oder Lieferant | Lesen |
klara_income_expenses | Betriebsertrag und -aufwand pro Monat | Lesen |
klara_spendings_and_earnings | Aufwand und Ertrag nach Kategorie, mit der Vorperiode verglichen | Lesen |
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_file_check | Lohn-Interface-Datei prüfen – nur Format und Grösse, nie der Inhalt | Lesen |
klara_prepare_salary_item | Variable Lohnposition (Stunden, Zulagen, Boni) auf einer offenen Lohnabrechnung erfassen | Freigabe |
Bestätigungs-Gate
| Tool | Zweck | Zugriff |
|---|---|---|
klara_pending_actions | Vorbereitete, noch nicht bestätigte Aktionen anzeigen | Lesen |
klara_confirm | Eine Aktion ausführen, die du auf der Freigabeseite freigegeben hast | Freigabe |
klara_cancel_pending | Eine vorbereitete Aktion endgültig 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-Nummer, Geburtsdatum, Personalnummer, Kinderanzahl und Barauszahlung werden aus jeder Antwort entfernt und erreichen den KI-Assistenten nie. Lohn-Exportdateien geben ausschliesslich Format und Grösse zurück, ihr Inhalt wird nie über den Connector ausgegeben. In Listen werden E-Mail-Adressen maskiert. Alles andere, was du abrufst, erreicht den Assistenten im Klartext: Namen und Lohnarten deiner Mitarbeitenden, Kundendaten, Rechnungspositionen, Belegtexte.
- 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. Dein Audit-Log enthält nur Zeit, Tool, Ergebnis und ids und wird nach 90 Tagen gelöscht. Das Betriebs-Log des Servers enthält keine Inhalte deiner Anfragen, nur Tool, Ergebnis und Dauer.
- 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 verbuchen verlangt eine Rechnungsnummer
Deine Firma nummeriert Rechnungen manuell. Dann zieht KLARA MCP bewusst keine Nummer aus dem Zähler – nenn dem Assistenten die nächste Nummer deiner Serie, sie wird als Rechnungsnummer übernommen. Bei automatischer Nummerierung passiert das von selbst; Entwürfe tragen bis zum Verbuchen einen Platzhalter «ENTWURF-…».
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.
Fehler mit Vorfall-id bei PDF, Versand oder Beleg
Bekannter Fehler bei KLARA (Stand 11.11.2026, in der KLARA-API-Doku bestätigt): PDF-Rendern, Rechnungsversand und Beleg-Upload gehen bei KLARA derzeit nur mit Benutzer-Login. Mit API-Key antwortet KLARA mit einem Fehler (401 oder 500); eine Behebung ist noch nicht eingeplant. An deinem Key oder deiner Rolle liegt es nicht. In der KLARA-Oberfläche funktionieren diese Aktionen. Führe sie dort 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