Desenvolvedores

Cada módulo tem sua API em https://<módulo>-api.mcpbr.app. O financeiro está emfin-api.mcpbr.app.

API REST

• JSON em /v1, contrato OpenAPI 3.1 (referência).
• Erros no formato RFC 9457 (application/problem+json), paginação por cursor.
• Escritas exigem Idempotency-Key: repetir a chamada devolve a mesma resposta, sem duplicar o lançamento.

Autenticação

• Chaves de API: criadas pelo dono ou administrador da empresa na tela de integrações, com um papel limitado (leitura, financeiro, auditor). Trocam client id e secret por um token OAuth 2.0 (client_credentials) em https://login.id55.io/oauth/v2/token.
• Pessoas e aplicativos: OAuth 2.0 / OpenID Connect pela id55.

Webhooks

Eventos de domínio (ex.: conta paga, lançamento estornado) entregues por HTTPS no padrão Standard Webhooks (assinatura HMAC-SHA256), reenvio com espera crescente e registro de entregas.

MCP (agentes de IA)

Cada módulo expõe um servidor MCP (Streamable HTTP) em /mcp/<empresa>, com descoberta OAuth (RFC 9728) e registro dinâmico de clientes: basta adicionar a URL no Claude e entrar com sua conta. As ferramentas respeitam o seu papel na empresa e ficam na mesma trilha de auditoria.