mailbox.bot

Conecte qualquer cliente de IA compatível com MCP ao mailbox.bot usando o Model Context Protocol (MCP). Seu agente recebe 19 ferramentas para envio de correspondência, contexto digital/OCR encaminhado, threads postais, webhooks, mensagens e fluxos de trabalho de sandbox de envio. Para contas que já possuem um PMB atribuído, a custódia física de entrada usa um contrato separado somente via REST.

Disponibilidade de endereço de recebimento gerenciado

Novos endereços físicos de recebimento e pacotes emitidos pelo mailbox.bot: Ainda não disponíveis · Previsão de lançamento: meados/final de setembro. As reservas estão abertas, mas uma reserva não atribui nem ativa um endereço. Envio de correspondência e contexto de entrada encaminhado de um endereço que você já usa estão disponíveis hoje.

Loop de contexto de entrada

Use list_inbound_forwarding_addresses para descobrir o alias privado do locatário em forward.mailbox.bot. Encaminhe ou envie por e-mail digitalizações, PDFs, fotos, avisos de provedores e anotações para esse alias para iniciar a extração/OCR. Em seguida, use list_inbound_mail ou get_inbound_mail para recuperar draft_context para seu LLM e passe inbound_capture_id / postal_mail_thread_id para send_outbound_mail quando a resposta gerada se tornar correspondência física. Após um envio bem-sucedido, use document_preview_url para verificação visual humana do documento enviado.

Endpoint MCP hospedado

URL: https://mailbox.bot/api/mcp

Transporte: Streamable HTTP

Autenticação: Authorization: Bearer YOUR_API_KEY

Segurança no envio de correspondência

send_outbound_mail pode criar correspondência física paga quando usado com uma chave de produção. Mantenha fluxos de trabalho rápidos, mas use uma salvaguarda explícita antes de envios ao vivo.

1. Use dry_run=true para validação sem débito de crédito, contagem de páginas, classe de correio e prévia exata de custo.

2. Use requires_approval=true quando um humano deve revisar primeiro. Envios com aprovação prévia retornam document_preview_url e não gastam créditos até a aprovação no painel.

3. Mostre human_review antes de um envio pago ao vivo ou aprovação no painel. Confirme endereço de envio, endereço de retorno, classe de correio, nome do arquivo do documento, contagem de páginas, custo, salvaguardas e URL de prévia quando presente.

4. No chat do Cursor, responda perguntas sobre créditos com get_usage. Informe ao humano o saldo pré-pago e que somente ele pode adicionar fundos pelo painel de cobrança.

5. Para "cancelar este pedido", identifique o registro de correspondência de saída, chame cancel_outbound_mail enquanto ele ainda estiver enviado, então relate o status do cancelamento, créditos devolvidos, saldo atualizado e se já foi cancelado. Se ocorrer um erro transitório, consulte o registro de correspondência e os créditos antes de tentar novamente.

6. Use max_cost_cents, chaves force_approval e chaves de sandbox sk_agent_test_ para testes repetidos ou fluxos de trabalho construídos por agentes.

1. Obtenha sua chave de API

Copie uma chave sk_agent_ para uso do agente, ou uma chave sk_agent_test_ para testes em sandbox. Você também pode usar uma chave de conta sk_live_ durante a configuração. Obtenha chaves no painel e cole uma abaixo para preencher os exemplos.

2. Escolha seu cliente MCP

Adicione este bloco a qualquer cliente MCP que suporte servidores HTTP remotos: Use https://mailbox.bot/api/mcp como URL do servidor e passe sua chave de API no cabeçalho Authorization. Se o seu cliente espera um comando local em vez de uma URL remota, use a predefinição de ponte de comando.

{
  "mcpServers": {
    "mailbox-bot": {
      "url": "https://mailbox.bot/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Solução de problemas

O cliente não consegue alcançar o servidor remoto

Mude para a predefinição Bridge. Ela executa mcp-remote localmente e conecta-se ao mesmo endpoint hospedado.

npx ou Node está ausente

Instale o Node.js LTS, reinicie o cliente e atualize os servidores MCP. As predefinições de ponte de comando exigem npx.

As ferramentas não aparecem após salvar

Reinicie o cliente ou use a ação de atualização do servidor MCP. Alguns clientes só carregam servidores MCP na inicialização.

3. Recarregue seu cliente MCP

Reinicie ou recarregue seu cliente para que ele descubra as ferramentas do mailbox.bot. Peça ao seu agente para ler o contexto digital/OCR encaminhado ou criar correspondência de saída.

Ferramentas MCP disponíveis (19)

get_mailboxget_usagelist_inbound_forwarding_addresseslist_inbound_mailget_inbound_maillist_postal_threadsget_postal_threadget_mailbox_mdpropose_mailbox_md_editsend_facility_messagelist_facility_conversationsget_facility_messagesupdate_webhooksend_outbound_maillist_outbound_mailget_outbound_mailcancel_outbound_mailcreate_test_outbound_mailadvance_test_outbound_mail