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 gilt

Unterstü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.

Claude Code
Funktioniert heuteJeder Tarif. Server über die CLI oder eine projektweite .mcp.json hinzufügen.
Cursor
Funktioniert heuteJeder Tarif. Server in ~/.cursor/mcp.json eintragen.
VS Code / Windsurf
Funktioniert heuteJeder Tarif. Beide unterstützen eigene Header für entfernte MCP-Server.
ChatGPT
Funktioniert heute, per OAuthDie App aus dem ChatGPT-Verzeichnis funktioniert in jedem Tarif, auch im kostenlosen. Bei Business und Enterprise gibt gegebenenfalls zuerst ein Administrator klaracase für den Arbeitsbereich frei. Eine eigene App können nur bezahlte Tarife hinzufügen.Anleitung für ChatGPT
Claude
Funktioniert heute, per OAuthDer Connector aus dem Claude-Verzeichnis funktioniert in jedem Tarif, auch im kostenlosen. Bei Team und Enterprise gibt gegebenenfalls zuerst ein Owner klaracase für die Organisation frei. Auch einen eigenen Connector können laut Anthropic alle Tarife hinzufügen, Free-Konten einen.Anleitung für Claude
Claude Desktop
Per OAuth, in ErprobungClaude Desktop unterstützt Connectors. Laut Anthropic richten Sie sie über Ihr Claude-Konto ein, nicht in einer Konfigurationsdatei. Ein Token brauchen Sie dafür nicht.Anleitung für Claude

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

API-Token erstellen
Für Clients, die einen eigenen Authorization-Header zulassen. Sie erstellen und widerrufen Ihre Token selbst in den Kontoeinstellungen. Ein Token wird nur einmal angezeigt. Bewahren Sie es wie ein Passwort auf. Wer über OAuth verbindet, braucht kein Token.
API-Token in den Einstellungen öffnen

Zum Öffnen dieser Seite müssen Sie angemeldet sein. Aufrufe werden dem Guthaben Ihrer Organisation belastet.

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.

Chat-Client ohne Token verbinden (OAuth)
Für ChatGPT und Claude. Sie brauchen weder Terminal noch Token, nur die Server-Adresse https://klaracase.de/mcp.
  1. Im Client einen eigenen Connector anlegen und die Server-Adresse einfügen. Client-ID und Geheimnis bleiben leer.
  2. Es öffnet sich die Anmeldung bei klaracase, danach eine Seite, auf der Sie den Zugriff bestätigen.
  3. Nach der Bestätigung führt der Client Sie zurück und listet die klaracase-Werkzeuge auf.

Aufrufe über diesen Weg werden dem Guthaben Ihrer Organisation belastet, genau wie Aufrufe mit einem Token.

Hinweis: Manchmal schlägt der erste Versuch fehl: Der Browser zeigt nach Ihrer Bestätigung eine Fehlerseite des Chat-Anbieters und der Connector bleibt getrennt. Das liegt an der Rückleitung beim Anbieter, nicht an klaracase: Ihre Anmeldung und Ihre Bestätigung sind bei uns bereits angekommen. Legen Sie den Connector noch einmal an. Hilft das nicht, versuchen Sie es in einem Browserfenster ohne Erweiterungen (privates Fenster). Passwort-Manager und ähnliche Erweiterungen stören die Rückleitung gelegentlich.

Claude Code (CLI)
Fügen Sie den Server mit einem benutzerdefinierten Authorization-Header hinzu.
claude mcp add --transport http klaracase https://klaracase.de/mcp \
  --header "Authorization: Bearer YOUR_TOKEN_HERE"
Claude Code (.mcp.json)
Oder committen Sie eine projektbezogene .mcp.json im Wurzelverzeichnis Ihres Repos.
{
  "mcpServers": {
    "klaracase": {
      "type": "http",
      "url": "https://klaracase.de/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN_HERE"
      }
    }
  }
}
Cursor
In ~/.cursor/mcp.json eintragen.
{
  "mcpServers": {
    "klaracase": {
      "url": "https://klaracase.de/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN_HERE"
      }
    }
  }
}
mcp-remote (stdio-Brücke)
Für Clients, die nur stdio sprechen, überbrücken Sie den Remote-Server mit mcp-remote. Claude Desktop braucht diese Brücke nicht: Es nutzt den Connector aus Ihrem Claude-Konto.
{
  "mcpServers": {
    "klaracase": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://klaracase.de/mcp",
        "--header",
        "Authorization: Bearer YOUR_TOKEN_HERE"
      ]
    }
  }
}

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.

ClaudeNennen Sie klaracase in Ihrer Frage. In den meisten Chats wählt Claude den Connector von selbst. Fehlt einer Antwort die Quelle, schreiben Sie etwa: „Nutze klaracase.“
ChatGPTTippen Sie @klaracase ins Eingabefeld und wählen Sie die App aus der Liste. Das gilt für die App aus dem ChatGPT-Verzeichnis und für selbst hinzugefügte Apps.

Warum das wichtig ist

Jedes Aktenzeichen von klaracase steht mit Quelle im Bestand. Stammt ein Aktenzeichen nicht von klaracase, fehlt ihm dort die Quelle. Ruft der Assistent klaracase auf, erhalten Sie Entscheidungen, die Sie öffnen, zitieren und prüfen können.

Drei Tipps

  • Rufen Sie klaracase gezielt auf, wie oben beschrieben.
  • Bitten Sie um Quellen: „mit Fundstellen“.
  • Nennt eine Antwort eine Entscheidung ohne Link, lassen Sie sie mit klaracase prüfen. Für einen ganzen Text bitten Sie darum, die Fundstellen zu prüfen.
  • Für Entwickler: Einen ganzen Text prüft der Assistent mit dem Tool check_citations.

Fehlerbehebung

Nach der Bestätigung erscheint eine Fehlerseite des Chat-Anbieters, und der Connector ist nicht verbundenLegen Sie den Connector erneut an. In aller Regel klappt der zweite Versuch. Der Abbruch passiert erst nach unserem Teil: Anmeldung und Bestätigung sind bereits erfolgt, nur die Rückleitung zum Chat-Anbieter ist fehlgeschlagen, sodass dieser den Zugang nie abgeholt hat. Bleibt es dabei, öffnen Sie den Chat-Anbieter in einem privaten Fenster ohne Erweiterungen. Es entstehen keine Kosten und es bleibt kein halb verbundener Zugang zurück.
Der Client kann sich nicht verbinden oder zeigt den Server als verbunden, listet aber keine WerkzeugeDas Token fehlt, ist vertippt oder wurde widerrufen. Prüfen Sie, ob der Authorization-Header „Bearer “ und danach das vollständige Token enthält (einschließlich des Teils vor dem „|“). Erstellen Sie im Zweifel ein neues Token in den Einstellungen.
Ein Aufruf liefert eine Fehlermeldung statt ErgebnissenFehler werden als Fehler gemeldet, nie als leeres Ergebnis. Eine Fehlermeldung bedeutet: Auf unserer Seite ist etwas schiefgelaufen. Sie bedeutet nicht, dass nichts gefunden wurde. Wiederholen Sie den Aufruf. Schicken Sie uns bei anhaltendem Fehler den Wortlaut der Meldung.
Die Antwort meldet zu wenig GuthabenDer Aufruf wurde nicht ausgeführt und nichts berechnet. Die Meldung nennt die Kosten und Ihren Kontostand. Das Kontingent eines bezahlten Tarifs erneuert sich monatlich, die einmaligen Credits von Free nicht. Die Nutzung ist in der Anwendung einsehbar.
Der Client bricht ab, bevor eine Antwort ankommtEine lange Recherche kann das Zeitlimit des Chat-Clients überschreiten. Stellen Sie die Frage enger (etwa mit Gericht oder Zeitraum), damit weniger abgerufen werden muss.
Es gibt keine Möglichkeit, einen eigenen Connector hinzuzufügenIhr Tarif oder Ihr Client bietet keine eigenen MCP-Connectors an. Prüfen Sie die Tabelle oben und verwenden Sie einen der unterstützten Clients.

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 aufladen

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

error_code: insufficient_credits, reason: api_budget_emptyDie Organisation darf ein API-Budget aufladen, und was es enthält, deckt diesen Aufruf nicht. Der Client hält an und sagt seinem Nutzer, dass eine Verwaltung der Organisation das API-Budget in der klaracase Web-App aufladen muss. Die Ablehnung enthält keinen Link.
error_code: insufficient_credits, reason: api_budget_not_availableDie Organisation hat kein API-Budget, das den Aufruf bezahlen kann: ihr Tarif hat keines, oder das Budget ruht. Der Client hält an und sagt es seinem Nutzer. Der Aufruf kann wieder laufen, wenn der nächste Abrechnungszeitraum beginnt, wenn eine Verwaltung der Organisation den Tarif geändert hat oder wenn klaracase die offene Zahlungsfrage mit der Organisation geklärt hat.
error_code: token_limit_reachedDie Verbindung oder das Token hat ihr Limit an Credits erreicht. Die Ablehnung enthält cap, spent und resets_at. Der Client hält an und sagt seinem Nutzer, dass eine Verwaltung der Organisation das Limit ändern muss, oder er wartet bis resets_at. Andere Verbindungen arbeiten weiter.

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 Preisseite

Was der Bestand abdeckt

Der Bestand umfasst Entscheidungen und Gesetze des Bundes sowie EU-Rechtsakte. Er ist nicht vollständig. Die Abdeckung unterscheidet sich nach Gericht und Jahr. Eine Fundstelle, die wir nicht auflösen können, ist eine Aussage über unsere Abdeckung, kein Urteil über das Zitat.

Ansehen, was der Bestand enthält

Datenverarbeitung

Die Tools verarbeiten Ihre Anfragen auf unserem Server in Deutschland. Bei einer Suche nach Inhalten erhalten externe KI-Dienste den Text einer Suchanfrage und verarbeiten ihn in der EU. Bei cross_type_search kann die Gesetzes-Sektion die Anfrage zusätzlich an ein Sprachmodell in der EU senden. Deaktivieren Sie das mit bridge: false. check_citations prüft Texte ohne KI-Dienste. Die Anbieter nennt die Seite Datenschutz und Sicherheit.

Datenschutz und Sicherheit

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