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. Punta un agente compatibile MCP — Claude Desktop, Claude Code, Cursor o il tuo 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

Self-hosted, funziona già oggi con la tua chiave API. Aggiungi questo alla configurazione del tuo client MCP — Claude Desktop, Claude Code, Cursor o qualsiasi altro agente compatibile MCP:

{"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.

Self-hosted, per ora. Non esiste ancora un endpoint ospitato mcp.crateapi.com — esegui il server tu stesso, un singolo processo Python (python -m einvoicing.mcp_server), che chiama la stessa API di produzione con la tua chiave. Se emergerà una domanda sufficiente per una versione ospitata, la costruiremo; per ora, questo è lo stato onesto delle cose.

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