Bot de Registro: Código Claude + Email Temporário

Seu agente preenche o campo de nome, gera uma senha, clica em "Criar conta" — e bate na parede: Verifique sua caixa de entrada para verificar seu email. Sem API para consultar. Sem webhook para registrar. O código de verificação está em uma caixa de entrada que apenas um humano pode acessar, e o loop do agente morre.

A solução é mecânica: dê ao Código Claude uma caixa de entrada descartável que ele possua e possa consultar. Este guia cobre todo o fluxo — criação de caixa de entrada, envio de formulário, consulta de email, extração de OTP e link — usando o servidor MCP UnCorreoTemporal.

Por que a automação de registro precisa de uma caixa de entrada real

Três modos de falha aparecem de forma confiável quando as equipes tentam codificar ou compartilhar endereços de email em bots de registro.

Contaminação de execução paralela. Uma caixa de entrada compartilhada qa@company.com recebe OTPs de dez trabalhos de teste concorrentes ao mesmo tempo. Não há uma maneira confiável de atribuir um código à execução que o acionou. Testes instáveis seguem.

Rejeição silenciosa. Muitos serviços validam o domínio do email no cadastro e rejeitam provedores gratuitos conhecidos, endereços catch-all e endereços que correspondem a padrões como gerados por máquinas. Um endereço codificado funciona em todos os lugares ou é bloqueado sem caminho de recuperação.

Sobrecarga de gerenciamento de credenciais. Ler uma caixa de entrada real programaticamente requer OAuth 2.0, atualização de token, permissões específicas e manutenção contínua. Esse custo é desproporcional para um trabalho de CI que roda a cada commit.

Caixas de entrada por fluxo criadas sob demanda via create_signup_inbox eliminam todos os três. Cada execução recebe um endereço fresco que vive durante a duração do fluxo. Sem estado compartilhado, sem configuração de credenciais.

Pré-requisitos

Este guia assume que você tem:

• Código Claude instalado (npm install -g @anthropic-ai/claude-code)
• uv instalado para rodar o servidor MCP
• O servidor UCT MCP já configurado — configuração completa em uncorreotemporal.com/en/docs/mcp/

O comando de configuração em uma linha:

claude mcp add uncorreotemporal \
  -e UCT_API_KEY=uct_your_key_here \
  -- uvx uncorreotemporal-mcp

Confirme que foi carregado executando /tools em uma nova sessão do Código Claude. Você deve ver create_signup_inbox, wait_for_verification_email, extract_otp_code, extract_verification_link, e complete_signup_flow na lista.

Passo 1 — Crie uma caixa de entrada temporária via MCP

Antes de tocar no formulário de cadastro, o agente cria uma caixa de entrada dedicada. Esta é sempre a primeira chamada de ferramenta:

Ferramenta: create_signup_inbox
Entrada: {
  "service_name": "app.example.com"
}
Saída: {
  "inbox_id":     "mx_abc123@mail.uncorreotemporal.com",
  "email":        "mx_abc123@mail.uncorreotemporal.com",
  "expires_at":   "2026-05-12T11:30:00Z",
  "service_name": "app.example.com"
}

service_name é um rótulo para sua referência — não afeta o roteamento, mas facilita a depuração ao executar vários fluxos. O email retornado é o endereço a ser usado no formulário de registro. A caixa de entrada está ativa imediatamente após esta chamada; sem atraso de propagação.

O TTL padrão é de 30 minutos. Um loop de registro completo roda em menos de 60 segundos — mais do que suficiente espaço.

Passo 2 — Navegue até o formulário de cadastro e preencha os campos

Com o endereço da caixa de entrada em contexto, o Código Claude preenche o formulário de registro. O mecanismo exato depende do alvo — automação de navegador, chamada de API, o que se encaixar — mas a estrutura do prompt é consistente:

Registre uma conta gratuita em app.example.com usando:
- Email: mx_abc123@mail.uncorreotemporal.com
- Nome: Alex Developer
- Senha: TempP@ss2026!

Preencha todos os campos obrigatórios e envie o formulário. Pare após enviar.
Não prossiga para a verificação de email ainda.

Mantenha o registro e a consulta de email como instruções separadas. Quando o registro falha, você quer um ponto de parada limpo — não um agente já consultando uma caixa de entrada que nunca receberá email.

Passo 3 — Envie o formulário e aguarde o email de verificação

Uma vez que o formulário é enviado, o agente aguarda o email de entrada com uma única chamada bloqueante:

Ferramenta: wait_for_verification_email
Entrada: {
  "inbox_id":        "mx_abc123@mail.uncorreotemporal.com",
  "timeout_seconds": 90
}

// Email chegou:
Saída: {
  "status":       "recebido",
  "message_id":   "msg_9x2p1q",
  "subject":      "Verifique sua conta",
  "from_address": "noreply@app.example.com",
  "received_at":  "2026-05-12T11:01:34Z"
}

// 
Contexto Triplo Up
A automação de registros pode otimizar processos para empresas brasileiras, reduzindo falhas e melhorando a eficiência em testes de software. O uso de inboxes temporários elimina problemas comuns de compartilhamento de credenciais e gerenciamento de emails.