Orientação de produto
MCP de Verificação de E-mail: Verificando endereços a partir de clientes de IA
Conecte um endpoint MCP de verificação de e-mail a um cliente de IA compatível, verifique até 100 endereços no chat e mantenha os resultados no momento da checagem.
Como conectar o endpoint MCP do EmailCheckPro a um cliente de IA compatível, quais ferramentas ele expõe e como ler os resultados de entregabilidade dentro de uma conversa.
Um endpoint MCP de verificador de e-mail permite que um cliente de IA compatível chame uma verificação de entregabilidade como uma ferramenta, para que um assistente possa verificar endereços durante uma conversa, em vez de alguém copiá-los para um painel separado. O EmailCheckPro publica seu endpoint MCP em https://emailcheckpro.com/mcp. Ele expõe quatro ferramentas: listar produtos, verificar um endereço, verificar até 100 endereços e obter o saldo da conta. Cada resultado concluído informa se um endereço estava entregável ou não entregável no momento da verificação. Arquivos preparados grandes ainda passam pelo fluxo de trabalho da Web ou pela API REST, pois nenhuma ferramenta de arquivo em lote está documentada para MCP.
O que uma conexão MCP de verificador de e-mail faz
O Model Context Protocol é um padrão aberto que permite que uma aplicação de IA descubra ferramentas em um servidor e as chame com entradas estruturadas. De acordo com a especificação de ferramentas MCP, um servidor lista suas ferramentas com nomes e esquemas de entrada, e o cliente decide quando invocá-las, muitas vezes com um humano capaz de revisar a chamada.
Para a qualidade de dados de e-mail, isso significa que um assistente trabalhando em uma lista de contatos, um ticket de suporte ou uma planilha colada no chat pode perguntar ao verificador diretamente. O modelo não julga se um endereço parece plausível; ele passa o endereço para a ferramenta e relata o resultado retornado.
Um endpoint MCP de verificador de e-mail não envia nada para o endereço que está sendo verificado e não notifica seu proprietário. Ele retorna apenas um resultado de entregabilidade, o que mantém a conexão restrita: sem acesso à caixa de entrada e sem mensagens de saída.
Conectando o endpoint MCP do EmailCheckPro
A maioria dos clientes que suportam servidores MCP remotos segue um padrão semelhante. O guia do MCP para servidores remotos usa conectores personalizados do Claude como exemplo:
- Abra as configurações do cliente e encontre a seção de conectores ou servidores MCP.
- Adicione um conector personalizado e cole a URL completa do endpoint, incluindo
https://:https://emailcheckpro.com/mcp. - Conclua a etapa de autenticação que o cliente apresenta, usando as credenciais de uma conta do EmailCheckPro.
- Revise a lista de ferramentas e habilite apenas as ferramentas que o fluxo de trabalho precisa.
- Execute um teste com um único endereço conhecido antes de usá-lo em listas reais.
A visão geral da arquitetura MCP explica como clientes e servidores trocam chamadas de ferramentas caso sua equipe precise revisar a integração. Os nomes exatos dos menus diferem entre os clientes e mudam com o tempo, portanto, siga a documentação atual do seu cliente para as etapas um e três. As verificações feitas através do MCP utilizam o mesmo saldo da conta que as verificações da Web e da API REST.
As quatro ferramentas e quando um assistente deve chamá-las
| Ferramenta | O que ela faz | Prompt típico |
|---|---|---|
| list_products | Lista os produtos de verificação disponíveis | "Quais verificações de e-mail esta conta pode executar?" |
| check_number | Verifica um endereço de e-mail | "O endereço jane@example.org está entregável agora?" |
| check_numbers | Verifica de 1 a 100 endereços em uma chamada | "Verifique estes 40 endereços da planilha do evento." |
| get_balance | Retorna o saldo da conta | "Quanto saldo resta antes deste lote?" |
A ferramenta de endereço único usa o nome check_number embora aceite um endereço de e-mail; esse é simplesmente o nome da ferramenta documentado.
Duas opções de produto estão por trás dessas chamadas. A Verificação de entregabilidade de e-mail funciona para endereços em praticamente qualquer domínio. A Verificação de avatar de e-mail adiciona um sinal de avatar público, mas apenas para endereços Gmail, Yandex e Mail.ru, e um domínio não suportado é rejeitado antes de uma cobrança em tempo real. Pedir ao assistente para chamar a ferramenta de saldo antes de uma solicitação maior de vários endereços é um hábito simples que evita surpresas no meio da tarefa.
Lendo resultados dentro de uma conversa
Um assistente resume a saída da ferramenta em linguagem natural, portanto, instrua-o a manter as categorias intactas. Um prompt útil é: "Relate cada endereço como entregável, não entregável, indeterminado, inválido ou falha, e mantenha a ordem de entrada."
As categorias significam coisas diferentes:
- Entregável: o endereço poderia receber e-mail no momento da verificação.
- Não entregável: o endereço não poderia receber e-mail no momento da verificação.
- Indeterminado: geralmente um domínio catch-all; nenhum veredito foi retornado e a verificação não é cobrada.
- Inválido: a entrada não era um endereço completo com uma parte local, um sinal @ e um domínio.
- Falha: nenhum resultado concluído foi retornado; tente novamente mais tarde.
Resultados de vários endereços preservam a ordem de entrada, o que facilita colá-los de volta em uma planilha. Um endereço sem um resultado concluído não é o mesmo que um não entregável. Peça ao assistente para listar esses separadamente em vez de agrupá-los em uma recomendação de limpeza.
Limites, escala e design de fluxo de trabalho seguro
Para arquivos preparados com milhares de endereços, use o fluxo de trabalho em lote da Web ou o endpoint de tarefa em lote da API REST, POST /api/v1/bulk-tasks, que é executado de forma assíncrona e retorna um CSV. Limites por produto se aplicam; consulte a documentação da API em emailcheckpro.com/api-docs para obter os números atuais.
Algumas práticas mantêm as verificações orientadas por IA previsíveis:
- Mantenha um humano revisando qualquer ação que o assistente proponha com base nos resultados, como remover contatos.
- Evite pedir ao modelo para adivinhar um resultado quando uma chamada de ferramenta falha; peça para ele tentar novamente ou relatar a falha.
- Trate um resultado entregável como um sinal do momento da verificação.
- Armazene os resultados com a data da verificação para que revisões posteriores saibam quão recentes eles são.
FAQ
Como as equipes podem decidir entre o MCP e a API REST para verificações de e-mail?
Use o MCP quando uma pessoa estiver trabalhando interativamente em um cliente de IA e precisar de respostas sobre alguns endereços ou uma lista curta. Use a API REST quando as verificações forem executadas dentro de uma aplicação, um trabalho agendado ou um pipeline sem uma interface de chat. Ambos utilizam o mesmo saldo da conta. Para arquivos preparados grandes, o endpoint de tarefa em lote da API REST ou o fluxo de trabalho da Web é a rota documentada, já que nenhuma ferramenta de arquivo em lote existe no MCP.
Quais clientes de IA podem se conectar ao endpoint?
Qualquer cliente que suporte servidores MCP remotos via HTTPS geralmente pode adicionar o endpoint como um conector personalizado ou entrada de servidor. O suporte e os nomes dos menus variam de acordo com o cliente e a versão, portanto, verifique a documentação do próprio cliente. Após conectar, confirme se as quatro ferramentas aparecem e execute uma verificação de endereço único como um teste básico antes de confiar na conexão para trabalho real.
O assistente pode verificar endereços Outlook ou Yahoo através do MCP?
Para entregabilidade, sim: a Verificação de entregabilidade de e-mail aceita endereços em praticamente qualquer domínio, incluindo os principais provedores de webmail e domínios de empresas. O sinal de avatar público é mais restrito. A Verificação de avatar de e-mail suporta apenas endereços Gmail, Yandex e Mail.ru, portanto, prompts que solicitam avatares em outros domínios devem ser redirecionados para uma verificação de entregabilidade simples.
Saiba mais
Escolha as informações do produto que se ajustam à próxima etapa do seu fluxo de trabalho.