Servidor MCP da Qualisend
O servidor MCP (Model Context Protocol) da Qualisend permite que um agente de IA verifique endereços de e-mail, limpe listas e faça checagens de entregabilidade do domínio de envio pela Qualisend, no Claude, no ChatGPT, no Grok ou em qualquer cliente compatível com MCP, sem código e sem exportar CSV. Esta página explica como conectá-lo, como funciona a autenticação, quais são as doze ferramentas que ele oferece e como ele trata seus dados.
- Endpoint
- https://app.qualisend.com/api/mcp
- Transporte
- Streamable HTTP (JSON-RPC 2.0), sem estado
- Autenticação
- OAuth 2.1 (recomendado) ou uma chave de API da Qualisend
- Nome no registro
- com.qualisend/email-verification
Requisitos
- Uma conta na Qualisend. O plano Free inclui 100 créditos de verificação que nunca expiram.
- Um cliente compatível com MCP: Claude, ChatGPT, Grok, Cursor, VS Code, Claude Code, Codex CLI, Gemini CLI, Zed, Goose, Windsurf ou similares. Cada um tem um guia de configuração passo a passo.
Como conectar o servidor
Adicione o endpoint abaixo como conector personalizado no seu cliente e depois autentique com o login em um clique ou com uma chave de API.
https://app.qualisend.com/api/mcpOpção A: login (OAuth 2.1)
É a opção recomendada. Sem chaves para copiar: seu cliente abre uma página “Conectar Qualisend” onde você faz login e aprova o acesso a um workspace.
- Claude: Customize → Connectors → Add custom connector → cole o endpoint → Add e aprove. (guia completo)
- ChatGPT: Settings → Security and login → Developer mode e depois crie um app MCP personalizado em chatgpt.com/plugins. (guia completo)
- Grok: grok.com/connectors → New Connector → Custom → cole o endpoint. (guia completo)
Os três são feitos para o login, e não para uma chave colada. Os clientes de desenvolvimento (Claude Code, Cursor, VS Code, Zed, Goose, Codex CLI e Gemini CLI) aceitam as duas opções.
Opção B: chave de API
Prefere uma credencial estática? Em qualquer cliente que consiga enviar um cabeçalho de requisição, crie uma chave no seu painel em API de verificação → API keys e passe-a como bearer token:
Authorization: Bearer qs_live_…Depois de conectar, é só pedir: “verifique sales@acme.com”, “esses 10 endereços são entregáveis?” ou “quantos créditos de verificação ainda tenho?”
Autenticação
O OAuth usa o padrão OAuth 2.1 com PKCE e registro dinâmico de clientes, então a conexão fica restrita ao workspace que você aprovar. Os tokens de acesso têm vida curta (1 hora) e os tokens de atualização são rotacionados; tokens e códigos de autorização são armazenados apenas como hashes, e as URIs de redirecionamento precisam corresponder exatamente. A autenticação por chave de API usa um bearer token (qs_live_…) no cabeçalho Authorization. Em qualquer caso, a autenticação é um valor explícito de cabeçalho, nunca um cookie ou uma sessão.
Ferramentas
O servidor oferece doze ferramentas, ligadas ao mesmo mecanismo da API REST da Qualisend, em três grupos. As ferramentas principais de verificação funcionam em qualquer plano (inclusive no plano Free); as ferramentas de entregabilidade exigem o plano Pro da Qualisend, e a checagem de listas negras exige o complemento Monitoramento de blacklist. Só as três ferramentas verify_ consomem créditos: todo o resto é gratuito.
Verificação e limpeza
As principais ferramentas de verificação, disponíveis em todos os planos, inclusive no plano Free. As três ferramentas verify_ consomem 1 crédito por endereço; as de leitura são gratuitas.
verify_emailverify_emailsverify_listget_credit_balanceget_verificationEntregabilidade e autenticação
Diagnóstico de domínios de envio e de mensagens. Não consome créditos; disponível no plano Pro da Qualisend.
check_domaingenerate_dns_recordanalyze_email_headercheck_disposablecheck_typolookup_smtp_codeMonitoramento de reputação
Não consome créditos; exige o complemento Monitoramento de blacklist da Qualisend.
check_blacklistUma chamada a verify_email retorna o veredito local imediato e um job_id; a sondagem SMTP da caixa de e-mail termina alguns segundos depois, então use get_verification (ou simplesmente pergunte de novo) para obter o resultado final de endereços duvidosos.
Como são os resultados
Cada endereço recebe um de quatro vereditos (entregável, arriscado, não entregável ou desconhecido), cada um com um código de motivo legível por máquina, sinalizadores adicionais (catch-all, descartável, de função, caixa cheia), o provedor MX e uma pontuação de confiança de 0 a 100. São os mesmos campos públicos que a API REST retorna.
Créditos e limites de taxa
Cada verificação custa um crédito, seja de um endereço ou de mil; as leituras (get_credit_balance e get_verification) são gratuitas. O conector usa o mesmo saldo de créditos e os mesmos limites de taxa do seu acesso à API REST, então você pode perguntar “quantos créditos restam?” antes de um job grande. O plano Free inclui 100 créditos que nunca expiram.
Segurança e privacidade
O servidor MCP concede exatamente o que você aprova, nada além disso.
Restrito a um workspace
Toda chamada de ferramenta é autenticada (token OAuth ou chave de API) e restrita ao único workspace que você conectar. Não há caminho para os dados de outro cliente, para funções de administrador ou para qualquer sistema interno além do fluxo de verificação. O servidor reutiliza as mesmas checagens de autenticação, escopo, limite de taxa e créditos da API REST pública.
Só o veredito público
As respostas contêm apenas os campos públicos de verificação que a API REST retorna: nunca detalhes internos do mecanismo, da infraestrutura de sondagem ou transcrições SMTP além do resultado de entregabilidade. O conector recebe apenas os endereços que você envia; ele nunca acessa suas conversas com a IA, o histórico de chat, a memória do assistente ou seus arquivos, e os endereços enviados nunca são usados para treinar nenhum modelo de IA ou de aprendizado de máquina, nem vendidos ou compartilhados.
Sem cookies, sem CSRF
A autenticação é um token ou uma chave explícita no cabeçalho Authorization, nunca um cookie ou uma sessão, então o endpoint não tem superfície de ataque cross-site (CSRF). O OAuth usa PKCE e correspondência exata de URI de redirecionamento, e tokens e códigos são armazenados apenas como hashes.
Vida curta e revogável
Os tokens de acesso OAuth têm vida curta (1 hora) e os tokens de atualização são rotacionados. Revogue o acesso a qualquer momento desconectando o conector no seu cliente de IA (OAuth) ou revogando a chave de API no painel da Qualisend.
Tratamento de dados
A Qualisend é uma empresa sediada na UE, e os dados que você envia são armazenados e processados na UE. Os jobs de verificação e seus resultados ficam no seu workspace até você excluí-los ou encerrar sua conta; você pode excluir jobs e resultados a qualquer momento. Não vendemos, não alugamos e não compartilhamos as listas que você envia, e não as usamos para treinar modelos de IA ou de aprendizado de máquina. Todos os detalhes (coleta, uso, retenção, prestadores de serviço terceirizados que tratam dados e seus direitos) estão na Política de Privacidade, e nossa postura de segurança está na página Segurança.
Como revogar o acesso
Desconecte o conector no seu cliente de IA para revogar uma conexão OAuth, ou revogue a chave de API no painel da Qualisend em API de verificação → API keys. Os tokens de acesso OAuth também expiram sozinhos em até uma hora.
Suporte
Dúvidas ou problemas? Envie um e-mail para hello@qualisend.com. Veja também a visão geral do MCP e os guias de configuração por cliente, a API para desenvolvedores e a referência da API.
Comece grátis com 100 créditos e depois adicione o endpoint ao seu cliente.