Instalação no ChatGPT

Em breve — Fase 2

Status atual: NÃO SUPORTADO no MVP (Fase 1). Disponível previsto para a Fase 2, quando habilitarmos OAuth 2.1 + DCR.

Por que não funciona ainda

O ChatGPT (Plus, Pro e Team) com Developer Mode → Apps & Connectors exige, para servidores MCP externos, autenticação via OAuth 2.1 com Dynamic Client Registration (DCR) conforme a especificação oficial do MCP. Ele não aceita Bearer estático como o Claude ou o Lovable.

Como o MVP da Alcance usa Bearer simples (MCP_BEARER_TOKEN) por razões de simplicidade e auditabilidade interna, o conector é rejeitado pelo ChatGPT no momento do handshake de autorização.

Roadmap de habilitação

A Fase 2 do roadmap inclui:

  1. Implementação do servidor OAuth 2.1 (Authorization Code + PKCE).
  2. Dynamic Client Registration (RFC 7591).
  3. Mapeamento bearer ↔ usuário ↔ escopos da API Key da WebApi.
  4. Token rotation e revogação.

Sem prazo confirmado — a prioridade depende da demanda dos sócios e da estabilidade do MVP em produção.

Workaround temporário

Se você precisa de uma experiência tipo ChatGPT consumindo o MCP da Alcance hoje, há duas alternativas viáveis:

Opção A — Claude Web ou Desktop

O Claude (Anthropic) aceita Bearer estático em custom connectors. A experiência conversacional é equivalente à do ChatGPT para a maioria dos casos de uso contábeis. Veja o guia do Claude Desktop.

Opção B — Lovable como front-end customizado

Construa, em poucos minutos, um chat customizado no Lovable que:

  • Conecta ao MCP via Bearer.
  • Expõe uma interface conversacional similar ao ChatGPT.
  • Pode ser embutida no portal interno da Alcance.

Veja o guia do Lovable.

Quando o suporte chegar

Quando a Fase 2 for entregue, este documento será atualizado com:

  • URL do endpoint /.well-known/oauth-authorization-server.
  • Passo a passo para registrar o connector no ChatGPT Developer Mode.
  • Escopos OAuth disponíveis e como solicitá-los.

Para acompanhar, fique de olho no Changelog ou inscreva-se na lista interna de releases enviando um e-mail para ti@alcancecontabilidade.com.br.