Pular para o conteúdo principal

Inbox Autônomo — Documentação da API, do MCP e do CLI

Bem-vindo! O Inbox Autônomo é o serviço da Kobana para receber, armazenar, filtrar e processar e-mails recebidos com agentes de IA. Este site documenta três formas de acessá-lo: a API REST pública sob /api/v1 — mTLS + Bearer JWT, JSON, paginação por cursor e webhooks —, o servidor MCP remoto, para clientes de IA que preferem chamar tools em vez de endpoints HTTP, e o CLI kobana, para chamá-lo direto do terminal ou de um script.

Use o menu lateral para navegar, começando pela Introdução — ou vá direto para a Referência da API se já sabe o que procura. Vai conectar um assistente de IA? Veja o servidor MCP. Prefere o terminal? Veja o CLI kobana.

Primeiros passos​

  1. Autentique-se — certificado mTLS + Bearer JWT.
  2. Faça sua primeira chamada contra /api/v1/workspaces.
  3. Crie uma Inbox e comece a receber e-mails.
  4. Assine um Webhook para reagir a eventos em tempo real.

O que você encontra aqui​

  • Visão Geral — autenticação, endpoints, especificações, limite de requisições, paginação, filtros, idempotência, erros e retenção de dados.
  • Modelos — Workspace, Inbox, Email, Agent, AgentRun, Webhook, WebhookDelivery e SystemEvent, os objetos de domínio usados em toda a API.
  • Workflows — como um agente pode encerrar sua execução com uma cadeia de chamadas HTTP contra os seus sistemas: como funciona, um guia inicial, a referência de steps e placeholders, e diagnóstico.
  • Recursos — a referência completa de endpoints para cada recurso sob /api/v1, gerada a partir da especificação OpenAPI, com schemas de request/response e console para testar chamadas.
  • MCP — o servidor remoto de Model Context Protocol, que expõe as mesmas operações como tools que um cliente de IA pode chamar: autenticação, transporte e cada tool com seus parâmetros.
  • CLI — kobana, a ferramenta de linha de comando única para a API de todos os produtos Kobana (este incluído): instalação, autenticação, uso e introspecção de schema.