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.
https://app.qualisend.com/api/mcpOption 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.
verify_emailverify_emailsverify_listget_credit_balanceget_verificationDélivrabilité et authentification
Diagnostic des domaines d'envoi et des messages. Aucun crédit consommé ; disponible avec le forfait Pro de Qualisend.
check_domaingenerate_dns_recordanalyze_email_headercheck_disposablecheck_typolookup_smtp_codeSurveillance de la réputation
Aucun crédit consommé ; nécessite l'option Surveillance des listes noires de Qualisend.
check_blacklistUn 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.
Commencez gratuitement avec 100 crédits, puis ajoutez le point de terminaison à votre client.