Qualisend-MCP-Server
Mit dem Qualisend-MCP-Server (Model Context Protocol) kann ein KI-Agent über Qualisend E-Mail-Adressen verifizieren, Listen bereinigen und die Zustellbarkeit von Versanddomains prüfen: in Claude, ChatGPT, Grok oder jedem MCP-kompatiblen Client, ohne Code und ohne CSV-Exporte. Diese Seite erklärt, wie du ihn verbindest und wie die Authentifizierung funktioniert, stellt alle zwölf Tools vor, die er bereitstellt, und beschreibt, wie er mit deinen Daten umgeht.
- Endpunkt
- https://app.qualisend.com/api/mcp
- Transport
- Streamable HTTP (JSON-RPC 2.0), zustandslos
- Authentifizierung
- OAuth 2.1 (empfohlen) oder ein Qualisend-API-Schlüssel
- Registry-Name
- com.qualisend/email-verification
Voraussetzungen
- Ein Qualisend-Konto. Der kostenlose Plan enthält 100 Verifizierungs-Credits ohne Ablaufdatum.
- Ein MCP-kompatibler Client: Claude, ChatGPT, Grok, Cursor, VS Code, Claude Code, Codex CLI, Gemini CLI, Zed, Goose, Windsurf oder ähnliche. Für jeden gibt es eine Schritt-für-Schritt-Anleitung zur Einrichtung.
Server verbinden
Füge den Endpunkt unten als benutzerdefinierten Connector in deinem Client hinzu und authentifiziere dich dann per Ein-Klick-Anmeldung oder mit einem API-Schlüssel.
https://app.qualisend.com/api/mcpOption A: Anmeldung (OAuth 2.1)
Empfohlen. Keine Schlüssel zum Kopieren: Dein Client öffnet eine Seite „Qualisend verbinden“, auf der du dich anmeldest und den Zugriff auf einen Workspace freigibst.
- Claude: Customize → Connectors → Add custom connector → Endpunkt einfügen → Add und freigeben. (vollständige Anleitung)
- ChatGPT: Settings → Security and login → Developer mode, dann auf chatgpt.com/plugins eine benutzerdefinierte MCP-App anlegen. (vollständige Anleitung)
- Grok: grok.com/connectors → New Connector → Custom → Endpunkt einfügen. (vollständige Anleitung)
Alle drei sind auf die Anmeldung ausgelegt, nicht auf einen eingefügten Schlüssel. Entwickler-Clients (Claude Code, Cursor, VS Code, Zed, Goose, Codex CLI und Gemini CLI) akzeptieren beides.
Option B: API-Schlüssel
Lieber statische Zugangsdaten? Für jeden Client, der einen Request-Header senden kann, erstellst du in deinem Dashboard unter Verifizierungs-API → API keys einen Schlüssel und gibst ihn als Bearer-Token an:
Authorization: Bearer qs_live_…Nach dem Verbinden einfach fragen: „Verifiziere sales@acme.com“, „Sind diese 10 Adressen zustellbar?“ oder „Wie viele Verifizierungs-Credits habe ich noch übrig?“
Authentifizierung
OAuth folgt dem Standard OAuth 2.1 mit PKCE und dynamischer Client-Registrierung, sodass die Verbindung auf den von dir freigegebenen Workspace beschränkt ist. Zugriffstokens sind kurzlebig (1 Stunde), und Refresh-Tokens werden rotiert; Tokens und Autorisierungscodes werden nur als Hashes gespeichert, und Redirect-URIs müssen exakt übereinstimmen. Die Authentifizierung per API-Schlüssel nutzt ein Bearer-Token (qs_live_…) im Header Authorization. In beiden Fällen ist die Authentifizierung ein expliziter Header-Wert, nie ein Cookie und nie eine Sitzung.
Tools
Der Server stellt zwölf Tools in drei Gruppen bereit, die auf derselben Engine laufen wie die REST-API von Qualisend. Die zentralen Verifizierungs-Tools funktionieren in jedem Plan (auch im kostenlosen Plan); die Zustellbarkeits-Tools erfordern den Pro-Plan von Qualisend, und die Blacklist-Prüfung erfordert das Add-on Blacklist-Überwachung. Nur die drei verify_-Tools verbrauchen Credits, alles andere ist kostenlos.
Verifizieren & bereinigen
Die zentralen Verifizierungs-Tools, verfügbar in jedem Plan, auch im kostenlosen Plan. Die drei verify_-Tools verbrauchen 1 Credit pro Adresse; die Abfragen sind kostenlos.
verify_emailverify_emailsverify_listget_credit_balanceget_verificationZustellbarkeit & Authentifizierung
Diagnose für Versanddomains und Nachrichten. Verbraucht keine Credits; verfügbar im Pro-Plan von Qualisend.
check_domaingenerate_dns_recordanalyze_email_headercheck_disposablecheck_typolookup_smtp_codeReputationsüberwachung
Verbraucht keine Credits; erfordert das Add-on Blacklist-Überwachung von Qualisend.
check_blacklistEin Aufruf von verify_email liefert das sofortige lokale Ergebnis plus eine job_id; die SMTP-Postfachprüfung ist wenige Sekunden später abgeschlossen. Für das endgültige Ergebnis bei Grenzfällen nutze also get_verification (oder frag einfach noch einmal).
So sehen die Ergebnisse aus
Jede Adresse erhält eines von vier Ergebnissen (zustellbar, riskant, unzustellbar oder unbekannt), jeweils mit einem maschinenlesbaren Grundcode, Zusatz-Flags (Catch-all, Wegwerfadresse, Rollenadresse, volles Postfach), dem MX-Anbieter und einem Konfidenzwert von 0 bis 100. Das sind dieselben öffentlichen Felder, die auch die REST-API zurückgibt.
Credits & Rate-Limits
Jede Verifizierung kostet einen Credit, egal ob der Agent eine Adresse prüft oder tausend; Abfragen (get_credit_balance und get_verification) sind kostenlos. Der Connector nutzt dasselbe Credit-Guthaben und dieselben Rate-Limits wie dein Zugriff auf die REST-API, du kannst also vor einem großen Job fragen: „Wie viele Credits sind übrig?“ Der kostenlose Plan enthält 100 Credits ohne Ablaufdatum.
Sicherheit & Datenschutz
Der MCP-Server gewährt genau das, was du freigibst, und nicht mehr.
Auf einen Workspace begrenzt
Jeder Tool-Aufruf ist authentifiziert (OAuth-Token oder API-Schlüssel) und auf den einen Workspace begrenzt, den du verbindest. Es gibt keinen Weg zu den Daten anderer Kunden, zu Admin-Funktionen oder zu irgendeinem internen System außerhalb des Verifizierungsablaufs. Der Server nutzt dieselben Prüfungen für Authentifizierung, Berechtigungsumfang, Rate-Limits und Credits wie die öffentliche REST-API.
Nur das öffentliche Ergebnis
Antworten enthalten nur die öffentlichen Verifizierungsfelder, die auch die REST-API zurückgibt: nie interne Details der Engine oder der Prüf-Infrastruktur und keine SMTP-Transkripte über das Zustellbarkeitsergebnis hinaus. Der Connector erhält nur die Adressen, die du übermittelst; er greift nie auf deine KI-Unterhaltungen, deinen Chatverlauf, das Gedächtnis deines Assistenten oder deine Dateien zu, und die übermittelten Adressen werden nie zum Training von KI- oder Machine-Learning-Modellen verwendet und weder verkauft noch weitergegeben.
Keine Cookies, kein CSRF
Die Authentifizierung erfolgt über ein explizites Token oder einen Schlüssel im Authorization-Header, nie über ein Cookie oder eine Sitzung, daher bietet der Endpunkt keine Angriffsfläche für Cross-Site-Angriffe (CSRF). OAuth nutzt PKCE und einen exakten Abgleich der Redirect-URIs, und Tokens und Codes werden nur als Hashes gespeichert.
Kurzlebig und widerrufbar
OAuth-Zugriffstokens sind kurzlebig (1 Stunde), und Refresh-Tokens werden bei jeder Erneuerung rotiert. Du kannst den Zugriff jederzeit widerrufen, indem du den Connector in deinem KI-Client trennst (OAuth) oder den API-Schlüssel in deinem Qualisend-Dashboard widerrufst.
Umgang mit Daten
Qualisend ist ein Unternehmen mit Sitz in der EU, und die Daten, die du übermittelst, werden in der EU gespeichert und verarbeitet. Verifizierungsjobs und ihre Ergebnisse bleiben in deinem Workspace, bis du sie löschst oder dein Konto schließt; du kannst Jobs und Ergebnisse jederzeit löschen. Wir verkaufen, vermieten oder teilen die von dir übermittelten Listen nicht, und wir nutzen sie nicht zum Training von KI- oder Machine-Learning-Modellen. Alle Details (Erhebung, Nutzung, Aufbewahrung, externe Auftragsverarbeiter und deine Rechte) findest du in der Datenschutzerklärung, und unsere Sicherheitsmaßnahmen beschreibt die Seite Sicherheit.
Zugriff widerrufen
Trenne den Connector in deinem KI-Client, um eine OAuth-Verbindung zu widerrufen, oder widerrufe den API-Schlüssel in deinem Qualisend-Dashboard unter Verifizierungs-API → API keys. OAuth-Zugriffstokens laufen außerdem innerhalb einer Stunde von selbst ab.
Support
Fragen oder Probleme? Schreib an hello@qualisend.com. Siehe auch die MCP-Übersicht mit den Einrichtungsanleitungen für jeden Client, die Entwickler-API und die API-Referenz.
Starte kostenlos mit 100 Credits und füge dann den Endpunkt zu deinem Client hinzu.