Skip to content
Commencez avec 100 crédits de vérification gratuits
Qualisend

Serveur MCP de Qualisend

Le serveur MCP (Model Context Protocol) de Qualisend permet à un agent IA de vérifier des adresses e-mail, de nettoyer des listes et de contrôler la délivrabilité des domaines d'envoi via Qualisend, dans Claude, ChatGPT, Grok ou tout client compatible MCP, sans code ni export CSV. Cette page explique comment le connecter, comment fonctionne l'authentification, quels sont les douze outils qu'il expose et comment il traite vos données.

Point de terminaison
https://app.qualisend.com/api/mcp
Transport
Streamable HTTP (JSON-RPC 2.0), sans état
Authentification
OAuth 2.1 (recommandé) ou une clé API Qualisend
Nom dans le registre
com.qualisend/email-verification

Prérequis

  • Un compte Qualisend. Le forfait gratuit inclut 100 crédits de vérification qui n'expirent jamais.
  • Un client compatible MCP : Claude, ChatGPT, Grok, Cursor, VS Code, Claude Code, Codex CLI, Gemini CLI, Zed, Goose, Windsurf ou équivalent. Chacun dispose d'un guide d'installation pas à pas.

Connecter le serveur

Ajoutez le point de terminaison ci-dessous comme connecteur personnalisé dans votre client, puis authentifiez-vous par une connexion en un clic ou avec une clé API.

Point de terminaison MCP
https://app.qualisend.com/api/mcp

Option A : connexion (OAuth 2.1)

Recommandée. Aucune clé à copier : votre client ouvre une page « Connecter Qualisend » où vous vous connectez et approuvez l'accès à un espace de travail.

  • Claude : Customize → Connectors → Add custom connector → collez le point de terminaison → Add et approuvez. (guide complet)
  • ChatGPT : Settings → Security and login → Developer mode, puis créez une application MCP personnalisée sur chatgpt.com/plugins. (guide complet)
  • Grok : grok.com/connectors → New Connector → Custom → collez le point de terminaison. (guide complet)

Tous les trois reposent sur la connexion plutôt que sur une clé collée. Les clients de développement (Claude Code, Cursor, VS Code, Zed, Goose, Codex CLI et Gemini CLI) acceptent les deux.

Option B : clé API

Vous préférez un identifiant statique ? Dans tout client capable d'envoyer un en-tête de requête, créez une clé dans votre tableau de bord sous API de vérification → API keys et fournissez-la comme jeton bearer :

Authorization: Bearer qs_live_…

Une fois la connexion établie, demandez simplement : « vérifie sales@acme.com », « ces 10 adresses sont-elles délivrables ? » ou « combien de crédits de vérification me reste-t-il ? »

Authentification

OAuth repose sur le standard OAuth 2.1 avec PKCE et l'enregistrement dynamique des clients : la connexion est donc limitée à l'espace de travail que vous approuvez. Les jetons d'accès ont une durée de vie courte (1 heure) et les jetons d'actualisation font l'objet d'une rotation ; les jetons et les codes d'autorisation ne sont stockés que sous forme de hachages, et les URI de redirection sont vérifiées par correspondance exacte. L'authentification par clé API utilise un jeton bearer (qs_live_…) dans l'en-tête Authorization. Dans les deux cas, l'authentification est une valeur d'en-tête explicite, jamais un cookie ni une session.

Outils

Le serveur expose douze outils, adossés au même moteur que l'API REST de Qualisend et répartis en trois groupes. Les outils de vérification de base fonctionnent avec tous les forfaits (y compris le forfait gratuit) ; les outils de délivrabilité nécessitent le forfait Pro de Qualisend, et le contrôle des listes noires nécessite l'option Surveillance des listes noires. Seuls les trois outils verify_ consomment des crédits : tout le reste est gratuit.

Vérification et nettoyage

Les outils de vérification de base, disponibles avec tous les forfaits, y compris le forfait gratuit. Les trois outils verify_ consomment 1 crédit par adresse ; les lectures sont gratuites.

Outil
Ce qu'il fait
Coût
verify_email
email
Vérifie une adresse (syntaxe, domaine/MX, détection des adresses jetables et génériques, suggestion en cas de faute de frappe et joignabilité de la boîte mail) et renvoie un verdict délivrable / à risque / non délivrable / inconnu, avec un code de motif et un score de confiance de 0 à 100. Renvoie un verdict instantané ainsi qu'un job_id ; le test SMTP se termine quelques secondes plus tard.1 crédit
verify_emails
emails[] (1-50)
Vérifie de façon synchrone un lot de 50 adresses maximum et renvoie un verdict pour chacune.1 crédit par adresse
verify_list
emails[] (1-1000)
Vérifie de façon asynchrone une grande liste de 1 000 adresses maximum : crée une seule tâche et renvoie un job_id. Interrogez get_verification pour suivre la progression et obtenir un résumé des résultats.1 crédit par adresse
get_credit_balance
-
Le nombre de crédits de vérification qu'il reste à votre espace de travail.Gratuit
get_verification
job_id
Consulte le statut ou le résultat d'une vérification à partir de son job_id : le test SMTP se termine après le verdict instantané.Gratuit

Délivrabilité et authentification

Diagnostic des domaines d'envoi et des messages. Aucun crédit consommé ; disponible avec le forfait Pro de Qualisend.

Outil
Ce qu'il fait
Coût
check_domain
domain
Vérifie si un domaine est configuré pour atteindre la boîte de réception : ses serveurs de messagerie (MX), son authentification SPF et DMARC, et ce qui manque. Un bilan de santé de la délivrabilité d'un domaine d'envoi.Gratuit
generate_dns_record
type, domain, …
Génère l'enregistrement DNS exact dont un domaine a besoin pour l'authentification des e-mails (SPF, DMARC, BIMI ou MTA-STS), prêt à copier dans le DNS, en indiquant où le placer.Gratuit
analyze_email_header
raw
Analyse les en-têtes bruts d'un e-mail pour montrer le chemin qu'il a suivi, le délai à chaque saut et s'il a réussi les contrôles SPF/DKIM/DMARC et antispam, afin de comprendre pourquoi un message a été lent ou a fini en spam. Collez la source du message (« Show original »).Gratuit
check_disposable
email
Indique si une adresse est une boîte jetable/temporaire, une adresse générique (info@, support@) ou une adresse de messagerie grand public gratuite (par ex. Gmail).Gratuit
check_typo
email
Repère une faute de frappe probable dans le domaine d'une adresse (par ex. gmial.com) et suggère le bon domaine.Gratuit
lookup_smtp_code
code
Explique en langage clair un code de réponse ou d'erreur d'un serveur de messagerie (par ex. 550 ou 5.1.1), et indique s'il s'agit d'un incident temporaire ou d'un échec permanent.Gratuit

Surveillance de la réputation

Aucun crédit consommé ; nécessite l'option Surveillance des listes noires de Qualisend.

Outil
Ce qu'il fait
Coût
check_blacklist
target
Vérifie si un domaine d'envoi ou une IP figure sur l'une des principales listes noires d'e-mails (Spamhaus, SpamCop, Barracuda et d'autres) : un contrôle ponctuel de la réputation.Gratuit

Un appel à verify_email renvoie le verdict local instantané ainsi qu'un job_id ; le test SMTP de la boîte mail se termine quelques secondes plus tard : utilisez donc get_verification (ou redemandez simplement) pour obtenir le résultat final sur les adresses limites.

À quoi ressemblent les résultats

Chaque adresse renvoie l'un des quatre verdicts (délivrable, à risque, non délivrable ou inconnu), chacun avec un code de motif lisible par machine, des indicateurs secondaires (catch-all, jetable, générique, boîte pleine), le fournisseur MX et un score de confiance de 0 à 100. Ce sont les mêmes champs publics que ceux renvoyés par l'API REST.

Crédits et limites de débit

Chaque vérification coûte un crédit, que l'agent vérifie une adresse ou un millier ; les lectures (get_credit_balance et get_verification) sont gratuites. Le connecteur utilise le même solde de crédits et les mêmes limites de débit que votre accès à l'API REST : vous pouvez donc demander « combien de crédits me reste-t-il ? » avant une grosse tâche. Le forfait gratuit inclut 100 crédits qui n'expirent jamais.

Sécurité et confidentialité

Le serveur MCP accorde exactement ce que vous approuvez, rien de plus.

Limité à un seul espace de travail

Chaque appel d'outil est authentifié (jeton OAuth ou clé API) et limité au seul espace de travail que vous connectez. Rien ne permet d'accéder aux données d'un autre client, aux fonctions d'administration ni à un quelconque système interne au-delà du flux de vérification. Le serveur réutilise les mêmes contrôles d'authentification, de périmètre, de limite de débit et de crédits que l'API REST publique.

Uniquement le verdict public

Les réponses ne contiennent que les champs de vérification publics renvoyés par l'API REST : jamais de détails internes du moteur, ni d'informations sur l'infrastructure de test, ni de transcriptions SMTP au-delà du résultat de délivrabilité. Le connecteur ne reçoit que les adresses que vous soumettez ; il n'accède jamais à vos conversations avec l'IA, à votre historique de discussion, à la mémoire de l'assistant ni à vos fichiers, et les adresses soumises ne sont jamais utilisées pour entraîner un modèle d'IA ou d'apprentissage automatique, ni vendues, ni partagées.

Pas de cookies, pas de CSRF

L'authentification est un jeton ou une clé explicite dans l'en-tête Authorization, jamais un cookie ni une session : le point de terminaison n'offre donc aucune surface d'attaque intersite (CSRF). OAuth utilise PKCE et une correspondance exacte des URI de redirection, et les jetons et les codes ne sont stockés que sous forme de hachages.

Courte durée de vie, révocable

Les jetons d'accès OAuth ont une durée de vie courte (1 heure) et les jetons d'actualisation font l'objet d'une rotation à chaque renouvellement. Révoquez l'accès à tout moment en déconnectant le connecteur dans votre client IA (OAuth) ou en révoquant la clé API dans votre tableau de bord Qualisend.

Traitement des données

Qualisend est une entreprise établie dans l'UE, et les données que vous soumettez sont stockées et traitées dans l'UE. Les tâches de vérification et leurs résultats restent dans votre espace de travail jusqu'à ce que vous les supprimiez ou fermiez votre compte ; vous pouvez supprimer les tâches et les résultats à tout moment. Nous ne vendons, ne louons ni ne partageons les listes que vous soumettez, et nous ne les utilisons pas pour entraîner des modèles d'IA ou d'apprentissage automatique. Tous les détails (collecte, utilisation, conservation, sous-traitants tiers et vos droits) figurent dans la Politique de confidentialité, et notre approche de la sécurité est présentée sur la page Sécurité.

Révoquer l'accès

Déconnectez le connecteur dans votre client IA pour révoquer une connexion OAuth, ou révoquez la clé API dans votre tableau de bord Qualisend sous API de vérification → API keys. Les jetons d'accès OAuth expirent aussi d'eux-mêmes dans un délai d'une heure.

Assistance

Des questions ou un problème ? Écrivez à hello@qualisend.com. Consultez aussi la vue d'ensemble MCP et les guides d'installation par client, la page API pour développeurs et la référence de l'API.

Prêt à connecter Qualisend ?

Commencez gratuitement avec 100 crédits, puis ajoutez le point de terminaison à votre client.