Il server MCP di klaro.legal, spiegato nel dettaglio

Che cos'è MCP?

MCP sta per Model Context Protocol. È uno standard aperto con cui gli assistenti IA possono usare strumenti esterni. Puoi immaginarlo come una presa comune: un programma che capisce MCP può collegare qualsiasi strumento che parla anch'esso MCP.

Un server MCP è l'altro capo di questa connessione. Dice all'assistente quali strumenti offre e li esegue su richiesta. Il nostro server gira da noi, quindi non devi installare nulla. Inserisci solo una volta l'indirizzo nel tuo programma di chat.

Poi è il tuo assistente a decidere durante la conversazione quando chiamare klaro.legal. Il modo più sicuro è dirglielo, per esempio: “Spiegami questo contratto d'affitto con klaro.legal.”

Cosa succede a ogni chiamata

1. 1

   Dai il documento alla tua chat

   Come testo, PDF o foto, e chiedi la spiegazione.

2. 2

   La tua chat chiama explain_document

   Invia al nostro server il documento e la lingua desiderata.

3. 3

   Leggiamo il documento

   Per una scansione o una foto senza livello di testo, il riconoscimento del testo (OCR) estrae il contenuto.

4. 4

   Anonimizziamo

   Nomi e indirizzi vengono rimossi prima che inizi l'analisi.

5. 5

   L'IA spiega nell'UE

   Su server nell'Unione europea, il documento viene tradotto in linguaggio semplice clausola per clausola.

6. 6

   La tua chat mostra il risultato

   Ricevi il riepilogo e le clausole, con l'avviso che non si tratta di consulenza legale e la fonte. La spiegazione viene da noi, la presentazione dalla tua chat.

Come configurarlo

Inserisci una volta nel tuo programma l'indirizzo qui sopra. C'è una guida clic per clic per Claude, ChatGPT, Gemini Business, Le Chat e Claude Code.

I due strumenti

Il server offre esattamente due strumenti. Entrambi si limitano a leggere e non modificano nulla nel tuo account o nella tua chat.

Cosa viene restituito

La tua chat riceve il risultato come testo leggibile e anche come dati strutturati con questi campi:

summary

Un breve riepilogo del documento.

clauses

Tutte le clausole rilevanti, ciascuna con il testo originale (original), il linguaggio semplice (translation) e il motivo per cui conta (explanation).

category, tags

Tipo e temi del documento.

disclaimer

L'avviso che la spiegazione è stata generata da un'IA e non è una consulenza legale. Accompagna ogni risultato.

source

Il riferimento a klaro.legal.

Quali documenti funzionano e quali no

• ·Vengono spiegati contratti, lettere ufficiali, avvisi fiscali e condizioni generali.
• ·Il documento può essere in una lingua diversa da quella della spiegazione.
• ·I documenti senza contenuto giuridico vengono rifiutati, per esempio una foto senza testo leggibile.
• ·Per motivi di protezione dei dati vengono rifiutati i documenti penali come accuse, ordini penali e sentenze.

Limiti e durata

• ·Testo: da 40 a 150.000 caratteri. I documenti più lunghi vanno inviati a parti.
• ·File: 8 MB per chiamata, perché il file passa dalla tua chat in base64. Con il caricamento sul sito sono possibili file più grandi.
• ·Foto: fino a 15 pagine per chiamata.
• ·Durata: da 20 a 60 secondi per il testo, di più per scansioni e foto.
• ·Una chiamata attende il risultato fino a 120 secondi. Se non è pronto, viene restituito un analysis_id e la tua chat lo recupera con get_explanation.
• ·Ogni indirizzo IP può inviare 30 richieste al minuto. Con un carico elevato una richiesta può essere respinta: basta riprovare più tardi.

Cosa succede al tuo documento

• ·Il percorso è lo stesso del caricamento su questo sito.
• ·Prima di arrivare a noi, il documento si trova nel tuo programma di chat, dove valgono le condizioni di quel fornitore. Se preferisci evitarlo, carica il documento direttamente su klaro.legal.
• ·Nomi e indirizzi vengono rimossi prima dell'analisi.
• ·L'elaborazione avviene su server nell'Unione europea; da parte nostra i dati non lasciano l'UE.
• ·Il file in sé non viene conservato. Il testo estratto viene cancellato dopo 7 giorni, la voce completa dopo 30 giorni.
• ·I tuoi documenti non vengono usati per addestrare IA e non vengono ceduti a nessuno.

Se qualcosa non funziona

Per sviluppatori

• ·POST a https://klaro.legal/api/mcp con JSON-RPC 2.0. La risposta è sempre JSON, mai un flusso SSE.
• ·Metodi supportati: initialize, ping, tools/list e tools/call. Le richieste in batch non sono accettate.
• ·Versioni del protocollo: 2025-11-25, 2025-06-18 e 2025-03-26.
• ·Nessun token, nessuna sessione: il server non conserva stato. GET risponde 405, DELETE risponde 204.
• ·Descrizione leggibile dalle macchine: https://klaro.legal/.well-known/mcp.json

Puoi richiedere tu stesso l'elenco degli strumenti così:

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

Domande frequenti

Per assistenti IA e crawler

I sistemi di IA possono espressamente leggere, riassumere e citare questa pagina con un link. Fonti leggibili dalle macchine: /llms.txt, /.well-known/mcp.json e il nome di registro legal.klaro/document-explainer.