Server MCP

Colleghi un assistente IA a Certivant tramite il Model Context Protocol — smisti la coda delle verifiche, invii e monitori i moduli, sollecitare i richiedenti fermi, spieghi le decisioni e generi report, tutto con la Sua chiave API esistente.

Il server MCP di Certivant espone la piattaforma di verifica agli assistenti IA tramite il Model Context Protocol. Punti un host compatibile — Claude Desktop, Claude Code, Cursor, VS Code, OpenAI Codex, Gemini o Mistral — verso di esso, e l'assistente potrà lavorare sulla Sua coda: vedere cosa richiede attenzione questa mattina, inviare un modulo di verifica a un cliente indicato e monitorare se ha risposto, sollecitare chi è diventato silenzioso, spiegare perché una pratica è stata rifiutata ed estrarre i numeri di conformità del mese.

Il server MCP è un client della stessa API REST /api/v1/kyc che Lei già usa. Non ha una connessione al database e non introduce un secondo modello di permessi: l'organizzazione della Sua chiave API, gli ambiti e il limite di frequenza sono esattamente ciò che ottiene l'assistente.

In sintesi


Trasporto	Streamable HTTP — `POST /mcp`
Porta predefinita	`3007` (`MCP_PORT`)
API a monte	`CERTIVANT_API_BASE_URL`, predefinito `http://localhost:3005`
Autenticazione	`Authorization: Bearer kyk_…` — una chiave API Certivant esistente
Controllo dello stato	`GET /health` (senza autenticazione, riporta solo questo processo)
Catalogo	26 strumenti · 4 risorse · 5 prompt

I compiti che svolge

Affrontare la giornata — una sola chiamata restituisce l'intera situazione della coda: cosa è stato inoltrato, cosa è fermo, quali controlli sulle sanzioni sono falliti, quali inoltri hanno superato il termine di revisione (SLA).

Far avanzare il lavoro — avviare una verifica (singola o fino a 50 alla volta), inviare un modulo a un cliente via email, sollecitare chi è fermo, rinnovare un controllo in scadenza.

Capire una decisione — leggere i giudizi sui singoli fattori del motore di scoring, le cause di squalifica e i trigger di revisione, invece di indovinare dal punteggio.

Svolgere ricerche KYB — leggere la scheda aziendale dichiarata e confrontare gli amministratori dichiarati con il registro pubblico.

Fare report — tasso di approvazione, funnel completo, volume per tipo di documento, tassi di fallimento per controllo e un andamento di 30 giorni, senza dati di riga né dati personali.

Il modello di sicurezza in un paragrafo

Per impostazione predefinita le risposte hanno la forma di un verdetto: uno stato, una decisione, un punteggio — mai una data di nascita, un numero di documento o testo OCR grezzo. Tutto ciò che un richiedente ha digitato, o che è stato estratto da un documento caricato, arriva dentro una busta non attendibile etichettata, così il modello lo riporta invece di eseguirlo. Gli strumenti che inviano email a clienti reali sono indicati come non di sola lettura, affinché il Suo host chieda conferma prima di eseguirli, e lo strumento davvero distruttivo lo dichiara. Ulteriori dettagli in Sicurezza e limiti.

Cosa non c'è ancora

Autenticazione. Ogni percorso di installazione su questo sito usa una chiave API come bearer. Un flusso di accesso OAuth 2.1 (Dynamic Client Registration, consenso, token limitati a una sola organizzazione) è implementato anche per le directory dei connettori; i token che emette si comportano esattamente come le chiavi API.

Un limite da conoscere prima di iniziare, perché lo incontrerà:

explain_verification_decision non può spiegare la maggior parte delle verifiche meno recenti. Il ragionamento strutturato del motore di scoring è presente solo per le richieste valutate dopo che è stato registrato; lo strumento riporta reasoningAvailable: false per le altre.

Ogni chiamata di strumento viene registrata nello stesso registro di audit KYC a prova di manomissione (kyc_audit_log) delle azioni umane, tramite l'API REST con la chiave del chiamante.

Avanti

Installazione — configurazione JSON per ciascun host, collegata alla Sua chiave API esistente.

Riferimento degli strumenti — tutti i 26 strumenti raggruppati per compito, con ciò che restituiscono e ciò che non fanno.

Risorse e prompt — il contesto che il modello può recuperare senza costi, e i cinque flussi di lavoro predefiniti.

Sicurezza e limiti — livelli di dati personali, busta non attendibile, rallentamenti e limiti di frequenza.