Conecta tu asistente de IA a Unbox

Resumen

Unbox MCP está diseñado para propietarios de cuentas personales que quieren un asistente de IA — en Cursor, Workbuddy, OpenClaw o cualquier host compatible con MCP — para trabajar con su correo alojado. No es una API de desarrollo para crear aplicaciones en Unbox; para envíos transaccionales desde tu dominio, consulta la documentación de nuestra API HTTP.

Qué pueden hacer los agentes

Después de iniciar sesión, tu agente puede llamar a las herramientas de Unbox en tu nombre:

• Leer bandeja de entrada y conversaciones — Listar conversaciones, abrir un hilo y obtener mensajes individuales.
• Buscar correos — Encuentra mensajes en tu bandeja de entrada con consultas en lenguaje natural.
• Enviar y responder — Redactar un nuevo correo o responder a un hilo desde tus direcciones de Unbox, sujeto a los límites de envío de tu plan.
• Organizar — Marcar como spam, restaurar desde spam, mover a la papelera o restaurar — un mensaje a la vez.

Vaciar spam o papelera en masa, generación de claves API y acciones del espacio de trabajo en equipo no están disponibles a través de MCP en v1.

Cómo funciona

Tu cliente de IA se conecta al servidor MCP de Unbox. El servidor llama a las APIs de la cuenta de Unbox usando una sesión web normal — el mismo tipo que obtienes al iniciar sesión en unbox.im.

1. Añade Unbox a la configuración de tu cliente MCP (consulta Configuración más abajo).
2. Pídele a tu agente que inicie sesión — se abrirá un enlace en el navegador donde apruebas el acceso con tu cuenta de Unbox.
3. Una vez conectado, pídele a tu agente que lea correos, redacte respuestas u organice mensajes.

Iniciar sesión

Unbox utiliza el inicio de sesión en el navegador para que siempre apruebes el acceso. Tu agente inicia el flujo con las herramientas de inicio de sesión, luego tú completas el inicio de sesión en el navegador:

1. Tu agente llama a unbox_login_start y te muestra una URL del navegador.
2. Abre el enlace, inicia sesión en Unbox si es necesario, y copia el código de enlace único que se muestra en la página.
3. Pega el código de vuelta en tu agente (unbox_login_complete).
4. Tu sesión permanece activa durante el período normal de sesión web de Unbox — vuelve a iniciar sesión cuando expire.

URL de inicio de sesión (como referencia)

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

¿Necesitas una cuenta primero? Crea tu ID de Unbox y luego vuelve para conectar tu agente.

Configuración

Añade Unbox como servidor MCP en tu cliente de IA. El transporte HTTP remoto es la forma más sencilla de conectarse a la nube de Unbox:

HTTP remoto (recomendado)

Apunta tu cliente MCP al endpoint MCP de Unbox. Después de añadir el servidor, usa las herramientas de inicio de sesión para autenticarte:

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

HTTP MCP puede estar deshabilitado en algunas implementaciones hasta que el operador lo habilite. Si la conexión falla, intente nuevamente más tarde o contacte al soporte.

Herramientas comunes

Una vez iniciada la sesión, su agente puede usar herramientas como:

• unbox_login_start — iniciar sesión en el navegador
• unbox_login_complete — intercambiar código de enlace por sesión
• unbox_list_threads — feed de la bandeja de entrada
• unbox_search_inbox — buscar mensajes
• unbox_reply_to_email — responder a un mensaje
• unbox_send_email — enviar un nuevo correo

Clientes compatibles

Cualquier host de agente compatible con MCP puede conectarse a Unbox. Probamos y documentamos:

• Cursor — Agregue Unbox en servidores MCP en la configuración de Cursor, luego inicie sesión mediante el flujo del navegador.
• Workbuddy — Configure una URL de servidor MCP remoto que apunte a Unbox, luego autentíquese con su cuenta.
• OpenClaw — Conecte OpenClaw al endpoint HTTP MCP de Unbox y complete el inicio de sesión en el navegador.

Seguridad

• Inicio de sesión en el navegador — Usted inicia sesión a través de Unbox en su navegador — los agentes nunca ven su contraseña.
• Solo el propietario de la cuenta — El acceso a MCP está limitado al propietario de la cuenta personal, no a los miembros del equipo ni a espacios de trabajo compartidos.
• Los mismos límites que la aplicación web — Los límites de envío, las reglas de spam y la política transaccional se aplican a las acciones del agente de la misma manera que en la interfaz de la bandeja de entrada.
• Sin eliminación masiva — Los agentes no pueden vaciar la carpeta de spam, vaciar la papelera ni rotar claves API a través de MCP en la versión 1.