MCP Server

O bitERP MCP Server permite que agentes de IA (como Claude, GPT e outros LLMs) executem operações de negócio no bitERP via o protocolo Model Context Protocol (MCP).

O que é MCP?

O Model Context Protocol é um protocolo padronizado que permite a comunicação entre agentes de IA e serviços externos. Ele define como o agente descobre ferramentas (tools) disponíveis, as invoca e recebe resultados — tudo via JSON-RPC sobre HTTP.

Base URL

https://mcp.biterp.ai

Como conectar

1. Configurar a conexão

No seu cliente MCP (Claude Desktop, Cursor, etc.), adicione o servidor:

{
    "mcpServers": {
        "biterp": {
            "url": "https://mcp.biterp.ai"
        }
    }
}

2. Autenticar via OAuth

O servidor usa OAuth 2.0 via Clerk. O cliente MCP gerencia o fluxo automaticamente:

1. O cliente descobre os endpoints OAuth via /.well-known/oauth-authorization-server
2. Redireciona você para autenticar no bitERP
3. Recebe o token e estabelece a sessão

3. Selecionar o tenant

Após autenticar, o agente deve chamar list_tenants para obter os tenants disponíveis. Se houver mais de um, o agente perguntará qual usar.

4. Usar as ferramentas

O agente de IA pode então usar todas as ferramentas disponíveis para executar operações de negócio no contexto do tenant selecionado.

Endpoints

Próximos passos