mailbox.bot

Conecta cualquier cliente de IA compatible con MCP a mailbox.bot usando el Protocolo de Contexto de Modelo (MCP). Tu agente obtiene 19 herramientas para correo saliente, contexto digital/OCR reenviado, hilos postales, webhooks, mensajes y flujos de trabajo de sandbox para correo saliente. Para cuentas que ya tienen un PMB asignado, la custodia física entrante utiliza un contrato separado solo REST.

Disponibilidad de dirección de recepción administrada

Nuevas direcciones físicas de recepción y paquetes emitidas por mailbox.bot: Aún no disponibles · Lanzamiento estimado: mediados/finales de septiembre. Las reservas están abiertas, pero una reserva no asigna ni activa una dirección. El correo saliente y el contexto entrante reenviado desde una dirección que ya usas están disponibles hoy.

Bucle de contexto entrante

Usa list_inbound_forwarding_addresses para descubrir el alias privado del arrendatario en forward.mailbox.bot. Reenvía o envía por correo electrónico escaneos, PDFs, fotos, avisos de proveedores y notas a ese alias para iniciar la extracción/OCR. Luego usa list_inbound_mail o get_inbound_mail para recuperar draft_context para tu LLM, y pasa inbound_capture_id / postal_mail_thread_id a send_outbound_mail cuando la respuesta generada se convierta en correo físico. Después de un envío exitoso, usa document_preview_url para la verificación visual humana del documento enviado.

Endpoint MCP alojado

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

Transporte: Streamable HTTP

Autenticación: Authorization: Bearer YOUR_API_KEY

Seguridad del correo saliente

send_outbound_mail puede crear correo físico de pago cuando se usa con una clave de producción. Mantén los flujos rápidos rápidos, pero usa una salvaguarda explícita antes de envíos en vivo.

1. Usa dry_run=true para validación sin débito de crédito, recuento de páginas, clase de correo y vista previa exacta del costo.

2. Usa requires_approval=true cuando un humano deba revisar primero. Los envíos con aprobación previa devuelven document_preview_url y no gastan créditos hasta la aprobación en el panel.

3. Muestra human_review antes de un envío financiado en vivo o aprobación en el panel. Confirma la dirección de envío, dirección de remitente, clase de correo, nombre del archivo del documento, recuento de páginas, costo, salvaguardas y URL de vista previa cuando esté presente.

4. En el chat de Cursor, responde preguntas sobre créditos con get_usage. Informa al humano el saldo prepagado y que solo ellos pueden agregar fondos desde la facturación del panel.

5. Para "cancelar este pedido", identifica el registro de correo saliente, llama a cancel_outbound_mail mientras aún esté enviado, luego informa el estado de cancelación, créditos devueltos, saldo actualizado y si ya fue cancelado. Si ocurre un error transitorio, consulta el registro de correo y los créditos antes de reintentar.

6. Usa max_cost_cents, claves force_approval y claves de sandbox sk_agent_test_ para pruebas repetidas o flujos de trabajo construidos por agentes.

1. Obtén tu clave API

Copia una clave sk_agent_ para uso del agente, o una clave sk_agent_test_ para pruebas en sandbox. También puedes usar una clave de cuenta sk_live_ durante la configuración. Obtén claves desde el panel, luego pega una a continuación para completar los ejemplos.

2. Elige tu cliente MCP

Agrega este bloque a cualquier cliente MCP que admita servidores HTTP remotos: Usa https://mailbox.bot/api/mcp como URL del servidor y pasa tu clave API en el encabezado Authorization. Si tu cliente espera un comando local en lugar de una URL remota, usa el preset de puente de comandos.

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

Solución de problemas

El cliente no puede alcanzar el servidor remoto

Cambia al preset Bridge. Ejecuta mcp-remote localmente y se conecta al mismo endpoint alojado.

Falta npx o Node

Instala Node.js LTS, reinicia el cliente y luego actualiza los servidores MCP. Los presets de puente de comandos requieren npx.

Las herramientas no aparecen después de guardar

Reinicia el cliente o usa su acción de actualización de servidores MCP. Algunos clientes solo cargan servidores MCP al inicio.

3. Recarga tu cliente MCP

Reinicia o recarga tu cliente para que descubra las herramientas de mailbox.bot. Pide a tu agente que lea el contexto digital/OCR reenviado o cree correo saliente.

Herramientas MCP disponibles (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