Saltar al contenido principal

Inbox Autónomo — Documentación de la API, el MCP y el CLI

¡Bienvenido! Inbox Autónomo es el servicio de Kobana para recibir, almacenar, filtrar y procesar correos entrantes con agentes de IA. Este sitio documenta tres formas de acceder a él: la API REST pública bajo /api/v1 — mTLS + Bearer JWT, JSON, paginación por cursor y webhooks —, el servidor MCP remoto, para clientes de IA que prefieren llamar tools en vez de endpoints HTTP, y el CLI kobana, para llamarlo directo desde una terminal o un script.

Usa el menú lateral para navegar, empezando por la Introducción — o ve directo a la Referencia de la API si ya sabes lo que buscas. ¿Vas a conectar un asistente de IA? Consulta el servidor MCP. ¿Prefieres la terminal? Consulta el CLI kobana.

Primeros pasos​

  1. Autentícate — certificado mTLS + Bearer JWT.
  2. Haz tu primera llamada contra /api/v1/workspaces.
  3. Crea un Inbox y empieza a recibir correos.
  4. Suscribe un Webhook para reaccionar a eventos en tiempo real.

Qué encontrarás aquí​

  • Visión General — autenticación, endpoints, especificaciones, límite de solicitudes, paginación, filtros, idempotencia, errores y retención de datos.
  • Modelos — Workspace, Inbox, Email, Agent, AgentRun, Webhook, WebhookDelivery y SystemEvent, los objetos de dominio usados en toda la API.
  • Workflows — cómo un agente puede terminar su ejecución con una cadena de llamadas HTTP contra sus sistemas: cómo funciona, una guía inicial, la referencia de steps y placeholders, y diagnóstico.
  • Recursos — la referencia completa de endpoints para cada recurso bajo /api/v1, generada a partir de la especificación OpenAPI, con schemas de request/response y consola para probar llamadas.
  • MCP — el servidor remoto de Model Context Protocol, que expone las mismas operaciones como tools que un cliente de IA puede llamar: autenticación, transporte y cada tool con sus parámetros.
  • CLI — kobana, la herramienta de línea de comandos única para la API de todos los productos de Kobana (este incluido): instalación, autenticación, uso e introspección de schema.