Integração com Agentes de IA

Conecte seu agente ao Haveres.

O Haveres expõe um MCP Server e uma API REST para que agentes de IA acessem dados financeiros, gerem relatórios e registrem lançamentos com segurança e isolamento por empresa.

Opção 1 — MCP Server (recomendado para Claude)

Instalar via Claude Code

Com o Claude Code instalado, execute o comando abaixo no terminal. Substitua <sua-api-key> pela chave gerada em Configurações → API & Integrações.

1

Gere sua API key

Acesse Configurações → API & Integrações e crie uma nova chave. Copie o valor — ele só é exibido uma vez.

2

Adicione o MCP Server

terminal
claude mcp add haveres \
  --transport http \
  --url https://haveres.org/api/mcp \
  --header "Authorization: Bearer <sua-api-key>"
3

Pronto — use no Claude

O Claude agora tem acesso às ferramentas do Haveres. Experimente:

"Mostre a DRE de 2026 e identifique as 3 maiores despesas""Quais funcionários têm salário acima de R$5.000?""Qual foi o resultado líquido dos últimos 6 meses?"
Ferramentas disponíveis
get_dreDemonstração do Resultado do Exercício por ano
get_lancamentosListar lançamentos contábeis confirmados
get_fiscalApurações fiscais (DAS, IRPJ, CSLL, etc.)
get_funcionariosFuncionários ativos com salário e cargo
get_kpisKPIs financeiros dos últimos 12 meses
Opção 2 — API REST

Integração direta via HTTP

Use qualquer linguagem ou ferramenta (Python, n8n, Make, curl) com autenticação Bearer.

curl
curl https://haveres.org/api/v1/dre?year=2026 \
  -H "Authorization: Bearer hav_live_xxxx"

# Resposta:
{
  "year": 2026,
  "receita_liquida": 1842300,
  "lucro_bruto": 962140,
  "resultado_liquido": 308554
}
Endpoints
GET/api/v1/dre?year=2026DRE do exercício
GET/api/v1/lancamentosLançamentos contábeis
POST/api/v1/lancamentosCriar lançamento
GET/api/v1/fiscalApurações fiscais
GET/api/v1/funcionariosFuncionários ativos
Opção 3 — Webhooks

Receba eventos em tempo real

Configure um endpoint e o Haveres notifica seu sistema quando eventos acontecem. Cada entrega inclui assinatura HMAC-SHA256 para verificação.

nota.autorizadanota.canceladavencimento.proximofolha.calculadalancamento.criadoapuracao.calculada

Pronto para conectar?

Crie sua conta, gere uma API key e conecte em minutos.

Integrar com Agentes de IA via API REST e MCP | Haveres