El servidor MCP de klaro.legal, explicado en detalle

A través de MCP, klaro.legal explica contratos, cartas oficiales y notificaciones de Hacienda directamente en tu chat de IA, cláusula por cláusula y en lenguaje sencillo. Aquí está todo: qué es MCP, qué ocurre en cada llamada, qué herramientas hay, cuáles son los límites y qué pasa con tu documento.

Lo esencial de un vistazo

https://klaro.legal/api/mcp

Conexión: Streamable HTTP, no SSE
Inicio de sesión: Ninguno, sin cuenta ni clave de API
Coste: Gratis
Herramientas: explain_document y get_explanation
Entrada: Texto, PDF o fotos de las páginas
Idiomas de la explicación: Alemán, inglés, español, francés, italiano, portugués
Tratamiento: Anonimizado, en servidores de la UE
Nombre en el registro: legal.klaro/document-explainer

¿Qué es MCP?

MCP significa Model Context Protocol. Es un estándar abierto con el que los asistentes de IA pueden usar herramientas externas. Imagínalo como un enchufe común: un programa que entiende MCP puede conectar cualquier herramienta que también hable MCP.

Un servidor MCP es el otro extremo de esa conexión. Le dice al asistente qué herramientas ofrece y las ejecuta cuando se lo pide. Nuestro servidor funciona en nuestra infraestructura, así que no instalas nada. Solo introduces una vez la dirección en tu programa de chat.

Después, tu asistente decide durante la conversación cuándo llamar a klaro.legal. Lo más seguro es decírselo, por ejemplo: «Explícame este contrato de alquiler con klaro.legal».

Qué ocurre en una llamada

1
Das el documento a tu chat
Como texto, PDF o foto, y pides la explicación.
2
Tu chat llama a explain_document
Envía a nuestro servidor el documento y el idioma que quieres.
3
Leemos el documento
Si es un escaneo o una foto del móvil sin capa de texto, el reconocimiento de texto (OCR) extrae el contenido.
4
Anonimizamos
Los nombres y las direcciones se eliminan antes de empezar el análisis.
5
La IA explica en la UE
En servidores de la Unión Europea, el documento se traduce a lenguaje sencillo cláusula por cláusula.
6
Tu chat muestra el resultado
Recibes el resumen y las cláusulas, junto con el aviso de que no es asesoramiento jurídico y la fuente. La explicación es nuestra, la presentación es de tu chat.

Cómo configurarlo

Introduces una vez en tu programa la dirección de arriba. Hay una guía clic a clic para Claude, ChatGPT, Gemini Business, Le Chat y Claude Code.

Ir a la guía de cada programa

Las dos herramientas

El servidor ofrece exactamente dos herramientas. Ambas solo leen y no cambian nada en tu cuenta ni en tu chat.

explain_document

Explica un contrato, una carta oficial, una notificación de Hacienda o unas condiciones generales, cláusula por cláusula. En cada llamada se envía exactamente uno de los tres campos text, pdf o images.

text: El texto completo del documento, de 40 a 150.000 caracteres.
pdf: El documento como PDF codificado en base64, hasta 8 MB.
images: Fotos o escaneos de las páginas en orden, codificados en base64: JPEG, PNG, HEIC o WebP, hasta 15 imágenes y 8 MB en total.
language: Idioma de la explicación: de, en, es, fr, it o pt. Si no se indica, se explica en inglés.

get_explanation

Recoge un resultado que aún no estaba listo cuando respondió explain_document.

analysis_id: El identificador que devolvió explain_document.

Qué se recibe

Tu chat recibe el resultado como texto legible y además como datos estructurados con estos campos:

summary: Un breve resumen del documento.
clauses: Todas las cláusulas relevantes, cada una con el texto original (original), el lenguaje sencillo (translation) y por qué importa (explanation).
category, tags: Tipo y temas del documento.
disclaimer: El aviso de que la explicación la ha generado una IA y no es asesoramiento jurídico. Acompaña a cada resultado.
source: La referencia a klaro.legal.

Qué documentos funcionan y cuáles no

·Se explican contratos, cartas oficiales, notificaciones de Hacienda y condiciones generales.
·El documento puede estar en un idioma distinto al de la explicación.
·Se rechazan los documentos sin contenido jurídico, por ejemplo una foto sin texto legible.
·Por protección de datos se rechazan los documentos penales, como acusaciones, órdenes penales y sentencias.

Límites y duración

·Texto: de 40 a 150.000 caracteres. Los documentos más largos, por partes.
·Archivos: 8 MB por llamada, porque el archivo pasa por tu chat en base64. Al subirlo en la web se admiten archivos mayores.
·Fotos: hasta 15 páginas por llamada.
·Duración: texto, de 20 a 60 segundos; escaneos y fotos, más.
·Una llamada espera el resultado hasta 120 segundos. Si no está listo, se devuelve un analysis_id y tu chat lo recoge con get_explanation.
·Cada dirección IP puede hacer 30 peticiones por minuto. Con mucha carga una petición puede rechazarse; basta con intentarlo más tarde.

Qué pasa con tu documento

·El recorrido es el mismo que al subirlo en esta web.
·Antes de llegar a nosotros, el documento está en tu programa de chat, y ahí se aplican las condiciones de ese proveedor. Si prefieres evitarlo, sube el documento directamente en klaro.legal.
·Los nombres y las direcciones se eliminan antes del análisis.
·El tratamiento se realiza en servidores de la Unión Europea; por nuestra parte, los datos no salen de la UE.
·El archivo en sí no se guarda. El texto extraído se borra a los 7 días y la entrada completa a los 30 días.
·Tus documentos no se usan para entrenar IA ni se ceden a nadie.

Si algo no funciona

Mi chat no usa klaro.legal

Díselo expresamente, por ejemplo: «Usa klaro.legal para esto». Comprueba también que la conexión esté activada en esa conversación.

El programa pregunta por el tipo de conexión

Elige HTTP o Streamable HTTP, no SSE. En el inicio de sesión, elige la opción sin autenticación.

Al abrir la dirección en el navegador sale un error

Es normal. El servidor solo responde a peticiones de programas de chat; una visita con el navegador devuelve el estado 405.

El archivo es demasiado grande

Envía menos páginas cada vez o el texto del documento. También puedes subir el archivo directamente en klaro.legal.

La explicación llega en otro idioma

Dile a tu chat en qué idioma la quieres. Él lo indicará en el campo language.

Solo aparece un mensaje de que la explicación sigue en curso

Pide a tu chat que recoja el resultado con get_explanation pasados unos 30 segundos.

Para desarrolladores

·POST a https://klaro.legal/api/mcp con JSON-RPC 2.0. La respuesta es siempre JSON, nunca un flujo SSE.
·Métodos admitidos: initialize, ping, tools/list y tools/call. No se aceptan peticiones por lotes.
·Versiones del protocolo: 2025-11-25, 2025-06-18 y 2025-03-26.
·Sin token ni sesión: el servidor no guarda estado. GET responde 405 y DELETE responde 204.
·Descripción legible por máquinas: https://klaro.legal/.well-known/mcp.json

Puedes consultar tú mismo la lista de herramientas así:

curl -X POST https://klaro.legal/api/mcp -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Preguntas frecuentes

¿Qué es un servidor MCP?

Un servicio que ofrece herramientas a un asistente de IA mediante el estándar abierto Model Context Protocol. El servidor MCP de klaro.legal ofrece la explicación de contratos, cartas oficiales y notificaciones de Hacienda.

¿Tengo que instalar algo?

No. El servidor funciona en nuestra infraestructura. Solo introduces una vez la dirección https://klaro.legal/api/mcp en tu programa de chat.

¿Cuánto cuesta el servidor MCP?

Nada, y no necesitas cuenta con nosotros. Que tu programa de chat exija un plan de pago depende de su proveedor.

¿Qué programas de chat funcionan?

Todos los que admiten servidores MCP propios por dirección y Streamable HTTP sin inicio de sesión. Hay guías para Claude, ChatGPT, Gemini Business, Le Chat y Claude Code.

¿Se usan mis documentos para entrenar IA?

No. Por nuestra parte se anonimizan, se tratan en la UE y no se ceden. A tu programa de chat se le aplican las condiciones de su proveedor.

¿Funciona sin un chat de IA?

Sí. En klaro.legal puedes subir cualquier documento directamente, gratis y sin registro.

¿Es asesoramiento jurídico?

No. klaro.legal explica lo que dice el documento. No revisa ni valora nada y no te dice qué hacer.

Para asistentes de IA y rastreadores

Los sistemas de IA pueden leer, resumir y citar esta página con enlace de forma expresa. Fuentes legibles por máquinas: /llms.txt, /.well-known/mcp.json y el nombre de registro legal.klaro/document-explainer.

klaro.legal explica lo que dice un documento. No es asesoramiento jurídico, no revisa ni valora el documento y no dice qué hacer. La explicación la genera una IA. Lo que corresponde en cada caso lo decide un abogado o una abogada.