Conecte seu assistente de IA ao Unbox

Visão geral

O Unbox MCP é para proprietários de contas pessoais que desejam um assistente de IA — no Cursor, Workbuddy, OpenClaw ou qualquer host compatível com MCP — para trabalhar com seu e-mail hospedado. Não é uma API de desenvolvedor para criar aplicativos no Unbox; para envios transacionais do seu domínio, consulte a documentação da nossa API HTTP.

O que os agentes podem fazer

Após fazer login, seu agente pode chamar as ferramentas do Unbox em seu nome:

• Ler caixa de entrada e conversas — Listar conversas, abrir uma conversa e buscar mensagens individuais.
• Pesquisar e-mails — Encontrar mensagens em sua caixa de entrada com consultas em linguagem natural.
• Enviar e responder — Compor novo e-mail ou responder a uma conversa a partir de seus endereços Unbox, sujeito aos limites de envio do seu plano.
• Organizar — Marcar como spam, restaurar do spam, mover para a lixeira ou restaurar — uma mensagem de cada vez.

Limpeza em massa de spam ou lixeira, geração de chave de API e ações de espaço de trabalho em equipe não estão disponíveis via MCP na v1.

Como funciona

Seu cliente de IA se conecta ao servidor Unbox MCP. O servidor chama as APIs da conta Unbox usando uma sessão web normal — o mesmo tipo que você obtém ao fazer login em unbox.im.

1. Adicione o Unbox à configuração do seu cliente MCP (veja Configuração abaixo).
2. Peça ao seu agente para fazer login — ele abre um link no navegador onde você aprova o acesso com sua conta Unbox.
3. Uma vez conectado, peça ao seu agente para ler e-mails, redigir respostas ou organizar mensagens.

Entrar

O Unbox usa login no navegador para que você sempre aprove o acesso. Seu agente inicia o fluxo com as ferramentas de login, e então você conclui o login no navegador:

1. Seu agente chama unbox_login_start e mostra a você uma URL do navegador.
2. Abra o link, faça login no Unbox se necessário e copie o código de link único exibido na página.
3. Cole o código de volta para seu agente (unbox_login_complete).
4. Sua sessão permanece ativa pelo período normal de sessão web do Unbox — faça login novamente quando expirar.

URL de login (para referência)

https://unbox.im/pt/auth/desktop/link?source=mcp

Precisa de uma conta primeiro? Crie seu Unbox ID e depois volte para conectar seu agente.

Configuração

Adicione o Unbox como um servidor MCP no seu cliente de IA. O transporte HTTP remoto é a maneira mais simples de conectar-se à nuvem Unbox:

HTTP remoto (recomendado)

Aponte seu cliente MCP para o endpoint MCP do Unbox. Após adicionar o servidor, use as ferramentas de login para autenticar:

{
  "mcpServers": {
    "unbox": {
      "url": "https://unbox.im/api/mcp"
    }
  }
}

O HTTP MCP pode estar desabilitado em algumas implantações até ser ativado pelo operador. Se a conexão falhar, tente novamente mais tarde ou entre em contato com o suporte.

Ferramentas comuns

Após fazer login, seu agente pode usar ferramentas como:

• unbox_login_start — abrir login no navegador
• unbox_login_complete — trocar código de link por sessão
• unbox_list_threads — feed da caixa de entrada
• unbox_search_inbox — pesquisar mensagens
• unbox_reply_to_email — responder a uma mensagem
• unbox_send_email — enviar novo e-mail

Clientes suportados

Qualquer host de agente compatível com MCP pode se conectar ao Unbox. Testamos e documentamos:

• Cursor — Adicione o Unbox em servidores MCP nas configurações do Cursor e faça login através do fluxo do navegador.
• Workbuddy — Configure uma URL de servidor MCP remoto apontando para o Unbox e autentique-se com sua conta.
• OpenClaw — Conecte o OpenClaw ao endpoint HTTP MCP do Unbox e complete o login no navegador.

Segurança

• Login no navegador — Você faz login através do Unbox no seu navegador — os agentes nunca veem sua senha.
• Apenas o proprietário da conta — O acesso MCP é limitado ao proprietário da conta pessoal, não a membros da equipe ou espaços de trabalho compartilhados.
• Mesmos limites do aplicativo web — As cotas de envio, regras de spam e política transacional se aplicam às ações do agente da mesma forma que na interface da caixa de entrada.
• Sem exclusão em massa — Os agentes não podem esvaziar a lixeira de spam, esvaziar a lixeira ou rotacionar chaves de API através do MCP na v1.