Server MCP

Dai a Claude, Cursor o a qualsiasi agente IA compatibile con MCP accesso diretto alla fatturazione elettronica — valida, ripara, genera e converti fatture UE direttamente da una conversazione, senza integrazioni separate da scrivere.

Cos'è

CrateAPI offre un server Model Context Protocol (MCP) per l'API di fatturazione elettronica — ospitato da noi, oppure eseguito da voi. Puntate un agente compatibile MCP — Claude Desktop, Claude Code, Cursor o il vostro stesso ciclo di agente — verso di esso, e ottiene quattro strumenti che può chiamare direttamente: validare una fattura, ripararne una, generarne una da dati strutturati o convertire tra sintassi UBL e CII. L'agente legge le descrizioni degli strumenti e decide da solo quando usarli; la logica di fatturazione vera e propria gira sulla stessa API deterministica del resto di CrateAPI.

Strumenti disponibili

Quattro strumenti, un solo processo. Ognuno fa da proxy esattamente alla stessa API pubblica che puoi chiamare via HTTP — stesse regole, stessi limiti, stesse risposte.

validate_invoicegratuito

Verifica un XML di fattura (UBL o CII) rispetto alle regole ufficiali EN 16931, Peppol BIS, XRechnung, RO_CIUS e BR-FR. Restituisce un report strutturato — valida o no, conteggio di errori/avvisi, riscontri. Non serve alcuna chiave API.

repair_invoicerichiede chiave API

Riparazione automatica al meglio: corregge i formati di data non ISO e i totali che non tornano, ricalcolati dalle righe. Non inventa mai dati mancanti — segnala cosa è riuscito a correggere e cosa no.

generate_invoicerichiede chiave API

Costruisce un XML di fattura conforme (UBL o CII) da un modello JSON strutturato di fattura — venditore, acquirente, righe, totali.

convert_invoicerichiede chiave API

Converte una fattura tra sintassi UBL e CII, senza perdite o rifiutata: se qualcosa non può essere convertito in modo pulito, l'operazione fallisce con un motivo chiaro invece di perdere silenziosamente dati.

Come lo esegui

Due modi per connettersi — gli stessi quattro strumenti in entrambi i casi.

Endpoint ospitato

Aggiungete l'URL direttamente alla configurazione del vostro client MCP. Niente da installare, niente da tenere in esecuzione. validate_invoice funziona senza alcuna chiave; gli altri tre leggono l'header X-API-Key.

{"mcpServers": {"crateapi-einvoicing": {
    "type": "http", "url": "https://api.crateapi.com/mcp",
    "headers": {"X-API-Key": "your-key-here"}}}}

I nomi esatti dei campi type/url/headers variano leggermente tra i client MCP (Claude Desktop, Claude Code, Cursor…) — adattateli al vostro. Validare tramite l'endpoint ospitato senza chiave è soggetto a un limite fair-use per IP, identico al validatore gratuito del sito (10/min · 50/giorno · 200/mese); una chiave API valida rimuove il limite e passa alla quota del vostro piano.

Self-hosted

Preferite eseguirlo voi stessi — per privacy, un ambiente isolato (air-gapped) o sviluppo locale? Resta un singolo processo Python, che chiama la stessa API di produzione con la vostra chiave:

{"mcpServers": {"crateapi-einvoicing": {
    "command": "python", "args": ["-m", "einvoicing.mcp_server"],
    "env": {"EINVOICE_API_KEY": "your-key-here"}}}}

validate_invoice non richiede alcuna chiave. Gli altri tre leggono EINVOICE_API_KEY dall'ambiente — ottienine una sulla pagina prezzi. EINVOICE_API_BASE può sovrascrivere l'API di destinazione, utile per puntare a un'istanza locale o di staging.

Sono entrambi reali. L'endpoint ospitato esegue esattamente lo stesso codice degli strumenti del processo self-hosted — stesse regole, stessi limiti, stesse risposte. Usate l'URL ospitato per zero configurazione, o il self-hosted per il pieno controllo locale.

Perché conta

Gli agenti IA sempre più spesso redigono, controllano e depositano documenti aziendali. Se il tuo può chiamare questi strumenti direttamente, può validare una fattura prima che venga inviata, o generarne una conforme su richiesta, invece di sbagliare il formato e scoprirlo giorni dopo con un rifiuto. Il motore dietro gli strumenti è lo stesso che sta dietro al resto di CrateAPI — deterministico, zero LLM a runtime (vedi Trust & Security) — l'agente decide quando chiamare uno strumento, le regole della fattura restano basate su regole, mai indovinate.

Vuoi verificarlo di persona?

Ogni strumento sopra chiama la stessa API che puoi chiamare oggi stesso — leggi il riferimento completo o prova il validatore gratuito con la tua fattura.

Prova il validatore gratuito Leggi la documentazione

Valida la tua fattura elettronica gratisSenza registrazione. Incolla o carica, report immediato.

Apri il validatore →