MCP Server

Model Context Protocol (MCP) é um protocolo aberto da Anthropic que permite que modelos de IA interajam de forma segura com ferramentas externas e fontes de dados. Através do MCP, você pode permitir que o Claude verifique e-mails diretamente usando linguagem natural.

O Que é MCP?

MCP permite que modelos de IA:

• Chamem ferramentas e APIs externas
• Acessem arquivos e dados locais
• Executem tarefas específicas

Para EmailVerify: Os usuários podem verificar e-mails usando linguagem natural sem chamar APIs manualmente.

Clientes Suportados

Configuração Rápida

Passo 1: Obter Chave API

Visite o Painel EmailVerify para criar sua chave API.

Passo 2: Configurar Claude Desktop

Edite o arquivo de configuração:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "emailverify": {
      "command": "npx",
      "args": ["-y", "@emailverify/mcp-server"],
      "env": {
        "EMAILVERIFY_API_KEY": "your-api-key-here"
      }
    }
  }
}

Passo 3: Reiniciar Claude Desktop

Após reiniciar, você pode simplesmente dizer:

"Verifique se john@company.com é um e-mail válido"

Configuração do Claude Code

Para Claude Code, adicione o servidor MCP à sua configuração:

claude mcp add emailverify -- npx -y @emailverify/mcp-server

Ou adicione ao seu ~/.claude/claude_code_config.json:

{
  "mcpServers": {
    "emailverify": {
      "command": "npx",
      "args": ["-y", "@emailverify/mcp-server"],
      "env": {
        "EMAILVERIFY_API_KEY": "your-api-key-here"
      }
    }
  }
}

Configuração do Cursor

No Cursor, vá para Settings > MCP e adicione:

{
  "emailverify": {
    "command": "npx",
    "args": ["-y", "@emailverify/mcp-server"],
    "env": {
      "EMAILVERIFY_API_KEY": "your-api-key-here"
    }
  }
}

Ferramentas Disponíveis

verify_email

Verifica um único endereço de e-mail.

Parâmetros:

Retorna:

• Status do e-mail (valid/invalid/unknown)
• Entregabilidade
• Se é um e-mail descartável
• Se é um e-mail baseado em função
• Pontuação de confiança

Exemplo de uso no Claude:

"Verifique se test@example.com é um e-mail válido"

verify_emails_bulk

Verifica múltiplos endereços de e-mail de uma vez.

Parâmetros:

Retorna:

• job_id: Identificador do trabalho
• status: Status de processamento
• total: Contagem total
• processed: Contagem processada

Exemplo de uso no Claude:

"Verifique estes e-mails: user1@example.com, user2@test.com, info@company.com"

check_credits

Verifica saldo da conta e limites de taxa.

Parâmetros: Nenhum

Retorna:

• Créditos restantes
• Informações de limite de taxa
• Detalhes do plano

Exemplo de uso no Claude:

"Quantos créditos de verificação me restam?"

Exemplos de Uso

Verificação Básica

Usuário:

Verifique john@google.com

Claude:

Vou verificar esse endereço de e-mail para você.

Resultado da Verificação de E-mail

Campo	Valor
E-mail	john@google.com
Status	Válido
Entregável	Sim
Descartável	Não
Pontuação	0.95

Este e-mail parece ser válido e entregável.

Verificação de Múltiplos E-mails

Usuário:

Verifique estes e-mails: john@google.com, test@mailinator.com, support@microsoft.com

Claude:

Vou verificar todos os três endereços de e-mail.

E-mail	Status	Notas
john@google.com	Válido	Entregável, e-mail corporativo
test@mailinator.com	Inválido	E-mail descartável, recomendo rejeitar
support@microsoft.com	Válido	Endereço baseado em função, pode ser compartilhado

Recomendações:

• john@google.com - Seguro para usar
• test@mailinator.com - E-mail temporário, não recomendado
• support@microsoft.com - Válido mas provavelmente uma caixa de entrada de equipe

Fluxo de Trabalho do Desenvolvedor

Usuário (no Claude Code):

Verifique os e-mails de teste no meu arquivo .env.example

Claude:

Vou ler o arquivo e verificar quaisquer endereços de e-mail encontrados.

Encontrados 3 endereços de e-mail em .env.example:

• TEST_EMAIL=user@example.com
• ADMIN_EMAIL=admin@company.com
• SUPPORT_EMAIL=help@temp-mail.org

Resultados da verificação:

E-mail	Status
user@example.com	Desconhecido (domínio de exemplo)
admin@company.com	Válido
help@temp-mail.org	Inválido (descartável)

Considere usar endereços de e-mail reais para testes.

Formato de Saída

O servidor MCP retorna resultados bem formatados:

## Resultado da Verificação de E-mail

**E-mail:** test@example.com
**Status:** VÁLIDO
**Pontuação de Confiança:** 95.0%

### Detalhes
| Verificação | Resultado |
|-------------|-----------|
| Entregável | Sim |
| Formato Válido | Sim |
| Domínio Válido | Sim |
| MX Válido | Sim |
| Descartável | Não |
| Endereço de Função | Não |
| Catch-all | Não |
| Provedor Gratuito | Não |

**Créditos Usados:** 1

Melhores Práticas

1. Armazene a Chave API com Segurança

Nunca codifique sua chave API diretamente. Use variáveis de ambiente:

{
  "env": {
    "EMAILVERIFY_API_KEY": "${EMAILVERIFY_API_KEY}"
  }
}

2. Use Linguagem Natural

O servidor MCP entende várias formulações:

• "Verifique user@example.com"
• "test@company.com é um e-mail válido?"
• "Verifique se este e-mail é entregável: john@test.com"
• "Você pode validar estes endereços de e-mail para mim?"

3. Processe em Lote Quando Possível

Para múltiplos e-mails, peça ao Claude para verificá-los juntos para maior eficiência:

"Verifique todos estes e-mails de uma vez: email1@test.com, email2@test.com, email3@test.com"

Solução de Problemas

Servidor MCP Não Encontrado

Se o Claude disser que não consegue encontrar a ferramenta EmailVerify:

1. Verifique o caminho do arquivo de configuração
2. Certifique-se de que o JSON é válido
3. Reinicie o Claude Desktop completamente
4. Verifique se sua chave API está correta

Erros de Limite de Taxa

Se você vir erros de limite de taxa:

1. Verifique seus créditos restantes com "Quantos créditos eu tenho?"
2. Aguarde um momento e tente novamente
3. Considere atualizar seu plano para limites mais altos

Problemas de Conexão

Se a verificação falhar:

1. Verifique sua conexão com a internet
2. Verifique se sua chave API é válida
3. Tente uma verificação simples primeiro

FAQ

Minha chave API está segura?

Sim. A chave API é armazenada em seu arquivo de configuração local e usada apenas pelo servidor MCP executando em sua máquina. Nunca é enviada para terceiros.

Quais clientes de IA suportam MCP?

Qualquer cliente compatível com MCP funciona, incluindo Claude Desktop, Claude Code, Cursor, Zed, Cline e Continue.

O que acontece quando estou offline?

Se a API EmailVerify estiver inacessível, a ferramenta retorna uma mensagem de erro. Isso não afeta as outras capacidades do Claude.

Como funcionam os créditos?

Cada verificação de e-mail usa 1 crédito. Verificações em massa usam 1 crédito por e-mail. Verifique seu saldo com a ferramenta check_credits.

Próximos Passos