Connecter un agent IA via MCP

Choisissez votre client

Point de terminaison : https://mcp.fairvalid.com/mcp. Transport : Streamable HTTP.

Connectez-vous avec une clé API ou via OAuth. Les connexions ChatGPT, Claude et Grok éligibles peuvent utiliser OAuth ; consultez ci-dessous les exigences de compte et de rôle de votre client. Codex, Claude Code et Hermes prennent également en charge les connexions directes par clé API.

Pour les clients utilisant une clé API, créez une clé Test nommée dans Clés API en tant que propriétaire ou gestionnaire de l’espace de travail. Enregistrez-la dans les identifiants protégés du client ou dans les paramètres d’environnement documentés. Ne placez jamais une clé dans un prompt, un argument d’outil, une URL ou une configuration versionnée.

Le flux OAuth ouvre fairvalid.com pour la connexion et le consentement. Vous choisissez une clé API Live existante couvrant les autorisations demandées, et vérifiez son espace de travail et son plafond sur toute sa durée de vie. L’approbation accorde l’ensemble des autorisations demandées, dans la limite des portées de cette clé. Il ne vous est pas demandé de coller cette clé dans le client IA. Révoquer la clé sélectionnée met également fin à ses connexions. OAuth utilise des clés Live ; utilisez une connexion directe avec une clé de test pour l’environnement de test.

Instructions client vérifiées le 23 octobre 2026. Le protocole MCP hébergé a passé la recette en production avec le SDK officiel. Cela ne signifie pas que chaque client cité a été testé ; effectuez la vérification de connexion dans votre client avant de vous y fier.

ChatGPT

Utilisez la configuration OAuth ci-dessous. Les connexions MCP personnalisées nécessitent actuellement ChatGPT Business ou Enterprise/Edu sur le web, avec l’autorisation de créer des plugins avec des MCP. Business requiert un administrateur ou un propriétaire ; Enterprise/Edu peut autoriser certains membres.

1. Ouvrez Plugins, sélectionnez le bouton plus, puis Ajouter un serveur MCP personnalisé. Le parcours Plugins actuel ne nécessite pas le mode développeur.
2. Nommez la connexion FairValid et saisissez https://mcp.fairvalid.com/mcp comme point de terminaison HTTPS public.
3. Choisissez OAuth avec enregistrement automatique du client. FairValid utilise l’enregistrement de client public : vous n’avez pas besoin de fournir d’ID client ni de secret client. Ne saisissez jamais de clé API dans l’un ou l’autre de ces champs.
4. Effectuez la connexion et le consentement FairValid décrits ci-dessus. Lisez l’avertissement de ChatGPT, puis sélectionnez Create as a plugin et examinez les six outils détectés.
5. Installez le plugin, ouvrez une nouvelle conversation, tapez @ et sélectionnez FairValid. Lancez la vérification de connexion en lecture seule ci-dessous avant de demander une vérification réelle.

Documentation officielle : OpenAI : connecter un serveur MCP personnalisé · OpenAI : authentification OAuth

Claude web et Desktop

Utilisez un connecteur personnalisé distant avec OAuth. Il s’agit de la même connexion liée au compte sur Claude web et Desktop ; elle passe par les serveurs d’Anthropic. Sur les offres Team et Enterprise, un Owner de l’organisation doit d’abord ajouter le connecteur. Les membres Enterprise disposant d’un rôle personnalisé qui gère les bibliothèques de l’organisation peuvent également l’ajouter.

Some organizations have a Request headers beta. For that alternative, choose No sign-in and add a required Authorization header with the full value Bearer <your FairValid API key>. If Request headers is absent, use OAuth or the Claude Code instructions below. The API key is not an OAuth client secret.

1. Ouvrez Personnaliser → Connecteurs → Ajouter un connecteur personnalisé. Pour une organisation gérée, un propriétaire ou un rôle Enterprise habilité commence dans Paramètres de l’organisation → Connecteurs → Ajouter → Personnalisé → Web.
2. Saisissez FairValid et https://mcp.fairvalid.com/mcp.
3. Choisissez Se connecter maintenant. Si un choix de client OAuth apparaît, sélectionnez Enregistrer automatiquement. Laissez vides les champs d’ID client et de secret pour un client enregistré manuellement.
4. Connectez-vous sur fairvalid.com, vérifiez la clé de production et les autorisations sélectionnées, puis approuvez la connexion. Activez FairValid depuis les paramètres des connecteurs de la conversation.
5. Effectuez la vérification de connexion en lecture seule ci-dessous. N’utilisez la vérification en sandbox que si vous vous êtes connecté avec une clé API de test via les en-têtes de requête.

Documentation officielle : Anthropic : connecteurs personnalisés et authentification · Anthropic : disponibilité des connecteurs distants

Claude Code

Claude Code prend en charge une connexion directe par clé API. Définissez FAIRVALID_API_KEY dans l’environnement qui lance Claude Code, en utilisant une clé Test pour la première vérification. Ne placez pas le secret réel dans les fichiers du projet.

1. Fusionnez la configuration ci-dessous dans le fichier .mcp.json du projet. Conservez les serveurs existants. La référence littérale à la variable d’environnement doit figurer dans le fichier, mais pas la valeur de la clé.
2. Lancez Claude Code avec FAIRVALID_API_KEY disponible. Approuvez la configuration MCP du projet si cela vous est demandé.
3. Exécutez claude mcp list, puis consultez /mcp dans la session. Vérifiez que FairValid se connecte et expose six outils, puis effectuez la vérification en sandbox ci-dessous.

{
  "mcpServers": {
    "fairvalid": {
      "type": "http",
      "url": "https://mcp.fairvalid.com/mcp",
      "headers": {
        "Authorization": "Bearer ${FAIRVALID_API_KEY}"
      }
    }
  }
}

Documentation officielle : Anthropic : configuration MCP de Claude Code

Hermes Agent

Ces instructions concernent NousResearch Hermes Agent. Son transport HTTP distant prend en charge les en-têtes bearer. La CLI enregistre la clé dans le fichier .env de votre profil actif sous MCP_FAIRVALID_API_KEY et conserve une référence à la variable d’environnement dans config.yaml.

1. Exécutez la commande d’ajout ci-dessous. Répondez oui lorsqu’on vous demande si une authentification est requise, puis saisissez une clé API de test dans l’invite masquée API key / Bearer token.
2. Examinez les outils détectés et activez les outils FairValid dont vous avez besoin. La configuration doit aboutir à une connexion réussie ; enregistrer une connexion désactivée après une erreur ne constitue pas une configuration réussie.
3. Exécutez hermes mcp test fairvalid, puis démarrez une nouvelle session ou exécutez /reload-mcp. Effectuez la vérification en sandbox ci-dessous. Hermes peut ajouter le préfixe de son nom de serveur aux noms des outils.

hermes mcp add fairvalid \
  --url https://mcp.fairvalid.com/mcp \
  --auth header

hermes mcp test fairvalid

Documentation officielle : NousResearch : configuration MCP · NousResearch : vérifications de connexion MCP · NousResearch : implémentation CLI avec authentification par en-tête

Grok Bot et Grok

Grok Bot et Grok.com se configurent à des endroits différents. Dans un Grok Bot personnel, demandez au Bot d’ajouter FairValid à l’aide de la requête ci-dessous. Cette méthode fonctionne aussi lorsque le panneau d’informations n’affiche que Détails, Bibliothèque et Ordinateur, sans section Configuration.

Les Team Bots exposent en plus le volet d’informations → Setup → Plugins au propriétaire ou aux gestionnaires du Bot. Cette interface de configuration nécessite un accès Team Bot dans l’application de bureau. Chaque coéquipier se connecte avec son propre compte lorsque OAuth est utilisé.

Grok.com utilise grok.com/connectors → New Connector → Custom. Saisissez https://mcp.fairvalid.com/mcp et terminez l’authentification. Les équipes Business et Enterprise devront peut-être demander d’abord à leur administrateur de provisionner le connecteur. Cette connexion est distincte d’un plugin Grok Bot.

Un bot conçu avec l’API xAI est également distinct : son développeur configure les en-têtes MCP distants dans le code serveur. Ces instructions n’affirment pas que Grok Bot propose un champ générique pour l’en-tête Authorization.

1. Demandez à votre Bot d’ajouter la connexion MCP HTTPS distante personnalisée à l’aide de la requête ci-dessous. Pour un Team Bot, son propriétaire ou responsable peut aussi passer par Setup → Plugins.
2. When the Bot shows the FairValid authorization card, select Authorize to open OAuth sign-in. Keep API keys out of the request and any server command.
3. Donnez votre consentement FairValid sur fairvalid.com. Chaque membre de l’équipe connecte son propre compte lorsque c’est nécessaire.
4. Demandez au Bot de lister les outils de FairValid et d’exécuter la vérification de connexion en lecture seule ci-dessous. La seule découverte des outils ne prouve pas qu’une vérification a abouti.

Add FairValid as a custom Remote HTTPS MCP server at
https://mcp.fairvalid.com/mcp using OAuth.
Show me the sign-in flow, then list its tools.
Do not submit any email verification yet.

Documentation officielle : xAI : plugins Grok Bot et HTTPS distant · xAI : connecteurs personnalisés Grok.com · xAI : MCP distant pour les développeurs d’API

Codex

Utilisez une connexion directe par clé API depuis Codex. Définissez FAIRVALID_API_KEY dans l’environnement accessible au processus Codex, en utilisant une clé Test pour votre première vérification. Une application de bureau lancée séparément peut ne pas hériter de l’environnement de votre terminal.

1. Exécutez la commande ci-dessous pour enregistrer le serveur distant Streamable HTTP. La commande enregistre le nom de la variable d’environnement, et non la clé API.
2. Exécutez codex mcp list et démarrez une nouvelle session Codex pour qu’elle charge la connexion. Vérifiez que FairValid apparaît dans les outils MCP de la session.
3. Si vous utilisez l’application Codex, rendez la variable disponible sur son hôte d’exécution et redémarrez l’application ou ouvrez une nouvelle session si nécessaire. Ne partez pas du principe qu’une configuration réussie de la CLI a modifié l’environnement d’une application déjà en cours d’exécution.
4. Confirmez les six outils détectés et effectuez la vérification en bac à sable ci-dessous.

codex mcp add fairvalid \
  --url https://mcp.fairvalid.com/mcp \
  --bearer-token-env-var FAIRVALID_API_KEY

codex mcp list

Documentation officielle : OpenAI : configuration MCP de Codex

Vérifiez la connexion avant de soumettre des tâches

Vérifiez que les six outils listés ci-dessous ont bien été détectés. Un client peut ajouter son propre préfixe aux noms des outils. La détection confirme une connexion, pas une vérification réussie.

Avec OAuth ou une clé API Live, accordez l’autorisation de consultation du solde et demandez d’abord à l’agent d’appeler fairvalid_get_balance sans argument. La consultation du solde n’utilise aucun crédit de vérification. N’envoyez pas les exemples du sandbox via une connexion live.

Avec une clé API Test, suivez plutôt la vérification sandbox ci-dessous. La vérification live peut réserver et dépenser des crédits ; choisissez une adresse que vous êtes autorisé à vérifier et demandez explicitement l’envoi.

Si une connexion échoue, vérifiez les autorisations de connecteur du compte, le point de terminaison, les variables d’environnement manquantes, ainsi que la révocation éventuelle de la clé ou de l’autorisation. En cas d’erreur d’autorisation ou de plafond de dépenses, examinez les portées accordées ou le plafond avant de réessayer ; une nouvelle clé d’idempotence ne règle pas la cause du problème.

Commencez par une vérification gratuite en sandbox

Utilisez une clé fv_test_ et appelez fairvalid_verify_email avec l’exemple ci-dessous. La vérification d’une adresse unique avec une clé de test renvoie directement un résultat simulé. Elle n’effectue aucun appel au fournisseur, ne crée aucune vérification réelle et ne consomme aucun crédit.

Les autres exemples réservés sont undeliverable@example.com, risky@example.com, unknown@example.com, pending@example.com et error@example.com. Pending et error sont des simulations volontaires, et non de véritables vérifications de boîte aux lettres. L’exemple pending pour une adresse unique n’a aucune tâche à interroger.

{
  "email": "deliverable@example.com",
  "idempotency_key": "agent-demo-2026-10-23"
}

Outils et autorisations

fairvalid_verify_email prend email et idempotency_key. fairvalid_submit_job prend emails, idempotency_key et un name facultatif, pour 1 à 5 000 adresses. Les soumissions en mode live nécessitent la portée submit.

fairvalid_get_job prend job_id pour lire l’état. fairvalid_get_results prend job_id ainsi que cursor, filter et search facultatifs pour lire jusqu’à 50 résultats à la fois. Les lectures en mode live nécessitent la portée read.

fairvalid_cancel_job prend job_id et demande l’annulation ; les vérifications en cours peuvent se terminer. L’annulation en mode live nécessite la portée submit. fairvalid_get_balance ne prend aucun argument et nécessite une clé live avec la portée balance. Les clés de test ne peuvent pas lire un solde de crédits live.

Les clés déterminent l’espace de travail. Les outils n’acceptent aucun argument de clé API ni d’espace de travail. Les vérifications de portée, la révocation, les plafonds de dépenses et les règles de crédits de l’espace de travail s’appliquent au MCP exactement comme à l’API client.

Suivre une tâche en direct jusqu’aux résultats

Avec OAuth ou une clé fv_live_, la vérification individuelle comme la vérification en masse soumettent des tâches asynchrones. Une réponse acceptée et un job_id signifient que le travail a été admis, et non que la vérification de la boîte de réception est terminée. Le délai de traitement dépend de la file d’attente et du fournisseur de vérification.

Pour tester le déroulement d’une tâche en sandbox, appelez fairvalid_submit_job avec des adresses d’exemple réservées. Les tâches sandbox prennent en charge l’état, les résultats, l’annulation et la relecture, sans appel aux fournisseurs ni consommation de crédits.

1. Soumettez une seule fois avec une idempotency_key stable et conservez le job_id renvoyé.
2. Appelez fairvalid_get_job avec ce job_id. Espacez les requêtes d’interrogation et augmentez progressivement l’intervalle en cas d’échecs temporaires.
3. Appelez fairvalid_get_results avec le même job_id. Renvoyez chaque next_cursor comme cursor jusqu’à ce que next_cursor soit null. Un curseur conserve le filtre et la recherche d’origine.
4. Vérifiez à la fois l’état de la tâche et chaque résultat. Les résultats inconnus, catch-all et en cours de vérification ne prouvent pas qu’une boîte aux lettres est valide.

Réessayer sans créer de tâche en double

Les deux outils d’envoi exigent une idempotency_key de 8 à 128 caractères : lettres, chiffres, points, deux-points, traits de soulignement ou traits d’union. En cas de réponse incertaine, réessayez avec la même clé API ou connexion OAuth, la même idempotency_key et des données inchangées. La relecture est limitée à la clé API sous-jacente : renouveler un jeton d’accès OAuth conserve cette identité, mais choisir une autre clé API et renvoyer la requête peut créer une nouvelle exécution. Une charge utile de tâche modifiée avec une clé d’idempotence existante est rejetée. N’utilisez une nouvelle clé d’idempotence que pour une nouvelle exécution volontaire.

Vérifiez isError avant de lire le résultat. Les appels qui atteignent l’API client incluent sa réponse et son statut HTTP dans structuredContent ; les erreurs de validation des arguments peuvent ne renvoyer que du contenu textuel. Examinez le code d’une erreur d’API et respectez toute indication de nouvelle tentative. Un délai d’expiration ou une erreur temporaire ne prouve pas que la soumission initiale n’a pas eu lieu.

Les clés de production peuvent dépenser les crédits de l’espace de travail. Définissez un plafond à vie avant de connecter un agent autonome : les crédits débités et réservés sont tous deux comptabilisés. Les vérifications valides et invalides terminées utilisent un crédit ; les résultats inconnus, les catch-all non résolus et les échecs techniques n’entraînent aucun débit net de vérification.