Was sich geändert hat – und wann
Änderungen am MCP-Server und seinem API-Vertrag, für Entwickler.
Jede Änderung am MCP-Server, die von außen sichtbar ist: neue Felder, geänderte Semantik, Fehlerbehebungen. Die Seite existiert, damit Sie eine Regression von einer beabsichtigten Änderung unterscheiden können, ohne dafür Ihre Testsuite gegen uns laufen zu lassen.
Aktuelle API-Version: 0.93.0
- NeuAPI 0.93.0
Eine Organisation kann die Zwei-Faktor-Anmeldung vorschreiben, auch für ihre API-Tokens
Inhaber und Administratoren können jetzt allen Mitgliedern einer Organisation die Zwei-Faktor-Anmeldung vorschreiben. Ist sie vorgeschrieben und hat der Nutzer des Tokens sie nicht eingerichtet, erhält jeder MCP-Aufruf und jede Anfrage an `/api/v1` mit einem Token für diese Organisation HTTP 403 mit dem Code `two_factor_required`, bevor etwas läuft oder berechnet wird: ein RFC-9457-Problem unter `/api/v1`, `error_code: "two_factor_required"` beim MCP-Server. Es wird nichts widerrufen: Das Token funktioniert wieder, sobald sein Nutzer die Zwei-Faktor-Anmeldung unter Einstellungen, Zwei-Faktor-Authentifizierung einrichtet. Ein neues Token für eine solche Organisation lässt sich nur mit eingerichteter Zwei-Faktor-Anmeldung erstellen. Verzweigt Ihr Client nach Ablehnungscodes, ergänzen Sie einen Zweig für `two_factor_required`.
- NeuAPI 0.92.0
Eine REST-API unter `/api/v1` bietet dieselben Operationen wie die MCP-Tools
Die Klaracase-API hat jetzt eine REST-Schnittstelle unter `/api/v1`, für ein API-Token aus Einstellungen, API-Tokens. Sie bietet dieselben Operationen wie die MCP-Tools, mit denselben Argumenten, Preisen und Antworten: `GET /api/v1/decisions/search` (`search_decisions`), `GET /api/v1/search` (`cross_type_search`), `GET /api/v1/decisions/{id}` (`get_decision`; `{id}` ist eine UUID, ein Aktenzeichen oder ein ECLI), `GET /api/v1/decisions/{id}/citations` (`get_citation_graph`), `POST /api/v1/datapackages` (`assemble_datapackage`), `POST /api/v1/citation-checks` und `GET /api/v1/citation-checks/{run}` (`check_citations`), `POST /api/v1/citation-check-documents` und `GET /api/v1/citation-check-documents/{document}` für eine PDF-, DOCX-, Markdown- oder Textdatei, die eine Prüfung danach über `document_id` benennt, und die kostenlosen `GET /api/v1/corpus/coverage` und `GET /api/v1/corpus/facets/{field}`. Ein Aufruf wird der Organisation berechnet, für die das Token erstellt wurde, und ein über MCP bezahltes Ergebnis ist über REST im selben Monat kostenlos, und umgekehrt. Jeder Endpunkt braucht eine Token-Berechtigung: `search` für die beiden Suchen, `read` für eine Entscheidung, die Abdeckung und die Facetten, `graph`, `datapackage`, und `citation-check` für die Prüfung und den Upload. Ein Token, das erstellt wurde, bevor Tokens eine Organisation nannten, erhält HTTP 409 `token_org_missing`; erstellen Sie ein neues. Jeder Fehler ist ein RFC-9457-Problem (`application/problem+json`), dessen `code` der MCP-`error_code` ist, und jede Antwort trägt den Header `X-Klaracase-Api-Release`. Ein Token darf 60 Aufrufe je Minute senden, und 10 je Minute an die Endpunkte für Datenpaket, Prüfung und Upload.
- GeändertAPI 0.91.0
Ein API-Token kann nur, was es darf, und handelt für die Organisation, für die es erstellt wurde
Ein API-Token trägt jetzt Berechtigungen, und jedes MCP-Tool braucht eine: `search` für `search_decisions`, `cross_type_search`, `list_facets` und `corpus_coverage`, `read` für `get_decision`, `graph` für `get_citation_graph`, `datapackage` für `assemble_datapackage` und `citation-check` für `check_citations`. Ein Token ohne die Berechtigung erhält `error_code: "token_ability_missing"` mit `required_ability`, und nichts läuft oder wird berechnet. Ihre bestehenden Tokens funktionieren weiter: Ein Token aus den Einstellungen trägt alle Berechtigungen. Wenn Sie ein neues Token erstellen, wählen Sie seine Berechtigungen und seine Laufzeit, höchstens 365 Tage; ein abgelaufenes Token erhält HTTP 401. Ein neues Token handelt für die Organisation, die Sie beim Erstellen geöffnet haben, und belastet diese Organisation, auch wenn Sie mehreren angehören; verlassen Sie sie, funktioniert das Token nicht mehr und erhält HTTP 403 mit `error_code: "token_org_membership_lost"`.
- NeuAPI 0.90.0
Ein abgeschlossener Citation Check lädt seinen Zitationsgraphen als JSON oder Markdown herunter
Der Citation Check in der Web-App bietet den Zitationsgraphen einer abgeschlossenen Prüfung jetzt als Datei an, als JSON oder als Markdown zum Einfügen in eine KI-Sitzung: jede Entscheidung, die das Dokument zitiert und die wir führen, mit den Entscheidungen, die sie zitiert, und denen, die sie zitieren (je Richtung bis zu 25), und die Normen, die die Prüfung bestätigt hat. Tiefe 2 nimmt die Zitate dieser Entscheidungen hinzu, höchstens 50 Entscheidungen je zitierter Entscheidung; tiefer geht es nicht. Der Download kostet 2 Credits je zitierter Entscheidung, die wir führen, höchstens 50 je Datei, und Normen sind kostenlos. Bevor etwas berechnet wird, zeigt die Seite den Preis und Ihr Guthaben. Das zweite Format und jeder weitere Download derselben Prüfung in derselben Tiefe sind für den Rest des Monats kostenlos. Eine Prüfung, deren Ergebnisse nach 90 Tagen gelöscht wurden, lässt sich nicht exportieren. Die Datei enthält nie den Text Ihres Dokuments.
- BehobenAPI 0.90.0
Eine fehlgeschlagene Prüfung läuft wieder, wenn Sie dasselbe Dokument erneut senden
Scheiterte eine Prüfung im Citation Check der Web-App bei uns, lieferte ein erneutes Senden desselben Textes oder ein erneutes Hochladen desselben Dokuments im selben Monat die fehlgeschlagene Prüfung zurück, berechnete nichts und prüfte nicht, sodass sich das Dokument bis zum Monatsende nicht prüfen ließ. Ein solches erneutes Senden startet jetzt eine neue Prüfung und wird wie eine erste Prüfung berechnet; die fehlgeschlagene Prüfung bleibt erstattet. Dieselbe Korrektur gilt für eine KI, die Zitate über unsere MCP-Werkzeuge prüft. Eine abgeschlossene oder abgelehnte Prüfung desselben Textes wird weiterhin kostenlos zurückgegeben.
- GeändertAPI 0.89.0
Das Verweisnetz behält seine Summen und liefert keine internen Zähler mehr; Links für Agenten öffnen ohne Anmeldung
`get_citation_graph` und `assemble_datapackage` liefern ihre internen Zusammenführungszähler und die Abdeckungsmarkierung je Verweis nicht mehr an Kunden-Tokens; die Summen, die ausgelieferten Verweise, `resolution_status` je Verweis und die Verweiszahlen in `edge_accounting` bleiben. `check_citations` liefert den Block `provenance` nicht mehr. `changelog_url` zeigt jetzt auf ein Changelog in Markdown, und der Werkzeugleitfaden, den jede Beschreibung nennt, öffnet ohne die Anmeldung vor dem Start. `check_citations` verweist längere Dokumente und kostenlose Nachprüfungen an den Citation Check in der Web-App. Die mengenbegrenzten Werkzeuge nennen die Ablehnung `volume_cap` in ihren Beschreibungen.
- GeändertAPI 0.88.0
Suchtreffer zeigen eine Relevanzstufe statt roher Werte
Jeder Treffer von `search_decisions`, `cross_type_search` und der Suche in der Web-App trägt jetzt `confidence`: `high`, `medium` oder `low`; null heißt „nicht gemessen“, nie „niedrig“, und die Antwort nennt mit `top_confidence` die Stufe des besten Treffers. Rohe Werte, Index-Kennungen und Details der Trefferermittlung gehen nicht mehr an Kunden-Tokens. Bestandsweite Zahlen (`total_available`, `corpus_matches`, Facettenzahlen) kommen als Untergrenzen-Stufe `{value, is_floor}`. Hat Ihr Client nach einem rohen Wert sortiert oder gefiltert, nutzen Sie stattdessen die Reihenfolge und `confidence`.
- GeändertAPI 0.87.0
`search_decisions` blättert bis Seite 10
Das Argument `page` von `search_decisions` reicht jetzt von 1 bis 10 statt bis 50, und `limit` ist auf 20 begrenzt; eine Abbuchung deckt also höchstens 200 Treffer einer Anfrage. Ein `page` über 10 erhält die Prüfmeldung `page must be between 1 and 10.` und wird nicht berechnet; das Eingabeschema nennt `minimum: 1` und `maximum: 10`. Brauchen Sie mehr Treffer, grenzen Sie die Anfrage mit Filtern ein, etwa `court`, `branch`, `cited_norm` oder einem Zeitraum.
- BehobenAPI 0.86.0
`get_citation_graph` liest das Datum einer Entscheidung in vier weiteren Schreibweisen des zitierenden Texts
Tragen mehrere Entscheidungen das Aktenzeichen einer Fundstelle, verknüpft `get_citation_graph` die Fundstelle mit der Entscheidung, deren Datum der zitierende Text nennt; sonst bleibt der Verweis `unresolved_ambiguous` mit `unresolved_reason: "ambiguous_docket"`. Das Datum wird jetzt auch gelesen aus einer Fundstelle mit eigenem Datum, aus einem im Genitiv genannten Gericht vor dem Datum, aus einem Aktenzeichen in eckigen Klammern und aus einer Aufzählung von Entscheidungen mit Datum und Aktenzeichen. So verknüpfen mehr dieser Verweise die richtige Entscheidung; nennt der Text zwei verschiedene Daten, bleibt die Fundstelle `unresolved_ambiguous`. Verknüpfte Verweise behalten ihre Verknüpfung, `check_citations` ändert sich nicht, und es kommt kein Feld und kein Wert hinzu.
- BehobenAPI 0.86.0
Eine Fundstelle einer anderen Entscheidung des zitierenden Gerichts wird wieder verknüpft
Eine Fundstelle einer anderen Entscheidung desselben Gerichts unter demselben Aktenzeichen konnte als Selbstverweis unverknüpft bleiben, den `get_citation_graph` unter `self_reference` zurückhält, wenn eine gespeicherte Fassung einer der beiden Entscheidungen kein Gericht nannte. Die Gerichtsprüfung liest jetzt alle gespeicherten Fassungen beider Entscheidungen; eine solche Fundstelle verknüpft deshalb wieder die andere Entscheidung und zählt nicht mehr unter `self_reference` in `references_withheld_reasons`. Nennen die Fassungen widersprüchliche Gerichte oder Sitze, bleibt die Fundstelle ein Selbstverweis. `check_citations` ändert sich nicht, und es kommt kein Feld und kein Wert hinzu.
- BehobenAPI 0.85.0
Ein Gerichtsvermerk, dem das Aktenzeichen oder der Text widerspricht, wird nicht mehr geschrieben
Die Gerichtsvermerke, die wir gespeicherten Fundstellen hinzufügen, sind jetzt fehlersicher: Widerspricht das Register des Aktenzeichens, der zitierende Text oder ein Gericht, bei dem ein anderes angesiedelt ist (wie in `bei dem OLG Hamm`), schreiben wir nur die Gerichtsart oder keinen Vermerk. So kann ein falscher Vermerk keinen richtigen Verweis von `get_citation_graph` als `text_court_contradiction` zurückziehen. Der Vermerk selbst wird nicht ausgeliefert, kein ausgelieferter Wert ändert sich mit dieser Version, und es kommt kein Feld und kein Wert hinzu.
- BehobenAPI 0.84.0
Das eigene Aktenzeichen einer Entscheidung verknüpft in `get_citation_graph` keine Entscheidung eines anderen Gerichts mehr
Eine Entscheidung druckt ihr eigenes Aktenzeichen oft im Kopf, und dieses konnte eine Entscheidung eines anderen Gerichts mit demselben Aktenzeichen verknüpfen. Das eigene Aktenzeichen verknüpft eine andere Entscheidung jetzt nur, wo der Text ein Datum oder ein Gericht nennt, das sie auswählt; sonst bleibt die Zeile als Selbstverweis unverknüpft und wird unter `self_reference` zurückgehalten. Der Anfang eines zusammengesetzten Aktenzeichens, etwa `8 KLs` in `8 KLs - 30 Js 29/18 - 14/18`, zählt nur als Aktenzeichen, wenn er eine laufende Nummer und ein Jahr trägt. Gespeicherte Verweise, deren Text der verknüpften Entscheidung widerspricht, werden nach der Version zurückgezogen und bleiben als `in_corpus: false` mit `withheld_reason` `text_court_contradiction` oder `text_date_contradiction` in der Liste.
- BehobenAPI 0.84.0
Ein beim Lesen als falsch erkannter Verweis wird unter einem Grund zurückgezogen, den `get_citation_graph` schon ausliefert
Manche falschen Verweise von `get_citation_graph` zeigen sich erst, wenn ein Mensch den Text liest. Einen solchen Verweis können wir jetzt einzeln zurückziehen: Er bleibt als `in_corpus: false` mit `withheld_reason: "text_court_contradiction"` oder `withheld_reason: "text_date_contradiction"` in der Liste, zählt in `references_withheld_reasons`, und die wöchentliche Neuauflösung verknüpft ihn nicht mehr. Eine Zeile, die die zitierende Entscheidung selbst nennt, verlässt `references` und deren Summen. Es kommt kein Feld und kein Wert hinzu.
- BehobenAPI 0.84.0
Die Korrektur der Dublettenschlüssel behält die Schlüssel, die die Entscheidung selbst nennen
Die in 0.83.0 angekündigte Korrektur der internen Schlüssel, die zwei Kopien einer Entscheidung zusammenführen, behält jetzt einen Schlüssel, den ein Aktenzeichen, Datum oder ECLI der Entscheidung selbst stützt, auch wenn nur eine zweite Veröffentlichung oder die Aktenzeichenliste einer Quelle ihn nennt. Sie entfernt nur Schlüssel, die kein Aktenzeichen der Entscheidung nennen. Die Korrektur ändert kein ausgeliefertes Feld, und es kommt kein Feld und kein Wert hinzu.
- BehobenAPI 0.84.0
Die Anfrageerweiterung versteht `keinen Fernseher`, hält sich aus Jobcenter-Fragen heraus und liest `geringwertige Sachen` nicht mehr als Arbeitsrecht
In `search_decisions` und `cross_type_search` ergänzt `keinen Fernseher` jetzt wie `kein Fernseher` die Begriffe zum Rundfunkbeitrag, und `query_expansion.status` lautet `applied`. Eine Frage zum Fernseher, die das Jobcenter, das Sozialamt oder die Erstausstattung nennt, ist eine sozialrechtliche Frage; sie lautet jetzt `abstained` mit `reason: "entry_blocked"` und ergänzt nichts. `geringwertige Sachen` (§ 248a StGB) ergänzt keine arbeitsrechtlichen Begriffe mehr und lautet `abstained` mit `reason: "no_entry_matched"`, während `Bagatellkündigung` sie weiter ergänzt. Es kommt kein Feld und kein Wert hinzu.
- BehobenAPI 0.83.0
Ein finanzgerichtliches Aktenzeichen mit Steuerart-Kürzeln, etwa `1 K 5671/03 E,F`, bleibt ein Aktenzeichen
Importe aus NRWE, aus den Portalen von Niedersachsen, Bremen und Sachsen und aus den Landesportalen auf juris-Basis schnitten eine solche Liste am Komma, sodass `F` ein eigenes Aktenzeichen wurde. `get_decision` liefert `1 K 5671/03 E,F` jetzt als einen Eintrag von `metadata.file_numbers`, und `joined_proceeding_note` liest `F` nicht mehr als zweites Verfahren. Zwei durch Komma verbundene Aktenzeichen, etwa `2 L 5/20, 2 L 6/20`, bleiben zwei Aktenzeichen. Es kommt kein Feld und kein Wert hinzu.
- BehobenAPI 0.83.0
Ein Datum, das nur im Jahr abweicht, verknüpft keine Entscheidung einer anderen Gerichtsart mehr
In `get_citation_graph` hält ein genanntes Datum, das vom Datum der verknüpften Entscheidung nur im Jahr abweicht, eine Verknüpfung mit einem anderen Gericht nur noch, wenn das genannte Gericht derselben Art ist, etwa ein OLG, das für eine Entscheidung eines anderen OLG genannt wird. Ist das genannte Gericht anderer Art, etwa ein OVG für eine Entscheidung des BVerwG, bleibt der Verweis `unresolved_pending` mit `attributed_court_contradiction`, es sei denn, genau eine Entscheidung unter dem Aktenzeichen stammt von der genannten Gerichtsart; dann verknüpft er diese. `check_citations` ändert sich nicht, und es kommt kein Feld und kein Wert hinzu.
- BehobenAPI 0.82.0
Eine Gesetzesabkürzung mit Zusatz, etwa `StGB-DDR` oder `BGB-E`, gilt nicht mehr als das Gesetz, mit dem sie beginnt
Die Auflösung von Fundstellen liest jetzt die ganze Abkürzung, auch einen Teil nach Bindestrich oder Schrägstrich und ein Schlusskürzel wie `HA`; `StGB-DDR` verweist deshalb nicht mehr auf das StGB des Bundes. `check_citations` beantwortet `§ 212 StGB-DDR` jetzt mit `not_found` und ein Landesgesetz wie `BauGB-AG NRW` mit `not_found` und `evidence.reason: "state_law_out_of_scope"`. Gespeicherte Fundstellen solcher Abkürzungen zählen in `norms_cited_by_decision_results`, im Filter `cited_norm` und in `list_facets` nicht mehr unter dem Bundesgesetz. `a.F.`, Jahreszahlen und SGB-Bücher wie `SGB II` werden wie bisher gelesen, und es kommt kein Feld und kein Wert hinzu.
- BehobenAPI 0.82.0
Die wöchentliche Neuauflösung von `get_citation_graph` findet eine Entscheidung, die nur unter einem zusammengesetzten Aktenzeichen gespeichert ist, wie `check_citations`
Ein wie eingereicht zitiertes Aktenzeichen, etwa `620 KLs 5/11`, findet jetzt auch eine Entscheidung, die nur unter einer zusammengesetzten Schreibweise wie `620 KLs 5/11 - 5650 Js 31/08` gespeichert ist, wenn `get_citation_graph` seine offenen Verweise wöchentlich neu auflöst; ein so gefundener Kandidat eines anderen Gerichts wird als `court_contradiction` abgelehnt. Ein Aktenzeichen, das nur eine ältere Fassung einer Entscheidung nennt, verknüpft diese Entscheidung nicht mehr. Ein neu verknüpfter Verweis zählt in `referenced_by_total` seines Ziels und füllt `target_artifact_id` im `instanzenzug_graph` von `search_decisions`. Vor dieser Version verknüpfte Verweise behalten ihre Verknüpfung, `get_decision` und `check_citations` ändern sich nicht, und es kommt kein Feld und kein Wert hinzu.
- BehobenAPI 0.82.0
Die Entscheidungen, die ein abgeschnittener Aktenzeichen-Schlüssel verdeckte, werden nach dieser Version importiert
Der in 0.81.0 angekündigte Import der Entscheidungen, die ein abgeschnittener Aktenzeichen-Schlüssel verdeckte, verknüpft ihre Fundstellen über die Aktenzeichen-Suche dieser Version und läuft deshalb nach dieser Version. Die Regel aus 0.81.0, dass die Suche Kopien einer Entscheidung aus zwei Quellen als einen Treffer zeigt, bleibt bestehen; sie hat mit jener Version keinen Suchtreffer verschoben. Es kommt kein Feld und kein Wert hinzu.
Die Version ist die nach der Änderung geltende API-Version; Einträge ohne Version haben keinen Wire-Contract verändert (Störungsbehebung, Datenkorrektur). Erfasst ist, was ein Client des MCP-Servers beobachten kann; dies ist keine vollständige Liste aller Deployments.