BizLink

Servidor MCP do ERP BizLink

Model Context Protocol — acesso remoto via HTTPS

Credenciais necessárias. Este servidor é restrito a clientes BizLink. Para obter suas credenciais de acesso, entre em contato com a equipe de suporte.

1 Endpoint MCP

Configure seu cliente MCP com a URL abaixo (transporte streamable-http):

URL https://<seu-dominio>/mcp

2 Autenticação

O acesso ao MCP do BizLink usa um Bearer token no header HTTP, validado antes de qualquer chamada:

HTTP Token do servidor (header HTTP)

Protege o endpoint na internet. Enviado em toda requisição no header Authorization: Bearer. Sem ele, o servidor responde 401 Unauthorized.

# Header HTTP — token do servidor
Authorization: Bearer <token-do-servidor>

A segurança dos dados é garantida pelo Row Level Security (RLS) do Supabase, que filtra automaticamente todas as queries por empresa_id. O agente de IA só enxerga dados da empresa autorizada.

3 Ferramentas disponíveis

O servidor expõe as seguintes tools para consulta ao ERP:

listar_empresas — lista as empresas cadastradas
listar_pessoas — lista clientes/fornecedores por empresa
listar_contas_financeiro — contas a pagar/receber com JOINs e filtros por período
listar_produtos — lista produtos/serviços por empresa

4 Clientes compatíveis

Servidores MCP remotos (HTTP/SSE) são suportados por:

Claude (Anthropic)

Cursor

Windsurf

Devin

Claude Desktop

OpenCode

5 Exemplo: curl

# Handshake inicial (initialize)
curl -X POST https://<seu-dominio>/mcp \
  -H "Authorization: Bearer <token-do-servidor>" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"exemplo","version":"1.0"}}}'

Após o handshake, chame as tools passando empresa_id como parâmetro. O RLS do Supabase garante o isolamento dos dados entre empresas.

6 Stack técnica

Python + FastMCP servidor MCP

Framework FastMCP 3.x sobre o protocolo Model Context Protocol. Suporta stdio (local) e streamable-http/SSE (remoto).

Supabase (Postgres) banco de dados

Acesso via cliente Python supabase-py. Row Level Security ativo em todas as ~80 tabelas, filtrando por empresa_id.