Documentação técnica

Plataforma Alcance 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.

Primeiros passos Ler introdução

Produtos documentados

Dois sistemas trabalham juntos: o MCP traduz IA em chamadas seguras à WebApi, que executa a lógica de negócio.

MCP

v0.1.0

Gateway IA via Model Context Protocol

Conecte Claude Desktop, Cursor, Lovable e ChatGPT à plataforma Alcance com auth Bearer, tools tipadas em PT-BR e mascaramento de PII por padrão.

Explorar

API

WebApiAlcance — FastAPI on-premise

API HTTPS dos sistemas internos: clientes, certidões negativas, lembretes WhatsApp, automações Celery e mais.

Explorar

Como funciona

Cliente IA chama o gateway MCP, que valida 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 bearer Token.

Gateway MCP

Vercel gru1 — Bearer auth, Zod validation, 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

Claude DesktopAnthropic

ChatGPTOpenAI

Fase 2

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