Serveur MCP ProofAge : laissez votre agent de code IA intégrer le KYC et la vérification d’âge
Le serveur MCP ProofAge permet à un agent de code IA comme Claude Code ou Cursor d’intégrer la vérification d’identité (KYC) et la vérification d’âge dans votre application. Connectez-le à l’adresse https://app.proofage.net/mcp/admin et connectez-vous avec OAuth, sans clé API. L’agent crée un espace de travail de test, écrit le code avec nos SDK et teste les webhooks. Il est inclus gratuitement dans chaque compte.
Connexion en une étape
Votre client MCP ouvre une fenêtre de navigateur. Vous vous connectez avec votre compte de la console ProofAge et vous approuvez l’accès. Il n’y a aucune clé API à coller.
Claude Code
claude mcp add --transport http proofage https://app.proofage.net/mcp/admin
Lancez ensuite /mcp dans Claude Code et choisissez proofage pour vous connecter.
Claude.ai
Dans Settings → Connectors, ajoutez un connecteur personnalisé avec l’URL https://app.proofage.net/mcp/admin, puis connectez-le et identifiez-vous.
Cursor
Dans ~/.cursor/mcp.json :
{
"mcpServers": {
"proofage": { "url": "https://app.proofage.net/mcp/admin" }
}
}
VS Code
Dans .vscode/mcp.json :
{
"servers": {
"proofage": { "type": "http", "url": "https://app.proofage.net/mcp/admin" }
}
}
Grok
Sur grok.com, ouvrez Connectors → New connector → Custom, saisissez https://app.proofage.net/mcp/admin, puis connectez-vous. Avec les offres Business et Enterprise, un administrateur doit parfois ajouter le connecteur d’abord.
Perplexity
Dans Settings → Connectors, ajoutez un connecteur distant personnalisé avec l’URL https://app.proofage.net/mcp/admin et l’authentification OAuth, puis connectez-vous. Les connecteurs personnalisés demandent une offre Pro, Max ou Enterprise.
ChatGPT, Codex et autres clients
Indiquez au client l’adresse https://app.proofage.net/mcp/admin. Le serveur prend en charge la découverte OAuth et l’enregistrement dynamique des clients. ChatGPT, GitHub Copilot dans VS Code, Gemini CLI, l’application Gemini, Mistral Le Chat, Copilot Studio, Superhuman et Coda, Amazon Quick, n8n Cloud et les clients qui se connectent par une redirection locale, comme Codex, peuvent s’y connecter. Si votre client est refusé à la connexion, écrivez-nous en indiquant son nom : nous ajoutons des clients sur demande.
Ce que votre agent peut faire
L’agent travaille avec votre compte comme votre équipe le fait dans la console. Des demandes simples suffisent : l’agent choisit les outils.
| Groupe | Ce qu’il fait | Exemple de prompt |
|---|---|---|
| Intégrer | Créer un espace de travail de test, lire ses clés et ses URL, créer des vérifications, définir des résultats de test et rejouer des webhooks sur un gestionnaire local. Puis créer l’espace de travail en mode réel. | « Intègre la vérification d’âge ProofAge dans cette application. Utilise un espace de travail de test, le Browser SDK sur la page de paiement et un gestionnaire de webhooks qui marque l’utilisateur comme vérifié. » |
| Enquêter | Consulter les vérifications, leur décision et son motif, les images, les envois de webhooks et les statistiques, avec les mêmes données que la console. | « Pourquoi la vérification 550e8400-… a-t-elle été refusée ? » |
| Support | Envoyer un lien de vérification, bloquer ou débloquer un visage, et effacer les données d’une personne sur demande. | « Envoie un lien de vérification pour le client 8812 dans l’espace de travail “Checkout” et donne-moi l’URL. » |
| Docs | L’agent lit la documentation développeur et la spécification OpenAPI via le serveur, par un outil ou comme ressources MCP, si bien qu’il écrit du code qui correspond à la vraie API. | « Compare notre gestionnaire de webhooks au guide des webhooks ProofAge : vérifie la signature avec le SDK et ignore tout envoi dont le X-ProofAge-Webhook-Delivery-Id a déjà été traité. » |
De zéro au mode réel, pas à pas
Avec les SDK, une intégration type est construite et testée en une journée. Avec un agent de code IA qui utilise le serveur MCP, il faut généralement quelques heures. Voici l’ordre que suit l’agent.
-
1
Créer un espace de travail de test
Avec le contrôle dont vous avez besoin : Vérification d’identité (KYC), Estimation de l’âge par le visage ou Vérification d’âge par pièce d’identité. Le mode test est gratuit.
-
2
Lire le guide d’intégration
L’agent récupère les clés et les URL de l’espace de travail, puis lit dans la documentation le démarrage rapide, les guides des SDK, les webhooks et les tests.
-
3
Écrire l’intégration avec le SDK officiel
Pour Node.js, Python, PHP ou Laravel. Le SDK signe les requêtes et vérifie les webhooks : l’agent n’écrit donc pas son propre code de signature.
-
4
Créer une vérification et la terminer vous-même
L’agent vous donne le lien. Les étapes avec la caméra exigent une personne : c’est vous qui les terminez.
-
5
Définir le résultat du test
Approuvé, refusé ou nouvelle soumission demandée. Le résultat déclenche l’envoi du webhook à votre gestionnaire.
-
6
Rejouer les envois de webhooks
L’agent récupère la requête signée exacte et l’envoie à votre gestionnaire local jusqu’à ce qu’elle passe.
-
7
Passer en mode réel
L’agent peut créer l’espace de travail en mode réel. Vous copiez sa clé secrète depuis la console et la mettez en production : la clé secrète du mode réel n’est jamais montrée à l’agent.
Le prompt d’intégration
Un brief prêt à coller dans votre agent. Il commence ainsi :
Integrate ProofAge into this project.
What I want: <e.g. an age check (18+) before checkout; or identity verification (KYC) for new sellers>.
Where the person starts it: <e.g. the "Verify age" button on /checkout>.
What a result should change: <e.g. set users.age_verified_at on approval; block the order on decline>.
Conçu pour rester sûr
L’agent agit en votre nom, dans le compte où vous travaillez, et ne voit que les outils que votre rôle dans la console autorise. Chaque action est enregistrée à votre nom, comme dans la console.
-
Les clés secrètes du mode réel restent entre des mains humaines
Elles ne sont jamais renvoyées par MCP. Une personne les copie depuis la console.
-
Les modifications en mode réel attendent votre confirmation
Une modification d’un espace de travail en mode réel ou de ses clés n’est qu’un aperçu. Rien n’est appliqué tant que vous ne confirmez pas.
-
Les actions destructrices se font en deux étapes
Bloquer ou débloquer un visage et effacer les données d’une personne renvoient d’abord un aperçu et un jeton de courte durée. L’agent confirme ensuite avec une phrase exacte et un motif.
-
Rôles et limites de débit
Les développeurs ne peuvent pas effacer de données personnelles. La création de vérifications, d’espaces de travail et de résultats de test, ainsi que l’effacement de données, sont soumis à des limites de débit par utilisateur.
Après le lancement
Les équipes de support et d’exploitation continuent d’utiliser le même serveur depuis Claude.ai ou leur propre assistant, avec le rôle de spécialiste du support.
- « Pourquoi cet utilisateur a-t-il été refusé ? » L’agent lit la décision, son motif et ce que la personne a soumis.
- « Envoie un lien de vérification à ce client. » L’agent crée une vérification et vous donne le lien à envoyer.
- « Efface les données de cette personne. » L’agent prépare l’effacement, montre ce qui sera supprimé et ce qui est conservé, et confirme une fois que vous êtes d’accord.
Questions sur le serveur MCP
ProofAge a-t-il un serveur MCP ?
Oui. Le serveur MCP ProofAge est un serveur MCP distant en HTTP, à l’adresse https://app.proofage.net/mcp/admin. Vous vous connectez avec votre compte de la console ProofAge via OAuth. Un agent de code IA peut l’utiliser pour intégrer la vérification d’identité (KYC) et la vérification d’âge dans votre application, consulter les vérifications et traiter les demandes de support. Voir aussi l’API KYC (Cette page n’est disponible qu’en anglais) et la vue d’ensemble pour les développeurs.
Quels agents de code IA sont compatibles ?
La documentation décrit la configuration pour Claude Code, Claude.ai, Cursor, VS Code, Grok et Perplexity. ChatGPT, Codex, GitHub Copilot dans VS Code, Gemini CLI, Mistral Le Chat et plusieurs autres clients se connectent avec la même URL. Si votre client est refusé à la connexion, écrivez-nous : nous ajoutons des clients sur demande.
Faut-il une clé API pour se connecter ?
Non. Votre client MCP ouvre une fenêtre de navigateur, vous vous connectez avec votre compte de la console ProofAge et vous approuvez l’accès. Le serveur prend en charge la découverte OAuth et l’enregistrement dynamique des clients.
L’agent peut-il toucher aux données ou aux clés du mode réel ?
Uniquement dans les limites de votre rôle dans la console, et avec des garde-fous. Les clés secrètes du mode réel ne sont jamais renvoyées par MCP : une personne les copie depuis la console. Une modification d’un espace de travail en mode réel ou de ses clés n’est qu’un aperçu tant que vous ne la confirmez pas. Bloquer ou débloquer un visage et effacer les données d’une personne exigent une seconde étape de confirmation, avec un jeton de courte durée, une phrase exacte et un motif. Chaque action est enregistrée à votre nom.
Combien de temps prend une intégration avec un agent IA ?
Avec les SDK, une intégration type est construite et testée en une journée. Avec un agent de code IA qui utilise le serveur MCP et le prompt d’intégration, il faut généralement quelques heures.
Le serveur MCP est-il gratuit ?
Oui. Le serveur MCP est inclus dans chaque compte sans supplément. Les vérifications en mode réel qu’il crée sont facturées comme d’habitude, et le mode test est toujours gratuit. Voir les tarifs.
Une ligne directe avec les développeurs qui l’ont construit
Écrivez-nous sur LinkedIn, par e-mail ou dans le chat du tableau de bord. Les développeurs qui ont construit ProofAge répondent eux-mêmes, week-ends compris.
Connectez votre agent et commencez à construire
Le mode test est gratuit. 500 vérifications en mode réel sont gratuites aussi, sans carte bancaire, sans limite de durée.