Prepare o client público

Solicite um client OAuth público com PKCE S256. Para o exemplo abaixo, ele precisa aceitar http://localhost:8765/callback. O client do piloto do ChatGPT usa outro callback e não deve ser presumido compatível.

O exemplo é para uma versão atual do Claude Code que suporta client OAuth pré-cadastrado. Confira claude mcp add --help se suas opções diferirem.

Adicione e autentique

claude mcp add --transport http   --client-id "$ORBITA_MCP_CLIENT_ID"   --callback-port 8765   orbita https://mcp.nexxo.tec.br/mcp

Abra o Claude Code, execute /mcp e conclua o login no navegador. Para conferir o cadastro:

claude mcp get orbita
claude mcp list

O client público não usa a flag --client-secret. Se a porta estiver ocupada, escolha outra e registre o callback correspondente no provedor antes de autenticar.

Arquivo de projeto

Quando quiser compartilhar apenas o cadastro do servidor com a equipe, use .mcp.json na raiz do projeto:

{
  "mcpServers": {
    "orbita": {
      "type": "http",
      "url": "https://mcp.nexxo.tec.br/mcp",
      "oauth": {
        "clientId": "CLIENT_ID_CADASTRADO_PARA_CLAUDE",
        "callbackPort": 8765,
        "scopes": "openid profile email offline_access"
      }
    }
  }
}

O arquivo contém o ID público e o endpoint. A sessão OAuth permanece vinculada à pessoa; não inclua access tokens ou refresh tokens nele. O Claude pode pedir a aprovação do cadastro de projeto antes de conectar.

Referência do cliente: MCP no Claude Code.