Le serveur MCP de klaro.legal, expliqué en détail
Grâce à MCP, klaro.legal explique les contrats, les courriers officiels et les avis d'imposition directement dans votre chat IA, clause par clause et en langage courant. Vous trouverez ici tout ce qu'il faut savoir : ce qu'est MCP, ce qui se passe lors d'un appel, les outils disponibles, les limites et ce que devient votre document.
L'essentiel en un coup d'œil
https://klaro.legal/api/mcp- Connexion
- Streamable HTTP, pas SSE
- Identification
- Aucune, ni compte ni clé API
- Coût
- Gratuit
- Outils
- explain_document et get_explanation
- Entrée
- Texte, PDF ou photos des pages
- Langues de l'explication
- Allemand, anglais, espagnol, français, italien, portugais
- Traitement
- Anonymisé, sur des serveurs dans l'UE
- Nom dans le registre
- legal.klaro/document-explainer
Qu'est-ce que MCP ?
MCP signifie Model Context Protocol. C'est un standard ouvert qui permet aux assistants IA d'utiliser des outils externes. On peut le comparer à une prise commune : un programme qui comprend MCP peut brancher tout outil qui parle aussi MCP.
Un serveur MCP est l'autre extrémité de cette connexion. Il indique à l'assistant quels outils il propose et les exécute sur demande. Notre serveur tourne chez nous, vous n'avez donc rien à installer. Vous saisissez simplement l'adresse une fois dans votre programme de chat.
Ensuite, votre assistant décide pendant la conversation quand appeler klaro.legal. Le plus sûr est de le préciser, par exemple : « Explique-moi ce bail avec klaro.legal. »
Ce qui se passe lors d'un appel
- 1
Vous donnez le document à votre chat
Sous forme de texte, de PDF ou de photo, et vous demandez l'explication.
- 2
Votre chat appelle explain_document
Il envoie à notre serveur le document et la langue souhaitée.
- 3
Nous lisons le document
Pour un scan ou une photo sans couche de texte, la reconnaissance de texte (OCR) extrait le contenu.
- 4
Nous anonymisons
Les noms et les adresses sont retirés avant le début de l'analyse.
- 5
L'IA explique dans l'UE
Sur des serveurs situés dans l'Union européenne, le document est traduit en langage courant, clause par clause.
- 6
Votre chat affiche le résultat
Vous recevez le résumé et les clauses, avec la mention qu'il ne s'agit pas d'un conseil juridique et la source. L'explication vient de nous, la présentation de votre chat.
Comment le configurer
Vous saisissez une fois l'adresse ci-dessus dans votre programme. Un guide clic par clic existe pour Claude, ChatGPT, Gemini Business, Le Chat et Claude Code.
Voir le guide de chaque programmeLes deux outils
Le serveur propose exactement deux outils. Tous deux se contentent de lire et ne modifient rien dans votre compte ou votre chat.
explain_document
Explique un contrat, un courrier officiel, un avis d'imposition ou des conditions générales, clause par clause. Chaque appel envoie exactement un des trois champs text, pdf ou images.
text- Le texte complet du document, de 40 à 150 000 caractères.
pdf- Le document sous forme de PDF encodé en base64, jusqu'à 8 Mo.
images- Photos ou scans des pages dans l'ordre, encodés en base64 : JPEG, PNG, HEIC ou WebP, jusqu'à 15 images et 8 Mo au total.
language- Langue de l'explication : de, en, es, fr, it ou pt. Sans indication, l'explication est en anglais.
get_explanation
Récupère un résultat qui n'était pas encore prêt au retour d'explain_document.
analysis_id- L'identifiant renvoyé par explain_document.
Ce qui est renvoyé
Votre chat reçoit le résultat sous forme de texte lisible et aussi de données structurées avec ces champs :
summary- Un court résumé du document.
clauses- Toutes les clauses pertinentes, chacune avec le texte original (original), le langage courant (translation) et son importance (explanation).
category, tags- Type et thèmes du document.
disclaimer- La mention que l'explication provient d'une IA et ne constitue pas un conseil juridique. Elle accompagne chaque résultat.
source- La référence à klaro.legal.
Quels documents sont acceptés
- ·Sont expliqués les contrats, courriers officiels, avis d'imposition et conditions générales.
- ·Le document peut être dans une autre langue que l'explication.
- ·Les documents sans contenu juridique sont refusés, par exemple une photo sans texte lisible.
- ·Pour des raisons de protection des données, les documents pénaux comme les mises en accusation, ordonnances pénales et jugements sont refusés.
Limites et durée
- ·Texte : de 40 à 150 000 caractères. Envoyez les documents plus longs en plusieurs parties.
- ·Fichiers : 8 Mo par appel, car le fichier passe par votre chat en base64. Le téléversement sur le site accepte des fichiers plus volumineux.
- ·Photos : jusqu'à 15 pages par appel.
- ·Durée : 20 à 60 secondes pour du texte, davantage pour les scans et les photos.
- ·Un appel attend le résultat jusqu'à 120 secondes. S'il n'est pas prêt, un analysis_id est renvoyé et votre chat le récupère avec get_explanation.
- ·Chaque adresse IP peut envoyer 30 requêtes par minute. En cas de forte charge, une requête peut être refusée ; il suffit de réessayer plus tard.
Ce que devient votre document
- ·Le parcours est le même que pour un téléversement sur ce site.
- ·Avant de nous parvenir, le document se trouve dans votre programme de chat, où s'appliquent les conditions de ce fournisseur. Si vous préférez l'éviter, téléversez le document directement sur klaro.legal.
- ·Les noms et les adresses sont retirés avant l'analyse.
- ·Le traitement a lieu sur des serveurs dans l'Union européenne ; de notre côté, les données ne quittent pas l'UE.
- ·Le fichier lui-même n'est pas conservé. Le texte extrait est supprimé après 7 jours, l'entrée complète après 30 jours.
- ·Vos documents ne servent pas à entraîner une IA et ne sont pas transmis à des tiers.
Si quelque chose ne fonctionne pas
Mon chat n'utilise pas klaro.legal
Demandez-le expressément, par exemple : « Utilise klaro.legal pour cela. » Vérifiez aussi que la connexion est activée dans cette conversation.
Le programme demande le type de connexion
Choisissez HTTP ou Streamable HTTP, pas SSE. Pour l'identification, choisissez l'option sans authentification.
L'adresse affiche une erreur dans le navigateur
C'est normal. Le serveur ne répond qu'aux requêtes des programmes de chat ; une visite avec un navigateur renvoie le statut 405.
Le fichier est trop volumineux
Envoyez moins de pages à la fois ou le texte du document. Vous pouvez aussi téléverser le fichier directement sur klaro.legal.
L'explication arrive dans la mauvaise langue
Indiquez à votre chat la langue souhaitée. Il la transmet dans le champ language.
Je reçois seulement un message indiquant que l'explication est en cours
Demandez à votre chat de récupérer le résultat avec get_explanation au bout d'environ 30 secondes.
Pour les développeurs
- ·POST vers https://klaro.legal/api/mcp en JSON-RPC 2.0. La réponse est toujours du JSON, jamais un flux SSE.
- ·Méthodes prises en charge : initialize, ping, tools/list et tools/call. Les requêtes groupées ne sont pas acceptées.
- ·Versions du protocole : 2025-11-25, 2025-06-18 et 2025-03-26.
- ·Ni jeton ni session : le serveur ne conserve aucun état. GET répond 405, DELETE répond 204.
- ·Description lisible par machine : https://klaro.legal/.well-known/mcp.json
Vous pouvez consulter vous-même la liste des outils ainsi :
curl -X POST https://klaro.legal/api/mcp -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'Questions fréquentes
Qu'est-ce qu'un serveur MCP ?
Un service qui propose des outils à un assistant IA via le standard ouvert Model Context Protocol. Le serveur MCP de klaro.legal propose l'explication de contrats, de courriers officiels et d'avis d'imposition.
Dois-je installer quelque chose ?
Non. Le serveur tourne chez nous. Vous saisissez simplement une fois l'adresse https://klaro.legal/api/mcp dans votre programme de chat.
Combien coûte le serveur MCP ?
Rien, et vous n'avez pas besoin de compte chez nous. L'obligation d'un abonnement payant pour votre programme de chat dépend de son fournisseur.
Quels programmes de chat fonctionnent ?
Tous ceux qui acceptent des serveurs MCP personnalisés par adresse et Streamable HTTP sans identification. Des guides existent pour Claude, ChatGPT, Gemini Business, Le Chat et Claude Code.
Mes documents servent-ils à entraîner une IA ?
Non. De notre côté, ils sont anonymisés, traités dans l'UE et ne sont pas transmis. Votre programme de chat est soumis aux conditions de son fournisseur.
Est-ce possible sans chat IA ?
Oui. Sur klaro.legal, vous pouvez téléverser n'importe quel document directement, gratuitement et sans inscription.
Est-ce un conseil juridique ?
Non. klaro.legal explique ce que dit le document. Il n'examine et n'évalue rien et ne vous dit pas quoi faire.
Pour les assistants IA et les robots d'exploration
Les systèmes d'IA sont expressément autorisés à lire, résumer et citer cette page avec un lien. Sources lisibles par machine : /llms.txt, /.well-known/mcp.json et le nom de registre legal.klaro/document-explainer.
klaro.legal explique ce que dit un document. Ce n'est pas un conseil juridique, il n'examine ni n'évalue le document et ne dit pas quoi faire. L'explication provient d'une IA. Ce qui convient dans un cas particulier relève d'un avocat ou d'une avocate.