Le connecteur CasusLegal dans votre produit

1. Connexion

Serveur MCP standard : se connecte comme n’importe quel autre connecteur dans votre conversation.

Comment obtenir la clé

La clé partenaire se présente sous la forme clp_<nom>_…. Il existe deux méthodes ; l’adresse de connexion et les règles de fonctionnement sont identiques.

• La clé vous est fournie toute prête. C’est ainsi qu’est connectée, par exemple, la plateforme Doczilla : le responsable CasusLegal transmet la clé par un canal sécurisé ; vous la conservez sur votre serveur et l’insérez dans l’en-tête Authorization. Nous renouvelons la clé sur votre demande. L’espace contenant vos statistiques et l’activation des bases reste également accessible : le responsable vous enverra un lien d’invitation.
• Vous générez vous-même la clé. C’est ainsi qu’est connectée, par exemple, une plateforme de Samara : le responsable envoie un lien d’invitation vers l’espace partenaire lk.casus.legal/pcab (identifiant et code à usage unique inclus). Vous indiquez votre adresse e-mail et votre mot de passe, cliquez sur « Générer la clé » et la copiez : la clé ne s’affiche qu’une seule fois ; une clé perdue est régénérée et l’ancienne cesse alors de fonctionner.

La clé donne accès à toutes les bases qui vous sont activées. Conservez-la uniquement sur le serveur et ne la transmettez pas au navigateur de l’utilisateur final.

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"}}}'

La réponse contient — serverInfo.name: "CasusLegal Partner". Ensuite tools/list doit renvoyer neuf outils.

2. En-têtes de requête

X-Partner-User-Id — toute chaîne stable ne permettant pas de révéler l’identité : votre identifiant interne ou son hachage. Il sert au suivi détaillé par utilisateur : il permet de rapprocher nos chiffres des vôtres (nombre d’appels, types d’appels et nombre de personnes étant effectivement parvenues jusqu’au connecteur). Il n’a aucune incidence sur l’accès : le nombre d’utilisateurs n’est pas limité.

3. Outils

Neuf outils, chacun avec un paramètre corpus.

Paramètre corpus

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

4. Réponse reçue

Un objet structuré. Pour le corpus principal, il s’agit de blocs constitutional_context (positions de la Cour constitutionnelle de la Fédération de Russie), vs_guidance (Plénums et revues de la Cour suprême de la Fédération de Russie), latest_practice (arrêts récents des collèges), vas_history (jurisprudence de la Cour suprême d’arbitrage (arbitrazh) de la Fédération de Russie) et results.

Volume

Une recherche représente environ 110 000 caractères, soit près de 40 000 tokens en entrée pour votre modèle. Ce format est délibéré : l’exhaustivité des résultats constitue le produit. Tenez compte de ce volume dans le choix du modèle qui traite la réponse : à ces dimensions, l’écart de coût entre les modèles peut atteindre un facteur douze.

Temps

Une recherche dure environ 30 secondes. Réglez le délai d’expiration de l’appel de l’outil sur au moins 120 secondes ; sinon, vous interromprez des requêtes qui se déroulent normalement.

Liens vers les décisions

Chaque décision comporte un champ url — une page contenant le texte intégral. Transmettez-la telle quelle à l’utilisateur et ne tronquez pas le paramètre ?t=: sans lui, le lien n’est pas valide. Le lien est valable pendant 30 jours. Si vous prévoyez d’intégrer les liens dans les documents du client, dites-le-nous : nous créerons des liens permanents.

Texte intégral

La recherche renvoie les références et les extraits clés ; la décision intégrale est fournie par un appel distinct casuslegal_get_case_details(case_id, corpus). Le paramètre case_id — il s’agit du nombre figurant dans le champ id de la fiche de résultat. La fiche comporte également un champ du même nom case_id, mais celui-ci contient le numéro de l’affaire (chaîne de la forme « 305-ЭС22-11906 ») ; il ne faut pas le transmettre. id n’est valable qu’à l’intérieur de son propre corpus ; il en va de même pour casuslegal_find_similar.

5. Erreurs et charge

Les refus sont renvoyés sous la forme d’une réponse réussie de l’outil comportant le champ error — votre modèle pourra ainsi expliquer la situation à l’utilisateur, au lieu de considérer que le connecteur est défaillant.

401 ne se produit qu’au niveau de la connexion : la clé est incorrecte, révoquée ou arrivée à expiration. Il s’agit d’une erreur de configuration que des répétitions ne permettront pas de corriger.

Charge

Il n’existe aucune limitation du nombre d’utilisateurs, d’appels ou de requêtes simultanées : l’intégration paie chaque requête donnant lieu à un résultat et nous ne limitons pas le volume des demandes.

Tenez compte d’une propriété physique : les recherches simultanées dans le corpus principal se partagent le temps processeur. Quatre recherches parallèles s’achèvent approximativement dans le même délai que quatre recherches séquentielles, et chacune dure plus longtemps qu’une recherche isolée. Le gain de temps vient du parallélisme entre différents corpus : ceux-ci sont desservis par des services distincts. Si vous prévoyez une charge de pointe, prévenez-nous à l’avance : nous ajouterons la capacité nécessaire.

6. Tarification

Chaque requête réussie qui vous renvoie du contenu est facturée : recherche, texte intégral d’une décision, décisions similaires, liste, export et commentaire « Glossa », 3,00 ₽ par requête, le texte intégral d’une décision — 2,00 ₽. Les appels informatifs et techniques sont gratuits.

• Le prix ne dépend pas de la base : les juridictions supérieures, la Cour des droits de propriété intellectuelle, KAS, KUD et les districts de cassation sont tarifés de la même manière ; le préfixe de l’outil est sans incidence.
• Chaque page browse_practice et chaque appel export_cases sont facturés comme une seule requête, indépendamment du nombre de décisions qu’ils contiennent.
• La recherche et la liste couvrant tous les districts à la fois (okrug_search_practice, okrug_find_term, okrug_browse_practice sans paramètre corpus) sont exécutées séparément dans chaque district qui vous est ouvert et comptabilisées comme une requête dans chacun d’eux. Pour ne payer qu’une seule requête, indiquez le district.
• Un appel qui s’achève par une erreur de notre côté n’est pas facturé. Les messages techniques du protocole (initialize, tools/list) ne sont pas considérés comme des appels.
• Si le commentaire « Glossa » est ouvert à votre intégration, sa recherche et sa lecture (glossa_search, glossa_support, glossa_get_point, glossa_get_article, glossa_find_by_act, glossa_find_similar) sont facturées au même prix ; glossa_stats est gratuit.
• Les journées et les périodes de facturation sont calculées selon l’heure de Moscou.

Vous voyez dans l’espace partenaire le nombre d’appels, payants et gratuits, ventilé par outil, base, district et jour, ainsi que le montant à payer lk.casus.legal/pcab. Vous y générez également vous-même la clé et activez ou désactivez les bases qui vous sont ouvertes : une base désactivée renvoie un refus et n’est pas facturée. Votre responsable chez CasusLegal vous envoie le lien de première connexion ; vous définissez vous-même le mot de passe. La période d’essai gratuite y est indiquée séparément : son montant est affiché à titre informatif et n’est pas facturé.

Modalités de règlement

L’espace partenaire est conçu pour fonctionner en libre-service. Lors de votre première connexion, vous définissez un mot de passe, une adresse e-mail pour l’échange de documents et les coordonnées de l’organisation : sans ces informations, l’espace ne s’ouvre pas. Les coordonnées sont immédiatement insérées dans le contrat, les actes et les factures ; le contrat est déjà signé de notre côté (fac-similé). Téléchargez-le dans la section « Documents et règlements », signez-le, puis téléchargez le scan à l’aide du bouton « Télécharger le contrat signé ». Le contrat est également réputé conclu dès le paiement de la première facture. Tous les documents sont conservés dans l’espace et peuvent être téléchargés à tout moment.

• La période de facturation est de 30 jours calendaires. La première période commence le lendemain de la fin de l’essai gratuit (ou à la date indiquée par le responsable), et chaque période suivante commence immédiatement après la précédente. Coût des services pour la période = requêtes payantes × 3,00 ₽ (textes intégraux des actes × 2,00 ₽).
• Les services sont fournis sur la base d’un paiement anticipé. Le premier acompte est déterminé par le responsable de CasusLegal et fait l’objet d’une facture pour la première période.
• Le lendemain de la fin de la période, trois documents apparaissent automatiquement dans l’espace : un acte avec le décompte (services moins acompte moins imputation du trop-perçu), une facture de complément si le montant des services dépasse celui de l’acompte, et une facture d’acompte pour la période suivante — correspondant à 80 % du coût des services de la période écoulée, arrondi au rouble près. Ces mêmes documents sont également envoyés à votre adresse e-mail. Le trop-perçu n’est pas remboursé, mais imputé sur la période suivante.
• Les factures sont payées par virement bancaire dans les 3 jours ouvrables suivant la fin de la période. Après le paiement, cliquez sur « Signaler le paiement » à côté de la facture et joignez l’ordre de paiement. Téléchargez l’acte signé dans la ligne correspondant à la période.
• Si la facture n’est pas payée à l’échéance et que le justificatif de paiement n’a pas été téléchargé, l’accès par clé est automatiquement suspendu ; le téléchargement du justificatif rétablit immédiatement l’accès, dans l’attente de la vérification. Si le paiement n’est pas confirmé, le responsable vous écrira dans la section « Messages » de l’espace, et l’accès sera de nouveau suspendu jusqu’à réception du paiement.
• Le solde du paiement anticipé (acompte, imputation, montant dépensé depuis le début de la période) est visible en temps réel dans l’espace. Non assujetti à la TVA (entrepreneur individuel sous régime fiscal simplifié).

7. Liste de contrôle avant le lancement

• Transport — HTTP streamable, et non SSE.
• tools/list renvoie neuf outils.
• Le délai d’attente pour l’appel d’un outil est d’au moins 120 secondes.
• En-tête X-Partner-User-Id est renseigné à chaque appel.
• corpus est sélectionné en fonction du thème de la question, un corpus par requête.
• Liens url parviennent intégralement à l’utilisateur, avec ?t=.
• Le modèle chargé de traiter les résultats a été sélectionné en tenant compte de 40 000 tokens par recherche.
• Champ error est traité dans la réponse de l’outil et affiché à l’utilisateur.