Portal para Desenvolvedores, Integradores, Equipe Alcance

Documentação TécnicaAlcance Contabilidade

Guias oficiais, conceitos fundamentais e referência completa dos sistemas internos da Alcance - desde o gateway MCP para IA até a WebApi que atende clientes contábeis em produção.

Como funciona

Cliente IA chama o gateway MCP, que valida o Bearer, mascara PII e traduz a chamada para a WebApi - com escopo restrito de API Key.

Cliente IA

Claude Desktop, Cursor, Lovable. Conecta via Streamable HTTP com token Bearer.

Gateway MCP

Vercel gru1 - autenticação Bearer, validação Zod, PII mascarada por padrão.

WebApiAlcance

FastAPI on-premise - escopos restritos, lógica de negócio, Celery workers.

Endpoint MCP

Conecte qualquer cliente IA compatível com Streamable HTTP à URL abaixo. O Bearer é fornecido pelo time TI da Alcance.

https://mcp-alcancecontabilidade.vercel.app/api/mcp
Ver guias de instalação por cliente

Conceitos antes de implementar

Autenticação Bearer, escopos de API Key, mascaramento de PII, dry-run em writes, tasks Celery. Tudo que se aplica aos dois produtos.

Ler conceitos