Serveur MCP

Le serveur MCP de VerifNer met l’API à disposition des agents d’IA : ils peuvent envoyer un lien de vérification à un client, vérifier un document, lire un verdict ou déboguer un webhook, avec votre clé et rien de plus.

Opérations

« Envoie un lien de vérification à Aïssa pour le dossier 4821, puis dis-moi le verdict. »

Développement

« Pourquoi mon endpoint webhook ne reçoit rien ? » L’agent lit les dernières livraisons et l’erreur.

Clients compatibles

Le MCP est un protocole ouvert : le serveur VerifNer fonctionne avec tout outil qui sait lancer un serveur MCP local, quel que soit le modèle derrière (Claude, GPT, Gemini…).

Client	Modèles	État
Claude Code, Claude Desktop	Claude	Disponible
Cursor	Claude, GPT, Gemini…	Disponible
VS Code avec GitHub Copilot	Claude, GPT, Gemini…	Disponible
Windsurf	Claude, GPT, Gemini…	Disponible
Codex CLI (OpenAI)	GPT	Disponible
Gemini CLI (Google)	Gemini	Disponible
ChatGPT, Claude.ai, Le Chat (web)		Bientôt : ces assistants demandent un serveur distant avec connexion OAuth

Installation

Créez une clé dans la console. Commencez par une clé de test : le traitement est complet, rien n’est conservé ni facturé. Node.js 20 ou plus récent doit être installé sur la machine.

claude mcp add verifner --scope user --env VERIFNER_API_KEY=vn_test_... -- npx -y @verifner/mcp

--scope user le rend disponible dans tous vos projets. Vérifiez avec claude mcp list, puis ouvrez une nouvelle session.

Réglages → Développeur → Modifier la configuration :

claude_desktop_config.json

{
  "mcpServers": {
    "verifner": {
      "command": "npx",
      "args": ["-y", "@verifner/mcp"],
      "env": { "VERIFNER_API_KEY": "vn_test_..." }
    }
  }
}

Redémarrez Claude Desktop.

Dans ~/.cursor/mcp.json (tous les projets) ou .cursor/mcp.json (un seul projet) :

mcp.json

{
  "mcpServers": {
    "verifner": {
      "command": "npx",
      "args": ["-y", "@verifner/mcp"],
      "env": { "VERIFNER_API_KEY": "vn_test_..." }
    }
  }
}

Le serveur apparaît dans Réglages → MCP.

Dans .vscode/mcp.json. La clé est demandée à la première utilisation et gardée par VS Code, pas écrite dans le fichier :

.vscode/mcp.json

{
  "inputs": [
    { "type": "promptString", "id": "verifner-key", "description": "Clé API VerifNer", "password": true }
  ],
  "servers": {
    "verifner": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@verifner/mcp"],
      "env": { "VERIFNER_API_KEY": "${input:verifner-key}" }
    }
  }
}

Utilisez ensuite Copilot Chat en mode Agent.

Dans ~/.codeium/windsurf/mcp_config.json :

mcp_config.json

{
  "mcpServers": {
    "verifner": {
      "command": "npx",
      "args": ["-y", "@verifner/mcp"],
      "env": { "VERIFNER_API_KEY": "vn_test_..." }
    }
  }
}

Dans ~/.codex/config.toml :

config.toml

[mcp_servers.verifner]
command = "npx"
args = ["-y", "@verifner/mcp"]
env = { VERIFNER_API_KEY = "vn_test_..." }

Dans ~/.gemini/settings.json :

settings.json

{
  "mcpServers": {
    "verifner": {
      "command": "npx",
      "args": ["-y", "@verifner/mcp"],
      "env": { "VERIFNER_API_KEY": "vn_test_..." }
    }
  }
}

Tapez /mcp dans Gemini CLI pour voir les outils.

Tout client MCP qui lance un serveur en stdio :

VERIFNER_API_KEY=vn_test_... npx -y @verifner/mcp

Pour essayer : « Crée un lien de vérification VerifNer pour le dossier test-1 », puis, une fois la vérification faite sur le téléphone, « Quel est le verdict ? ».

Avec une clé live, chaque vérification terminée est facturée et ses images sont conservées. Le serveur prévient l’agent de demander confirmation avant d’en lancer une, mais gardez une clé de test pour vos essais.

Outils

Outil	Ce qu’il fait	Lecture seule
`create_verification_link`	Ouvre une session et renvoie le lien hébergé à envoyer à la personne. Elle l’ouvre sur son téléphone, photographie son document et fait un selfie.
`get_session`	État d’une session : en attente, terminée (avec le verdict) ou expirée	✓
`verify_document`	Vérifie un document à partir d’images : fichier local, URL ou `data:`
`get_verification`	Relit une vérification : verdict, `final_verdict`, contrôles, champs	✓
`get_image_url`	Lien de 5 minutes vers une image d’une vérification live (journalisé)	✓
`list_webhooks`	Vos endpoints webhook	✓
`create_webhook`	Déclare un endpoint et renvoie son secret de signature, une seule fois
`delete_webhook`	Supprime un endpoint
`list_webhook_deliveries`	Les 50 dernières livraisons d’un endpoint, avec erreurs et tentatives	✓

Le jeton client d’une session n’est jamais montré à l’agent : il n’apparaît que dans le lien.

Variables d’environnement

Variable	Obligatoire	Description
`VERIFNER_API_KEY`	✓	Votre clé `vn_test_…` ou `vn_live_…`
`VERIFNER_API_URL`		`https://api.verifner.com` par défaut

Données personnelles

Les champs lus sur un document (nom, date de naissance, numéro) passent par l’agent, et donc par le fournisseur de son modèle. Pour des dossiers réels, préférez create_verification_link et get_session, qui ne renvoient que le verdict, ou vérifiez que votre usage de l’agent est compatible avec vos obligations de protection des données.

Démarrer

Vérification

Intégration

Console

Référence

Opérations

Développement

Clients compatibles

Installation

Outils

Variables d’environnement

Données personnelles

Opérations

Développement

​Clients compatibles

​Installation

​Outils

​Variables d’environnement

​Données personnelles

Clients compatibles

Installation

Outils

Variables d’environnement

Données personnelles