Introdução à plataforma Alcance
Documentação técnica oficial
Este site é a fonte autoritativa de documentação dos sistemas da Alcance Contabilidade. Mudanças relevantes são registradas no Changelog.
A Alcance Contabilidade é um escritório que combina prestação de serviços contábeis com automação interna de ponta. Para suportar essa operação, mantemos uma plataforma técnica composta por uma WebApi privada (FastAPI on-premise) e um gateway MCP que conecta clientes de IA — Claude Desktop, Cursor, Lovable e ChatGPT — aos nossos dados de forma controlada e auditável.
Esta documentação reúne, em um único lugar, tudo que você precisa para integrar, operar e entender os dois produtos.
O que você encontra aqui
- Documentação do MCP — instalação por cliente IA, tools disponíveis, exemplos práticos e troubleshooting.
- Documentação da WebApi — autenticação, escopos de API Key e referência dos endpoints públicos.
- Conceitos compartilhados — autenticação Bearer, escopos, mascaramento de PII, dry-run em writes e tasks Celery.
- Changelog — histórico de versões dos dois produtos, com notas de migração.
Para quem é esta documentação
- Operadores Alcance — contadores e analistas que consomem a plataforma via Claude Desktop ou Cursor no dia a dia.
- Integradores parceiros — desenvolvedores externos que recebem uma API Key escopada para consumir a WebApi diretamente.
- Time interno de TI — engenheiros e mantenedores que operam o gateway MCP, emitem credenciais e evoluem a arquitetura.
Próximos passos
- Primeiros passos — escolha um caminho conforme o seu perfil.
- Conceitos fundamentais — leia antes de integrar.
- MCP — Gateway IA — instale em seu cliente IA preferido.
- WebApi — consulte a referência completa dos endpoints.