API em producao

Gestao financeira
via API e agentes de IA

Crie despesas, consulte DRE, gerencie fluxo de caixa — tudo via API REST ou ferramentas MCP. Seus agentes de IA podem gerenciar financas como um contador.

Quickstart Swagger UI MCP Server
154
Endpoints REST
19
MCP Tools
15
Scopes de Permissao
10
Tags Swagger
24/7
Disponibilidade

Quickstart

1

Crie sua conta

Registre-se em app.srdre.com.br e configure sua empresa.

2

Gere uma API Key

Em Configuracoes > API Keys, crie uma chave com os scopes necessarios. A chave so e exibida uma vez.

3

Comece a usar

Envie o header x-api-key: sk_live_... em todas as requisicoes.

Resumo financeiro com uma chamada 
curl -s https://app.srdre.com.br/api/v1/agent/financial-summary \
  -H "x-api-key: sk_live_sua_chave" | jq

# Resposta:
{
  "period": "04/2026",
  "totalBalanceFormatted": "R$ 18.828,70",
  "monthly": {
    "revenueFormatted": "R$ 35.063,96",
    "expensesFormatted": "R$ 55.258,57",
    "resultFormatted": "R$ -20.194,61"
  },
  "overdueCount": 0,
  "upcomingPayables": [...]
}

Autenticacao

Dois metodos suportados. API Keys sao recomendadas para agentes de IA.

API Key

Recomendado

Para agentes de IA e integracoes. Scopes granulares, rate limit por key, audit log.

x-api-key: sk_live_abc123...

JWT Cookie

Para a interface web do SrDRE. Login via email/senha, access + refresh tokens.

Cookie: access_token=eyJhbG...

Scopes de Permissao

Cada API Key tem scopes que definem o que pode acessar. Escolha somente o necessario.

transactions:read

Listar e visualizar receitas e despesas

transactions:write

Criar e editar transacoes financeiras

transactions:confirm

Confirmar pagamentos e recebimentos

chart-of-accounts:read

Consultar plano de contas

financial-accounts:read

Ver contas bancarias e saldos

reports:read

DRE, Fluxo de Caixa, relatorios

dashboard:read

KPIs, graficos, visao geral

clients:read / :write

Gerenciar cadastro de clientes

suppliers:read / :write

Gerenciar cadastro de fornecedores

Bundles prontos: Use financial-readonly para consulta ou financial-full para acesso completo.

Endpoints para Agentes

Endpoints simplificados que resolvem nomes automaticamente. Passe "Aluguel" em vez de um UUID.

GET
/agent/financial-summary

Resumo consolidado: saldos, receitas/despesas do mes, contas vencidas, proximos vencimentos.

dashboard:read
POST
/agent/transactions/despesa

Cria despesa. Resolve categoryName e supplierName automaticamente (cria fornecedor se nao existir).

transactions:write
POST
/agent/transactions/receita

Cria receita. Resolve categoryName e clientName automaticamente.

transactions:write
GET
/agent/capabilities

Mostra os scopes, rate limit e empresa vinculada a API Key atual.

qualquer key
GET
/agent/schema

Schema de dados: tipos, formatos (centavos, datas), campos obrigatorios.

qualquer key

MCP Server

19 Tools

Servidor MCP nativo para Claude Code, Claude Desktop e Cursor. Converse com o SrDRE em linguagem natural.

Configuracao

~/.claude/settings.json
{
  "mcpServers": {
    "srdre": {
      "command": "bun",
      "args": ["run", "path/to/mcp-server/src/index.ts"],
      "env": {
        "SRDRE_API_KEY": "sk_live_sua_chave"
      }
    }
  }
}

Tools Disponiveis

srdre_financial_summary

Resumo financeiro consolidado

srdre_create_despesa

Criar despesa por nome

srdre_create_receita

Criar receita por nome

srdre_list_transactions

Listar transacoes com filtros

srdre_dre_report

DRE por mes

srdre_cash_flow

Fluxo de caixa

srdre_dashboard_kpis

KPIs do dashboard

srdre_chart_of_accounts_tree

Plano de contas hierarquico

srdre_list_financial_accounts

Contas bancarias e saldos

srdre_list_clients / suppliers

Clientes e fornecedores

srdre_upcoming_payables / receivables

Proximos vencimentos

Rate Limiting & Monitoramento

Cada API Key tem seu proprio limite. Headers de rate limit em toda resposta.

60
req/min (default)

Configuravel por key: 60, 300, 1000

Headers de resposta

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 57
X-RateLimit-Reset: 1714500000

Usage Analytics

Logs por endpoint, status code, duracao. Endpoint dedicado para consulta de uso por key.

GET /companies/:id/api-keys/:keyId/usage

Compativel com

Qualquer agente que suporte REST API ou MCP Protocol

Claude
Cursor
OpenClaw
Hermes
Paperclip
Qualquer API

Comece a integrar agora

Crie sua conta, gere uma API Key e conecte seu agente em minutos.

Criar Conta Gratis Explorar Swagger