MCP-Server
Verbinden Sie einen KI-Client mit dem Klaracase-MCP-Server (v0.107.0), um Antworten auf dem Bestand und dem Verweisnetz zu fundieren.
Credits und Wiederholungen: was als dieselbe Antwort giltUnterstützte Clients
Sie nutzen ChatGPT oder Claude im Chat? Zur Anleitung unter KI-Assistenten
Der Server kennt zwei Wege hinein: ein persönliches Bearer-Token für Clients, die eigene Header zulassen, und OAuth 2.1 für Chat-Clients, die das nicht tun. Stand der Herstellerangaben: 07.11.2026.
OAuth 2.1 ist seit dem 29.07.2026 aktiv. Claude und ChatGPT haben wir mit echten Konten bis zum ersten Werkzeugaufruf durchgespielt, ChatGPT über den Eintrag im Verzeichnis. Tarif- und Authentifizierungsangaben der Hersteller wurden am 07.11.2026 geprüft und können sich jederzeit ändern.
Token erstellen
Client verbinden
Der MCP-Endpunkt ist https://klaracase.de/mcp (streamfähiges HTTP, POST). Er nimmt sowohl ein Bearer-Token als auch OAuth 2.1 an.
Die Verbindung steht, sobald der Client die klaracase-Werkzeuge auflistet und ein erster Aufruf ein Ergebnis liefert. Zeigt ein Client den Server als verbunden an, listet aber keine Werkzeuge, ist die Authentifizierung fehlgeschlagen, siehe unten.
So arbeiten Sie mit KI-Assistenten
Ein KI-Assistent ruft klaracase nicht immer von selbst auf. Antwortet er aus dem Gedächtnis, rufen Sie klaracase gezielt auf, wie unten beschrieben. Das macht die Antworten belastbarer: Sie erhalten Entscheidungen mit Quellen statt Aussagen ohne Belege.
Fehlerbehebung
Credits, API-Budget und Limits
Jeder kostenpflichtige Werkzeugaufruf wird in Credits bezahlt. Dieser Abschnitt erklärt, woher die Credits kommen und was ein Client tut, wenn ein Aufruf abgelehnt wird.
Credits des Tarifs
Jeder Tarif enthält Credits für einen Abrechnungszeitraum. Sie bezahlen die Web-App, die API und MCP gemeinsam. Ein bezahlter Tarif erneuert sie, sobald der nächste Abrechnungszeitraum beginnt.
API-Budget
Im Tarif Professional, und im Tarif Enterprise, wenn der Vertrag es vorsieht, kann eine Verwaltung der Organisation ein vorausbezahltes API-Budget in Euro aufladen. Das API-Budget bezahlt Aufrufe über MCP und über die API, sobald die Credits des Tarifs aufgebraucht sind. Es verfällt nicht. Die Web-App nutzt es nicht: Sind die Credits des Tarifs aufgebraucht, hält die Web-App an. Das API-Budget ist für KI-Assistenten und Programme gedacht, die nicht mitten in einer Aufgabe stehen bleiben sollen.
API-Budget aufladenReihenfolge der Zahlung
Zuerst werden die Credits des Tarifs verbraucht. Das API-Budget bezahlt den Rest, zu dem Preis von der Preisseite. Ein Aufruf wird ganz bezahlt oder gar nicht ausgeführt: Reichen die Credits des Tarifs und das API-Budget zusammen nicht, läuft nichts und es wird nichts berechnet. Ein Aufruf läuft nie zum Teil.
Limits je Verbindung und je Token
Eine Verwaltung der Organisation kann für jede MCP-Verbindung (die Anmeldung eines KI-Clients) und jedes API-Token ein Limit an Credits festlegen. Das Limit zählt die Credits des Tarifs und die Credits aus dem API-Budget zusammen, je Abrechnungszeitraum. Erreicht eine Verbindung ihr Limit, wird nur diese Verbindung abgewiesen. Die anderen Verbindungen der Organisation arbeiten weiter. Mit dem nächsten Abrechnungszeitraum beginnt die Zählung neu.
Drei Ablehnungen und was ein Client dann tut
Jede Ablehnung ist ein Werkzeugfehler mit einem festen error_code und einer message. Es lief nichts und es wurde nichts berechnet. Eine Ablehnung bleibt gleich, bis ein Mensch handelt oder der Abrechnungszeitraum endet. Wiederholen Sie sie deshalb nicht in einer Schleife.
Der Wert plan_credits_exhausted für reason ist reserviert. Der Server liefert ihn heute nicht. Ein Client muss einen reason-Wert tolerieren, den er nicht kennt, und ihn wie api_budget_not_available behandeln.
Ein Client oder ein KI-Agent lädt nie von sich aus auf, zahlt nie und ändert nie ein Limit. Er sagt seinem Nutzer, was zu tun ist, und hält an.
Felder in der Antwort
Jede Antwort und jede Ablehnung enthält den Block credits mit metered, cost und credits_remaining. cost zählt die Credits, die der Tarif und das API-Budget zusammen bezahlt haben. credits_remaining sind die verbleibenden Credits des Tarifs und enthalten nie das API-Budget. Eine Organisation, die ein API-Budget hält oder aufladen darf, erhält zusätzlich api_budget mit cents (der Rest in Euro-Cent), rate_cents_per_credit und credits_at_rate (wie viele weitere Credits der Rest bezahlt). Bei jeder anderen Organisation fehlt der Schlüssel.
Preis
Der Preis je Credit aus dem API-Budget steht auf der Preisseite. Diese Seite nennt keinen Preis.
Zur PreisseiteWas der Bestand abdeckt
Datenverarbeitung
Beispiele nach Rechtsgebiet
MCP-Werkzeuge
Jede Werkzeugbeschreibung unten nennt Zweck, Argumente, die möglichen Ablehnungscodes und den Credit-Preis. Was jedes einzelne Antwortfeld bedeutet, steht im Werkzeug-Leitfaden. So zahlt ein Client dafür nicht bei jeder Verbindung.
Zum MCP-Werkzeug-Leitfaden