Retour à l'accueil

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

    Vous donnez le document à votre chat

    Sous forme de texte, de PDF ou de photo, et vous demandez l'explication.

  2. 2

    Votre chat appelle explain_document

    Il envoie à notre serveur le document et la langue souhaitée.

  3. 3

    Nous lisons le document

    Pour un scan ou une photo sans couche de texte, la reconnaissance de texte (OCR) extrait le contenu.

  4. 4

    Nous anonymisons

    Les noms et les adresses sont retirés avant le début de l'analyse.

  5. 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. 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 programme

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

Serveur MCP pour contrats et courriers officiels