Serveur MCP

Connectez un assistant IA à Certivant via le Model Context Protocol — triez la file de vérification, envoyez et suivez des formulaires, relancez les demandeurs inactifs, expliquez les décisions et produisez des rapports, le tout avec votre clé d'API existante.

Le serveur MCP Certivant expose la plateforme de vérification aux assistants IA via le Model Context Protocol. Pointez un hôte compatible — Claude Desktop, Claude Code, Cursor, VS Code, OpenAI Codex, Gemini ou Mistral — vers lui, et l'assistant peut travailler votre file : voir ce qui requiert votre attention ce matin, envoyer un formulaire de vérification à un client désigné et suivre s'il a répondu, relancer les personnes qui ne réagissent plus, expliquer pourquoi un dossier a été rejeté, et extraire les chiffres de conformité du mois.

Le serveur MCP est un client de la même API REST /api/v1/kyc que vous utilisez déjà. Il n'a aucune connexion à une base de données et n'introduit aucun second modèle de permissions : l'organisation, les portées et la limite de débit de votre clé d'API sont exactement ce que reçoit l'assistant.

En bref


Transport	Streamable HTTP — `POST /mcp`
Port par défaut	`3007` (`MCP_PORT`)
API amont	`CERTIVANT_API_BASE_URL`, par défaut `http://localhost:3005`
Authentification	`Authorization: Bearer kyk_…` — une clé d'API Certivant existante
Contrôle de santé	`GET /health` (sans authentification, ne signale que ce processus)
Catalogue	26 outils · 4 ressources · 5 invites

Ce qu'il permet de faire

Traiter la journée — un seul appel renvoie l'instantané complet de la file : ce qui est escaladé, ce qui est bloqué, quels contrôles de sanctions ont échoué, et quelles escalades ont dépassé le délai de révision.

Faire avancer le travail — démarrer une vérification (une seule, ou jusqu'à 50 à la fois), envoyer un formulaire à un client par courriel, relancer quelqu'un qui a cessé de répondre, renouveler un contrôle arrivant à échéance.

Comprendre une décision — lire les verdicts propres à chaque facteur du moteur de score, les causes de disqualification et les déclencheurs de révision, plutôt que de deviner à partir d'un score.

Effectuer des recherches KYB — lire la fiche d'entreprise déclarée et comparer les administrateurs déclarés avec le registre public.

Produire des rapports — taux d'approbation, entonnoir complet, volume par type de document, taux d'échec par contrôle et tendance sur 30 jours, sans données de lignes ni données personnelles.

Le modèle de sécurité en un paragraphe

Les réponses ont une forme de verdict par défaut : un statut, une décision, un score — jamais une date de naissance, un numéro de document ou un texte OCR brut. Tout ce qu'un demandeur a saisi, ou qui a été extrait d'un document qu'il a envoyé, arrive dans une enveloppe non fiable étiquetée, de sorte que le modèle en rend compte au lieu d'obéir. Les outils qui envoient réellement des courriels aux clients sont signalés comme non uniquement en lecture afin que votre hôte puisse demander confirmation avant de les déclencher, et l'unique outil réellement destructeur l'indique. Consultez les détails dans Sécurité et limites.

Ce qui n'est pas encore disponible

Authentification. Tous les modes d'installation de ce site utilisent une clé d'API sous forme de jeton Bearer. Un flux de connexion OAuth 2.1 (enregistrement dynamique de client, consentement, jetons limités à une seule organisation) est aussi implémenté pour les annuaires de connecteurs ; les jetons qu'il émet se comportent exactement comme des clés d'API.

Une limite utile à connaître avant de commencer, car vous la rencontrerez :

explain_verification_decision ne peut pas expliquer la plupart des vérifications anciennes. Le raisonnement structuré du moteur de score n'existe que pour les demandes scorées après son enregistrement ; l'outil renvoie reasoningAvailable: false pour les autres.

Chaque appel d'outil est enregistré dans le même journal d'audit KYC infalsifiable (kyc_audit_log) que les actions humaines, via l'API REST avec la clé propre à l'appelant.

Suite

Installation — configuration JSON par hôte, liée à votre clé d'API existante.

Référence des outils — les 26 outils regroupés par tâche, avec ce qu'ils renvoient et ce qu'ils ne renvoient pas.

Ressources et invites — le contexte que le modèle peut récupérer gratuitement, et les cinq workflows préconfigurés.

Sécurité et limites — niveaux de données personnelles, enveloppe non fiable, limitations de débit et quotas.