Der CasusLegal-Konnektor in Ihrem Produkt

1. Verbindung

Standard-MCP-Server: wird wie jeder andere\n Konnektor in Ihrem Chat verbunden.

Schlüssel erhalten

Der Partnerschlüssel sieht wie folgt aus: clp_<имя>_…. Es gibt zwei Möglichkeiten;\n die Verbindungsadresse und die Arbeitsweise sind bei beiden gleich.

• Der Schlüssel wird Ihnen fertig ausgestellt. So ist beispielsweise die Plattform\n Doczilla verbunden: Der CasusLegal-Manager übermittelt den Schlüssel über einen sicheren Kanal; Sie\n speichern ihn auf Ihrem Server und setzen ihn in den Header Authorization. Wir stellen den Schlüssel auf Ihren Antrag neu aus.\n Ein Benutzerkonto mit Ihrer Statistik und der Aktivierung der Datenbanken ist ebenfalls verfügbar:\n Der Manager sendet Ihnen einen Einladungslink.
• Sie stellen den Schlüssel selbst aus. So ist beispielsweise eine Plattform\n aus Samara verbunden: Der Manager sendet einen Einladungslink zum Partnerkonto lk.casus.legal/pcab (Benutzername und Einmalcode sind darin enthalten). Sie\n geben Ihre E-Mail-Adresse und Ihr Passwort ein, klicken auf „Schlüssel ausstellen“ und kopieren ihn:\n Der Schlüssel wird nur einmal angezeigt; ein verlorener Schlüssel wird neu ausgestellt, der vorherige\n funktioniert dann nicht mehr.

Der Schlüssel gewährt Zugang zu allen für Sie aktivierten Datenbanken. Bewahren Sie ihn ausschließlich auf dem\n Server auf und übermitteln Sie ihn nicht an den Browser des Endbenutzers.

curl -sS https://mcp.casus.legal/partner/mcp \
  -H "Authorization: Bearer $CASUS_PARTNER_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{
        "protocolVersion":"2025-06-18","capabilities":{},
        "clientInfo":{"name":"my-platform","version":"1.0"}}}'

In der Antwort steht — serverInfo.name: "CasusLegal Partner". Danach tools/list muss der Client neun Tools zurückgeben.

2. Anfrage-Header

X-Partner-User-Id — jede stabile Zeichenfolge, die keine Rückschlüsse auf die Identität zulässt: Ihre interne Kennung oder deren Hash. Sie wird für die Einzelabrechnung nach Nutzern benötigt: Anhand dieser Kennung werden unsere und Ihre Zahlen abgeglichen (wie viele Aufrufe, welcher Art und wie viele Personen tatsächlich den Connector erreicht haben). Auf den Zugriff hat die Überschrift keinen Einfluss: Die Nutzerzahl ist nicht begrenzt.

3. Tools

Neun Tools, jedes mit einem Parameter corpus.

Parameter corpus

{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{
  "name":"casuslegal_search_practice",
  "arguments":{
    "query":"взыскание неустойки, снижение по статье 333 ГК",
    "corpus":"main",
    "limit":10
  }}}

4. Was als Antwort eingeht

Ein strukturiertes Objekt. Im Hauptkorpus sind dies die Blöcke constitutional_context (Positionen des Verfassungsgerichts der Russischen Föderation), vs_guidance (Plenumsbeschlüsse und Übersichten des Obersten Gerichts der Russischen Föderation), latest_practice (aktuelle Kollegiumsentscheidungen), vas_history (Rechtsprechung des Obersten Schiedsgerichts der Russischen Föderation) und results.

Umfang

Eine Suche umfasst etwa 110.000 Zeichen, also rund 40.000 Tokens als Eingabe für Ihr Modell. Dieses Format ist bewusst gewählt: Die Vollständigkeit der Trefferliste ist das Produkt. Berücksichtigen Sie diesen Umfang bei der Auswahl des Modells, das die Antwort verarbeitet — bei diesen Größenordnungen beträgt der Kostenunterschied zwischen den Modellen bis zu einem Faktor von zwölf.

Zeit

Eine Suche dauert etwa 30 Sekunden. Setzen Sie das Timeout für den Tool-Aufruf auf mindestens 120 Sekunden, andernfalls brechen Sie ordnungsgemäß laufende Anfragen ab.

Links zu Akten

Jeder Akt enthält ein Feld url — eine Seite mit dem vollständigen Text. Übergeben Sie sie dem Nutzer unverändert und kürzen Sie den Parameter ?t=: Ohne ihn ist der Link ungültig. Der Link ist 30 Tage gültig. Wenn Sie die Links in Kundendokumente einbetten möchten, teilen Sie uns dies mit — wir erstellen dauerhafte Links.

Volltext

Die Suche liefert die Metadaten und die wesentlichen Ausschnitte; der vollständige Akt wird durch einen separaten Aufruf abgerufen casuslegal_get_case_details(case_id, corpus). Der Parameter case_id — dies ist die Zahl aus dem Feld id der Trefferkarte. Die Karte enthält außerdem ein gleichnamiges Feld case_id, das jedoch die Geschäftsnummer enthält (eine Zeichenfolge der Form „305-ЭС22-11906“); diese darf nicht übergeben werden. id ist nur innerhalb des jeweiligen Korpus gültig; dasselbe gilt für casuslegal_find_similar.

5. Fehler und Auslastung

Fehlermeldungen werden als erfolgreiche Tool-Antwort mit einem Feld error übermittelt — so kann Ihr Modell dem Nutzer die Situation erklären, anstatt von einem defekten Connector auszugehen.

401 wird nur auf Verbindungsebene zurückgegeben: Der Schlüssel ist falsch, widerrufen oder abgelaufen. Dies ist ein Konfigurationsfehler, der sich nicht durch Wiederholungen beheben lässt.

Auslastung

Die Zahl der Nutzer, Aufrufe und gleichzeitigen Anfragen ist nicht begrenzt: Die Integration bezahlt jede erfolgreiche Anfrage, und wir beschränken das Anfragevolumen nicht.

Beachten Sie jedoch eine physische Gegebenheit: Gleichzeitige Suchen im Hauptkorpus teilen sich die Prozessorzeit. Vier parallele Suchen werden ungefähr in derselben Zeit abgeschlossen wie vier aufeinanderfolgende, wobei jede einzelne länger dauert als eine allein ausgeführte Suche. Zeitgewinn bringt die Parallelisierung über verschiedene Korpora hinweg: Diese werden von separaten Diensten bedient. Wenn Sie eine Spitzenlast planen, informieren Sie uns bitte im Voraus — wir stellen dafür zusätzliche Kapazitäten bereit.

6. Abrechnung

Berechnet wird jede erfolgreiche Anfrage, die Ihnen Inhalte liefert: Suche, vollständiger Akt, ähnliche Akte, Verzeichnis, Export und der Kommentar „Glossa“, 3,00 ₽ pro Anfrage, der vollständige Akt — 2,00 ₽. Referenz- und Dienstaufrufe sind kostenlos.

• Der Preis hängt nicht von der Datenbank ab: Oberste Gerichte, IP Court, KAS, KUD und Kassationsbezirke werden zum gleichen Preis abgerechnet; der Präfix des Tools spielt keine Rolle.
• Jede Seite browse_practice und jeder Aufruf export_cases werden als eine Anfrage abgerechnet, unabhängig von der Zahl der darin enthaltenen Akte.
• Suche und Verzeichnis über alle Bezirke hinweg zugleich (okrug_search_practice, okrug_find_term, okrug_browse_practice ohne Parameter corpus) werden in jedem für Sie freigeschalteten Bezirk einzeln ausgeführt und in jedem dieser Bezirke als Anfrage gezählt. Um nur eine Anfrage zu bezahlen, geben Sie den Bezirk an.
• Ein auf unserer Seite mit einem Fehler beendeter Aufruf wird nicht berechnet. Dienstmeldungen des Protokolls (initialize, tools/list) gelten nicht als Aufrufe.
• Wenn der Kommentar „Glossa“ für Ihre Integration freigeschaltet ist, werden seine Suche und das Lesen (glossa_search, glossa_support, glossa_get_point, glossa_get_article, glossa_find_by_act, glossa_find_similar) zum gleichen Preis abgerechnet; glossa_stats ist kostenlos.
• Tage und Abrechnungszeiträume werden nach Moskauer Zeit berechnet.

Die Zahl der kostenpflichtigen und kostenlosen Aufrufe, aufgeschlüsselt nach Tools, Datenbanken, Bezirken und Tagen, sowie der zu zahlende Betrag werden im Partnerkonto angezeigt lk.casus.legal/pcab. Dort stellen Sie den Schlüssel selbst aus und schalten die für Sie freigeschalteten Datenbanken ein oder aus: Eine deaktivierte Datenbank antwortet mit einer Ablehnung und wird nicht abgerechnet. Den Link für die erste Anmeldung sendet Ihnen Ihr Manager bei CasusLegal; das Passwort legen Sie selbst fest. Der kostenlose Testzeitraum ist dort gesondert gekennzeichnet: Der dafür angezeigte Betrag dient nur zur Information und wird nicht in Rechnung gestellt.

Abrechnungsmodalitäten

Das Partnerkonto ist für die Selbstbedienung ausgelegt. Beim ersten Anmelden legen Sie ein Passwort fest und geben die E-Mail-Adresse für den Dokumentenaustausch sowie die Organisationsdaten ein: ohne diese Angaben wird das Konto nicht freigeschaltet. Die Organisationsdaten werden sofort in den Vertrag, die Abnahmeprotokolle und die Rechnungen übernommen; der Vertrag ist bereits von unserer Seite unterzeichnet (Faksimile). Laden Sie ihn im Bereich „Dokumente und Abrechnungen“ herunter, unterzeichnen Sie ihn und laden Sie den Scan über die Schaltfläche „Unterzeichneten Vertrag hochladen“ hoch. Der Vertrag gilt außerdem mit der Zahlung der ersten Rechnung als geschlossen. Alle Dokumente werden im Konto gespeichert und können jederzeit heruntergeladen werden.

• Der Abrechnungszeitraum beträgt 30 Kalendertage. Der erste Zeitraum beginnt am Tag nach dem Ende des kostenlosen Tests (oder an dem vom Manager genannten Datum), jeder weitere unmittelbar nach dem vorherigen. Kosten der Leistungen für den Zeitraum = kostenpflichtige Anfragen × 3,00 ₽ (vollständige Texte der Abnahmeprotokolle × 2,00 ₽).
• Die Leistungen werden gegen Vorauszahlung erbracht. Die Höhe des ersten Vorschusses legt der Manager von CasusLegal fest und stellt sie für den ersten Zeitraum in Rechnung.
• Am Tag nach Ablauf des Zeitraums erscheinen automatisch drei Dokumente im Konto: ein Abnahmeprotokoll mit der Abrechnung (Leistungen abzüglich Vorschuss abzüglich Verrechnung des Überzahlungsbetrags), eine Rechnung über den Nachzahlungsbetrag, falls die Leistungen den Vorschuss überstiegen haben, und eine Rechnung über den Vorschuss für den nächsten Zeitraum — 80 % der Leistungskosten des abgelaufenen Zeitraums, auf den Rubel gerundet. Dieselben Dokumente werden an Ihre E-Mail-Adresse gesendet. Eine Überzahlung wird nicht zurückerstattet, sondern mit dem nächsten Zeitraum verrechnet.
• Rechnungen sind innerhalb von 3 Werktagen nach Ablauf des Zeitraums per Banküberweisung zu bezahlen. Klicken Sie nach der Zahlung bei der Rechnung auf „Zahlung melden“ und fügen Sie den Zahlungsbeleg bei. Laden Sie das unterzeichnete Abnahmeprotokoll in der Zeile des Zeitraums hoch.
• Wenn die Rechnung zum Fälligkeitstermin nicht bezahlt und kein Zahlungsbeleg hochgeladen wurde, wird der Zugang über den Schlüssel automatisch gesperrt; der hochgeladene Zahlungsbeleg stellt den Zugang sofort und bis zur Prüfung wieder her. Wird die Zahlung nicht bestätigt, schreibt der Manager im Bereich „Nachrichten“ des Kontos, und der Zugang wird bis zum Eingang der Zahlung erneut gesperrt.
• Der verbleibende Vorauszahlungsbetrag (Vorschuss, Verrechnung, seit Beginn des Zeitraums verbraucht) ist im Konto in Echtzeit sichtbar. Es fällt keine Mehrwertsteuer an (Einzelunternehmer im vereinfachten Besteuerungssystem).

7. Checkliste vor dem Start

• Transport — streamable HTTP, nicht SSE.
• tools/list gibt neun Tools zurück.
• Zeitüberschreitung für den Tool-Aufruf — mindestens 120 Sekunden.
• Überschrift X-Partner-User-Id wird bei jedem Aufruf angegeben.
• corpus wird anhand des Themas der Frage ausgewählt, ein Korpus pro Anfrage.
• Links url erreichen den Nutzer vollständig, zusammen mit ?t=.
• Das Modell, das die Ergebnisse verarbeitet, wurde unter Berücksichtigung von 40.000 Token pro Suche ausgewählt.
• Feld error wird in der Tool-Antwort verarbeitet und dem Nutzer angezeigt.