KLARA MCP

Ü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
• 64 Tools über sieben 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.

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

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 64 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

Referenzdaten

Kundschaft und Artikel

Rechnungen und Auftragsdokumente

Buchhaltung

Lohn

Bestätigungs-Gate

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

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