Server MCP di Qualisend
Il server MCP (Model Context Protocol) di Qualisend permette a un agente IA di verificare indirizzi email, pulire liste ed eseguire controlli di deliverability sui domini di invio tramite Qualisend, in Claude, ChatGPT, Grok o qualsiasi client compatibile con MCP, senza codice né esportazioni CSV. Questa pagina spiega come collegarlo, come funziona l'autenticazione, quali strumenti mette a disposizione (tutti e dodici) e come tratta i tuoi dati.
- Endpoint
- https://app.qualisend.com/api/mcp
- Trasporto
- Streamable HTTP (JSON-RPC 2.0), senza stato
- Autenticazione
- OAuth 2.1 (consigliato) o una chiave API di Qualisend
- Nome nel registro
- com.qualisend/email-verification
Requisiti
- Un account Qualisend. Il piano Free include 100 crediti di verifica che non scadono mai.
- Un client compatibile con MCP: Claude, ChatGPT, Grok, Cursor, VS Code, Claude Code, Codex CLI, Gemini CLI, Zed, Goose, Windsurf o simili. Per ognuno c'è una guida alla configurazione passo passo.
Collegamento del server
Aggiungi l'endpoint qui sotto come connettore personalizzato nel tuo client, poi autenticati con l'accesso in un clic o con una chiave API.
https://app.qualisend.com/api/mcpOpzione A: accesso (OAuth 2.1)
Consigliata. Nessuna chiave da copiare: il tuo client apre una pagina “Collega Qualisend” dove accedi e approvi l'accesso a un workspace.
- Claude: Customize → Connectors → Add custom connector → incolla l'endpoint → Add e approva. (guida completa)
- ChatGPT: Settings → Security and login → Developer mode, poi crea un'app MCP personalizzata su chatgpt.com/plugins. (guida completa)
- Grok: grok.com/connectors → New Connector → Custom → incolla l'endpoint. (guida completa)
Tutti e tre sono pensati per l'accesso, non per una chiave incollata. I client per sviluppatori (Claude Code, Cursor, VS Code, Zed, Goose, Codex CLI e Gemini CLI) accettano entrambe le opzioni.
Opzione B: chiave API
Preferisci una credenziale statica? In qualsiasi client in grado di inviare un header nella richiesta, crea una chiave nella tua dashboard in API di verifica → API keys e passala come bearer token:
Authorization: Bearer qs_live_…Dopo il collegamento, chiedi e basta: “verifica sales@acme.com”, “questi 10 indirizzi sono recapitabili?” oppure “quanti crediti di verifica mi restano?”
Autenticazione
OAuth usa lo standard OAuth 2.1 con PKCE e la registrazione dinamica dei client, quindi il collegamento è limitato al workspace che approvi. I token di accesso hanno una durata breve (1 ora) e i token di aggiornamento vengono ruotati; token e codici di autorizzazione vengono conservati solo come hash, e gli URI di reindirizzamento devono corrispondere esattamente. L'autenticazione con chiave API usa un bearer token (qs_live_…) nell'header Authorization. In entrambi i casi l'autenticazione è un valore esplicito nell'header, mai un cookie o una sessione.
Strumenti
Il server mette a disposizione dodici strumenti, basati sullo stesso motore dell'API REST di Qualisend e divisi in tre gruppi. Gli strumenti di verifica principali funzionano con qualsiasi piano (incluso il piano Free); gli strumenti di deliverability richiedono il piano Pro di Qualisend e il controllo blacklist richiede il componente aggiuntivo Monitoraggio blacklist. Solo i tre strumenti verify_ consumano crediti: tutto il resto è gratuito.
Verifica e pulizia
Gli strumenti di verifica principali, disponibili su tutti i piani, incluso il piano Free. I tre strumenti verify_ consumano 1 credito per indirizzo; gli strumenti di sola lettura sono gratuiti.
verify_emailverify_emailsverify_listget_credit_balanceget_verificationDeliverability e autenticazione
Diagnostica per domini di invio e messaggi. Non consuma crediti; disponibile con il piano Pro di Qualisend.
check_domaingenerate_dns_recordanalyze_email_headercheck_disposablecheck_typolookup_smtp_codeMonitoraggio della reputazione
Non consuma crediti; richiede il componente aggiuntivo Monitoraggio blacklist di Qualisend.
check_blacklistUna chiamata a verify_email restituisce l'esito locale immediato e un job_id; il test SMTP della casella si conclude qualche secondo dopo, quindi per gli indirizzi dubbi usa get_verification (o chiedi di nuovo) per avere il risultato finale.
Come sono fatti i risultati
Ogni indirizzo riceve uno dei quattro esiti (recapitabile, a rischio, non recapitabile o sconosciuto), ciascuno con un codice motivo leggibile dalle macchine, indicatori aggiuntivi (catch-all, usa e getta, generico, casella piena), il provider MX e un punteggio di affidabilità da 0 a 100. Sono gli stessi campi pubblici restituiti dall'API REST.
Crediti e limiti di richieste
Ogni verifica costa un credito, sia che l'agente controlli un indirizzo sia mille; le operazioni di lettura (get_credit_balance e get_verification) sono gratuite. Il connettore usa lo stesso saldo crediti e gli stessi limiti di richieste del tuo accesso all'API REST, quindi puoi chiedere “quanti crediti mi restano?” prima di una grande elaborazione. Il piano Free include 100 crediti che non scadono mai.
Sicurezza e privacy
Il server MCP concede esattamente ciò che approvi, niente di più.
Limitato a un solo workspace
Ogni chiamata a uno strumento è autenticata (token OAuth o chiave API) e limitata al singolo workspace che colleghi. Non c'è alcuna via d'accesso ai dati di altri clienti, alle funzioni di amministrazione o a qualsiasi sistema interno al di fuori del flusso di verifica. Il server riutilizza gli stessi controlli di autenticazione, ambito, limiti di richieste e crediti dell'API REST pubblica.
Solo l'esito pubblico
Le risposte contengono solo i campi di verifica pubblici restituiti dall'API REST: mai dettagli interni del motore, dell'infrastruttura dei test o trascrizioni SMTP oltre al risultato di deliverability. Il connettore riceve solo gli indirizzi che fornisci; non accede mai alle tue conversazioni con l'IA, alla cronologia delle chat, alla memoria dell'assistente o ai tuoi file, e gli indirizzi forniti non vengono mai usati per addestrare alcun modello di IA o di machine learning, né venduti o condivisi.
Niente cookie, niente CSRF
L'autenticazione è un token o una chiave esplicita nell'header Authorization, mai un cookie o una sessione, quindi l'endpoint non offre alcuna superficie d'attacco cross-site (CSRF). OAuth usa PKCE e la corrispondenza esatta degli URI di reindirizzamento, e token e codici vengono conservati solo come hash.
A breve scadenza e revocabile
I token di accesso OAuth hanno una durata breve (1 ora) e i token di aggiornamento vengono ruotati. Puoi revocare l'accesso in qualsiasi momento scollegando il connettore nel tuo client IA (OAuth) o revocando la chiave API nella dashboard di Qualisend.
Trattamento dei dati
Qualisend è un'azienda con sede nell'UE e i dati che fornisci vengono conservati ed elaborati nell'UE. Le elaborazioni di verifica e i relativi risultati restano nel tuo workspace finché non li elimini o chiudi l'account; puoi eliminare elaborazioni e risultati in qualsiasi momento. Non vendiamo, non noleggiamo e non condividiamo le liste che fornisci, e non le usiamo per addestrare modelli di IA o di machine learning. Tutti i dettagli (raccolta, uso, conservazione, sub-responsabili del trattamento e i tuoi diritti) sono nella nostra informativa sulla privacy, e il nostro approccio alla sicurezza è descritto nella pagina Sicurezza.
Revoca dell'accesso
Scollega il connettore nel tuo client IA per revocare un collegamento OAuth, oppure revoca la chiave API nella dashboard di Qualisend in API di verifica → API keys. I token di accesso OAuth scadono comunque da soli entro un'ora.
Assistenza
Domande o problemi? Scrivi a hello@qualisend.com. Vedi anche la panoramica su MCP con le guide alla configurazione per ogni client, la pagina API per sviluppatori e il riferimento API.
Inizia gratis con 100 crediti, poi aggiungi l'endpoint al tuo client.