O servidor MCP do klaro.legal, explicado em detalhe

Através do MCP, o klaro.legal explica contratos, cartas oficiais e notas de liquidação diretamente no seu chat de IA, cláusula a cláusula e em linguagem simples. Aqui encontra tudo: o que é o MCP, o que acontece em cada chamada, que ferramentas existem, quais são os limites e o que acontece ao seu documento.

O essencial num relance

https://klaro.legal/api/mcp

Ligação: Streamable HTTP, não SSE
Início de sessão: Nenhum, sem conta nem chave de API
Custo: Gratuito
Ferramentas: explain_document e get_explanation
Entrada: Texto, PDF ou fotografias das páginas
Línguas da explicação: Alemão, inglês, espanhol, francês, italiano, português
Tratamento: Anonimizado, em servidores na UE
Nome no registo: legal.klaro/document-explainer

O que é o MCP?

MCP significa Model Context Protocol. É uma norma aberta que permite aos assistentes de IA usar ferramentas externas. Pode imaginá-lo como uma tomada comum: um programa que entende MCP pode ligar qualquer ferramenta que também fale MCP.

Um servidor MCP é a outra ponta dessa ligação. Diz ao assistente que ferramentas oferece e executa-as quando pedido. O nosso servidor funciona do nosso lado, por isso não tem de instalar nada. Basta introduzir uma vez o endereço no seu programa de chat.

Depois, o seu assistente decide durante a conversa quando chamar o klaro.legal. O mais seguro é dizê-lo, por exemplo: “Explica-me este contrato de arrendamento com o klaro.legal.”

O que acontece numa chamada

1
Entrega o documento ao seu chat
Como texto, PDF ou fotografia, e pede a explicação.
2
O seu chat chama explain_document
Envia ao nosso servidor o documento e a língua pretendida.
3
Lemos o documento
Num digitalizado ou numa fotografia sem camada de texto, o reconhecimento de texto (OCR) extrai o conteúdo.
4
Anonimizamos
Os nomes e as moradas são removidos antes de a análise começar.
5
A IA explica na UE
Em servidores na União Europeia, o documento é traduzido para linguagem simples, cláusula a cláusula.
6
O seu chat mostra o resultado
Recebe o resumo e as cláusulas, com a nota de que não se trata de aconselhamento jurídico e a fonte. A explicação vem de nós, a apresentação vem do seu chat.

Como configurar

Introduz uma vez no seu programa o endereço acima. Existe um guia clique a clique para Claude, ChatGPT, Gemini Business, Le Chat e Claude Code.

Ver o guia de cada programa

As duas ferramentas

O servidor oferece exatamente duas ferramentas. Ambas apenas leem e não alteram nada na sua conta ou no seu chat.

explain_document

Explica um contrato, uma carta oficial, uma nota de liquidação ou condições gerais, cláusula a cláusula. Cada chamada envia exatamente um dos três campos text, pdf ou images.

text: O texto completo do documento, de 40 a 150 000 caracteres.
pdf: O documento como PDF codificado em base64, até 8 MB.
images: Fotografias ou digitalizações das páginas por ordem, codificadas em base64: JPEG, PNG, HEIC ou WebP, até 15 imagens e 8 MB no total.
language: Língua da explicação: de, en, es, fr, it ou pt. Sem indicação, a explicação é em inglês.

get_explanation

Obtém um resultado que ainda não estava pronto quando explain_document respondeu.

analysis_id: O identificador devolvido por explain_document.

O que é devolvido

O seu chat recebe o resultado como texto legível e também como dados estruturados com estes campos:

summary: Um breve resumo do documento.
clauses: Todas as cláusulas relevantes, cada uma com o texto original (original), a linguagem simples (translation) e a razão da sua importância (explanation).
category, tags: Tipo e temas do documento.
disclaimer: A nota de que a explicação foi gerada por IA e não é aconselhamento jurídico. Acompanha cada resultado.
source: A referência ao klaro.legal.

Que documentos funcionam e quais não

·São explicados contratos, cartas oficiais, notas de liquidação e condições gerais.
·O documento pode estar numa língua diferente da explicação.
·Os documentos sem conteúdo jurídico são recusados, por exemplo uma fotografia sem texto legível.
·Por razões de proteção de dados, são recusados documentos penais como acusações, ordens penais e sentenças.

Limites e duração

·Texto: de 40 a 150 000 caracteres. Documentos mais longos devem ser enviados por partes.
·Ficheiros: 8 MB por chamada, porque o ficheiro passa pelo seu chat em base64. O carregamento no site permite ficheiros maiores.
·Fotografias: até 15 páginas por chamada.
·Duração: 20 a 60 segundos para texto, mais para digitalizações e fotografias.
·Uma chamada espera até 120 segundos pelo resultado. Se não estiver pronto, é devolvido um analysis_id e o seu chat obtém-no com get_explanation.
·Cada endereço IP pode fazer 30 pedidos por minuto. Com muita carga, um pedido pode ser recusado; basta tentar mais tarde.

O que acontece ao seu documento

·O percurso é o mesmo do carregamento neste site.
·Antes de chegar até nós, o documento está no seu programa de chat, onde se aplicam as condições desse fornecedor. Se preferir evitar isso, carregue o documento diretamente em klaro.legal.
·Os nomes e as moradas são removidos antes da análise.
·O tratamento decorre em servidores na União Europeia; do nosso lado, os dados não saem da UE.
·O ficheiro em si não é guardado. O texto extraído é apagado ao fim de 7 dias e o registo completo ao fim de 30 dias.
·Os seus documentos não são usados para treinar IA nem são transmitidos a terceiros.

Se algo não funcionar

O meu chat não usa o klaro.legal

Peça-o expressamente, por exemplo: “Usa o klaro.legal para isto.” Verifique também se a ligação está ativa nesta conversa.

O programa pergunta o tipo de ligação

Escolha HTTP ou Streamable HTTP, não SSE. No início de sessão, escolha a opção sem autenticação.

Ao abrir o endereço no navegador aparece um erro

É normal. O servidor só responde a pedidos de programas de chat; uma visita pelo navegador devolve o estado 405.

O ficheiro é demasiado grande

Envie menos páginas de cada vez ou o texto do documento. Também pode carregar o ficheiro diretamente em klaro.legal.

A explicação vem na língua errada

Diga ao seu chat em que língua a pretende. Ele indica-a no campo language.

Só recebo uma mensagem de que a explicação ainda está em curso

Peça ao seu chat que obtenha o resultado com get_explanation ao fim de cerca de 30 segundos.

Para programadores

·POST para https://klaro.legal/api/mcp com JSON-RPC 2.0. A resposta é sempre JSON, nunca um fluxo SSE.
·Métodos suportados: initialize, ping, tools/list e tools/call. Pedidos em lote não são aceites.
·Versões do protocolo: 2025-11-25, 2025-06-18 e 2025-03-26.
·Sem token nem sessão: o servidor não guarda estado. GET responde 405, DELETE responde 204.
·Descrição legível por máquinas: https://klaro.legal/.well-known/mcp.json

Pode consultar a lista de ferramentas assim:

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

Perguntas frequentes

O que é um servidor MCP?

Um serviço que oferece ferramentas a um assistente de IA através da norma aberta Model Context Protocol. O servidor MCP do klaro.legal oferece a explicação de contratos, cartas oficiais e notas de liquidação.

Tenho de instalar alguma coisa?

Não. O servidor funciona do nosso lado. Basta introduzir uma vez o endereço https://klaro.legal/api/mcp no seu programa de chat.

Quanto custa o servidor MCP?

Nada, e não precisa de conta connosco. Se o seu programa de chat exige um plano pago depende do fornecedor.

Que programas de chat funcionam?

Todos os que aceitam servidores MCP próprios por endereço e Streamable HTTP sem início de sessão. Há guias para Claude, ChatGPT, Gemini Business, Le Chat e Claude Code.

Os meus documentos são usados para treinar IA?

Não. Do nosso lado são anonimizados, tratados na UE e não são transmitidos. Ao seu programa de chat aplicam-se as condições do fornecedor.

Funciona sem um chat de IA?

Sim. Em klaro.legal pode carregar qualquer documento diretamente, gratuitamente e sem registo.

Isto é aconselhamento jurídico?

Não. O klaro.legal explica o que diz o documento. Não analisa nem avalia nada e não lhe diz o que fazer.

Para assistentes de IA e rastreadores

Os sistemas de IA podem expressamente ler, resumir e citar esta página com ligação. Fontes legíveis por máquinas: /llms.txt, /.well-known/mcp.json e o nome de registo legal.klaro/document-explainer.

O klaro.legal explica o que diz um documento. Não é aconselhamento jurídico, não analisa nem avalia o documento e não diz o que fazer. A explicação é gerada por IA. O que é correto em cada caso cabe a um advogado ou advogada decidir.