Skip to content
Inizia con 100 crediti di verifica gratuiti
Qualisend

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.

Endpoint MCP
https://app.qualisend.com/api/mcp

Opzione 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.

Strumento
Cosa fa
Costo
verify_email
email
Verifica un indirizzo (sintassi, dominio/MX, rilevamento di indirizzi usa e getta e generici, suggerimento in caso di errore di battitura e raggiungibilità della casella) e fornisce un esito recapitabile / a rischio / non recapitabile / sconosciuto, con un codice motivo e un punteggio di affidabilità da 0 a 100. Restituisce un esito immediato e un job_id; il test SMTP si conclude qualche secondo dopo.1 credito
verify_emails
emails[] (1-50)
Verifica in modo sincrono un gruppo di massimo 50 indirizzi e restituisce un esito per ciascuno.1 credito ciascuno
verify_list
emails[] (1-1000)
Verifica in modo asincrono una lista grande, fino a 1.000 indirizzi: crea un'unica elaborazione e restituisce un job_id. Interroga get_verification per conoscere l'avanzamento e ottenere un riepilogo dei risultati.1 credito ciascuno
get_credit_balance
-
Quanti crediti di verifica restano al tuo workspace.Gratuito
get_verification
job_id
Recupera lo stato o il risultato di una verifica tramite job_id: il test SMTP si conclude dopo l'esito immediato.Gratuito

Deliverability e autenticazione

Diagnostica per domini di invio e messaggi. Non consuma crediti; disponibile con il piano Pro di Qualisend.

Strumento
Cosa fa
Costo
check_domain
domain
Controlla se un dominio è configurato per raggiungere la posta in arrivo: i suoi server di posta (MX), l'autenticazione SPF e DMARC e cosa manca. Un check-up della deliverability di un dominio di invio.Gratuito
generate_dns_record
type, domain, …
Genera il record DNS esatto di cui un dominio ha bisogno per l'autenticazione email (SPF, DMARC, BIMI o MTA-STS), pronto da copiare nel DNS, con l'indicazione di dove inserirlo.Gratuito
analyze_email_header
raw
Analizza le intestazioni grezze di un'email per mostrare il percorso seguito, i tempi di ogni passaggio e se ha superato i controlli SPF/DKIM/DMARC e antispam, così da capire perché un messaggio è arrivato in ritardo o è finito nello spam. Incolla il sorgente del messaggio (“Show original”).Gratuito
check_disposable
email
Indica se un indirizzo è una casella usa e getta/temporanea, un indirizzo generico (info@, support@) o un indirizzo di posta gratuito per privati (es. Gmail).Gratuito
check_typo
email
Individua un probabile errore di battitura nel dominio di un indirizzo (es. gmial.com) e suggerisce quello corretto.Gratuito
lookup_smtp_code
code
Spiega in parole semplici un codice di risposta o di errore di un server di posta (es. 550 o 5.1.1) e se si tratta di un intoppo temporaneo o di un errore permanente.Gratuito

Monitoraggio della reputazione

Non consuma crediti; richiede il componente aggiuntivo Monitoraggio blacklist di Qualisend.

Strumento
Cosa fa
Costo
check_blacklist
target
Controlla se un dominio di invio o un IP è presente in una delle principali blacklist email (Spamhaus, SpamCop, Barracuda e altre): un'istantanea della reputazione in quel preciso momento.Gratuito

Una 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.

Tutto pronto per il collegamento?

Inizia gratis con 100 crediti, poi aggiungi l'endpoint al tuo client.