Construa sobre a plataforma financeira da Kobana
API REST, servidores MCP e CLI para cada produto Kobana. Integre por código, conecte agentes de IA ou automatize pelo terminal.

Três formas de integrar
Os mesmos recursos, no formato que combina com o que você está construindo.
API REST
Para o seu backend. JSON, tokens Bearer e idempotência em todos os produtos, e webhooks assinados nos que emitem eventos.
Explorar as APIs →Servidor MCP
Para agentes de IA. Uma URL por produto, login pela Kobana e as permissões de quem autorizou.
Conectar um agente →CLI
Para scripts, CI e agentes que rodam comandos. Saída em JSON, --dry-run e paginação automática.
Instalar o CLI →Cada produto, no formato que ele oferece
Documentação de API, servidor MCP e CLI de cada produto Kobana. Os links levam à documentação oficial do produto.
| Produto | API | MCP | CLI |
|---|---|---|---|
| Gateway Bancário Boletos, Pix, pagamentos e transferências em vários bancos | Documentação | mcp.banking.kobana.com.br | kobana banking |
| Faturamento Automático Assinaturas, faturas, notas fiscais e propostas | Documentação | mcp.billing.kobana.com.br | kobana billing |
| Financeiro Inteligente Contas a pagar e a receber, conciliação e fluxo de caixa | Documentação | mcp.finance.kobana.com.br | kobana finance |
| Régua de Cobrança Cobrança automática do vencimento ao pagamento | Documentação | mcp.dunning.kobana.com.br | kobana dunning |
| Dashboard Mágico Portal do cliente com os seus dados e a sua marca | Documentação | mcp.dashboards.kobana.com.br | kobana dashboards |
| Inbox Autônomo Caixas de entrada com agentes de IA que leem e processam e-mails | Documentação | mcp.inbox.kobana.com.br | kobana inbox |
A Régua de Cobrança ainda não tem documentação do CLI: use kobana dunning --help ou kobana schema.
Gateway Bancário: SDKs, webhooks e sandbox
Bibliotecas oficiais, notificações em tempo real e um ambiente de testes isolado, para integrar o Gateway Bancário.
SDKs oficiais
Ruby, PHP, Python e Node.js, com autenticação simples, retentativas automáticas e tipagem completa.
Ver os SDKs →Webhooks
Receba eventos de boletos, Pix e transferências sem polling, com assinatura HMAC-SHA256.
Configurar webhooks →Sandbox
Ambiente separado da produção para validar a integração antes de ir ao ar.
Conhecer o sandbox →SDKs oficiais do Gateway Bancário
Bibliotecas mantidas pela Kobana para a API do Gateway Bancário.
| Linguagem | Repositório | Instalação |
|---|---|---|
| Ruby | github.com/universokobana/kobana-ruby-client | gem install kobana |
| PHP | github.com/universokobana/kobana-php-client | composer require kobana/kobana-php-client:dev-main |
| Python | github.com/universokobana/kobana-python-client | pip install kobana |
| Node.js | github.com/universokobana/kobana-nodejs-client | npm install kobana |
Segurança em primeiro lugar
- HTTPS obrigatório: Todas as comunicações são criptografadas com TLS.
- Tokens da Conta Kobana: Autenticação por Bearer token, com escopos por recurso.
- Permissões de quem autorizou: Em MCP e CLI, o acesso é estreitado pelas permissões da pessoa, relidas a cada chamada.
- Webhooks assinados: Gateway Bancário, Faturamento Automático, Régua de Cobrança e Dashboard Mágico assinam as notificações com HMAC.
- Idempotência: O cabeçalho X-Idempotency-Key evita cobranças e pagamentos duplicados.
- Certificados ICP-Brasil: Integração segura com os bancos via mTLS.
Prefere um agente pronto?
O Kadu e o Kia usam a plataforma Kobana para assumir o operacional do financeiro, sem você escrever código.
Conhecer a IA da KobanaPronto para começar?
Crie sua conta de sandbox e faça a primeira chamada hoje, ou agende um bate-papo com o nosso time.
