Instalação no ChatGPT

Boas práticas de token

Use apenas tokens emitidos para essa integração, com escopo mínimo.

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, 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.

Workaround temporário

Se você precisa de uma experiência tipo ChatGPT consumindo o MCP da Alcance hoje, use a alternativa abaixo:

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.

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.