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.