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
Abra o Claude Code, execute /mcp e conclua o login no navegador. Para conferir o cadastro:
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:
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.