Como Dar ao Seu Agente de IA Seu Próprio Endereço de Email (Gratuito, Sem Configuração)

Agentes de IA que interagem com o mundo real precisam de endereços de e-mail reais. Seja para que seu agente se inscreva em serviços, receba códigos de verificação ou gerencie conversas com clientes — ele precisa de sua própria caixa de entrada.

KeyID fornece a cada agente um endereço de e-mail real em uma chamada de API. Sem configuração humana, sem configuração de domínio, sem chaves de API para provisionar antecipadamente. Grátis para 1.000 contas.

O que você irá construir

Ao final deste tutorial, seu agente de IA será capaz de:

1. Auto-provisionar um endereço de e-mail real
2. Enviar e receber e-mails
3. Extrair códigos de verificação automaticamente
4. Completar inscrições em sites de ponta a ponta
5. Gerar códigos TOTP 2FA

Opção A: MCP (Claude, Cursor, Windsurf)

Se você estiver usando um cliente compatível com MCP, não precisa escrever nenhum código. Basta conectar o servidor KeyID MCP.

Hospedado (recomendado — zero instalação)

Adicione isso à configuração do seu cliente MCP:

{
  "mcpServers": {
    "keyid": {
      "url": "https://keyid.ai/mcp"
    }
  }
}

É isso. Seu agente agora tem acesso a 47 ferramentas para e-mail, SMS, verificação e fluxos de inscrição.

Local (stdio)

{
  "mcpServers": {
    "keyid": {
      "command": "npx",
      "args": ["-y", "@keyid/agent-kit"]
    }
  }
}

O que seu agente pode fazer via MCP

Uma vez conectado, seu agente obtém ferramentas como:

• keyid_provision — obtenha um endereço de e-mail instantaneamente
• keyid_get_inbox / keyid_get_message — leia e-mails recebidos
• keyid_send / keyid_reply — envie e-mail
• keyid_get_codes — extraia códigos de verificação OTP de uma mensagem
• keyid_get_links / keyid_follow_link — extraia e siga links de verificação
• keyid_start_registration_session — inicie um fluxo de inscrição rastreado
• keyid_generate_totp_code — gere códigos 2FA

Ele também vem com prompts pré-construídos para fluxos de trabalho comuns:

set-up-agent-communications    → Provisionar e-mail, obter identidade
complete-email-verification    → Aguardar código/link, extrair
run-signup-session             → Fluxo de inscrição completo com estado do navegador
autonomous-signup              → Criar persona, inscrever-se, registrar resultado
fetch-latest-code              → Obter o código de verificação mais recente
triage-inbox                   → Listar mensagens, destacar as urgentes

Opção B: SDK JavaScript/TypeScript

npm install @keyid/sdk

Provisionar um e-mail

import { KeyID } from '@keyid/sdk';

const agent = new KeyID();

// Uma chamada — o agente obtém um endereço de e-mail real
const { email, agentId } = await agent.provision();
console.log(`E-mail do agente: ${email}`);
// → agent_7x2k@hushhavenglow.com

Não é necessária chave de API. O agente gera um par de chaves Ed25519 localmente e se autentica via desafio-resposta.

Ler a caixa de entrada

const { messages } = await agent.getInbox();

for (const msg of messages) {
  console.log(`De: ${msg.from} | Assunto: ${msg.subject}`);
}

// Pesquisar e-mails específicos
const results = await agent.getInbox({ search: 'verificação' });

Extrair códigos de verificação

// Obter códigos OTP de uma mensagem
const { codes } = await agent.getCodes(messageId);
console.log.log(`Códigos: ${codes}`);