Introdução
Visão geral do bitERP, ambientes disponíveis e como obter credenciais para integração.
O que é o bitERP?
O bitERP é um sistema ERP (Enterprise Resource Planning) AI-first, projetado como plataforma SaaS multi-tenant. Ele permite que empresas gerenciem produtos, clientes, fornecedores, pedidos, financeiro e mais — tudo com integração nativa a agentes de IA.
Formas de integração
| Canal | Protocolo | Público-alvo | Autenticação |
|---|---|---|---|
| API de Integrações | REST (JSON) | Sistemas externos, automações (Zapier, Make, n8n) | API Keys ou OAuth2 |
| MCP Server | Model Context Protocol (JSON-RPC) | Agentes de IA (Claude, GPT, etc.) | OAuth2 via Clerk |
Ambientes
| Ambiente | Base URL API | Base URL MCP |
|---|---|---|
| Produção | https://api.biterp.ai | https://mcp.biterp.ai |
Obtendo credenciais
API Keys (para API de Integrações)
- Acesse o painel do bitERP em app.biterp.ai
- Navegue até Configurações > API Keys
- Clique em Criar API Key
- Configure o nome, descrição e permissões por recurso
- Copie o token imediatamente — ele só é exibido uma vez
O token tem o formato sk_<id>_<secret>.
OAuth2 (para automações e MCP)
Para integrações via OAuth2 (Zapier, Make, n8n) ou para conectar agentes de IA via MCP, a autenticação é feita via fluxo OAuth2 Authorization Code. Consulte a seção de autenticação de cada canal para detalhes.
Conceitos básicos
Multi-tenancy
Cada empresa no bitERP é um tenant isolado. Todas as operações são executadas no contexto de um tenant específico:
- API Keys: cada key pertence a um único tenant — o contexto é automático
- OAuth2/MCP: o agente deve chamar
list_tenantsprimeiro e passar otenant_idnas operações
Na API de Integrações, o endpoint GET /tenant retorna os dados do tenant atual (aquele a que a sua credencial pertence). Você nunca envia tenant_id nos payloads — ele é sempre inferido da credencial.
Permissões
O bitERP usa um modelo de permissões granular por recurso e ação (create, read, update, delete). Cada API Key ou usuário OAuth tem permissões específicas configuradas pelo administrador.
Isolamento de dados
Dados de diferentes tenants são completamente isolados via Row-Level Security (RLS) no banco de dados. Não é possível acessar dados de outro tenant, mesmo com credenciais válidas.