Onde adicionar a configuração
Prefira o comando do próprio cliente quando ele estiver disponível. O comando grava a configuração no formato esperado e reduz o risco de editar o arquivo errado. Para configuração manual, estes são os caminhos mais comuns em Linux e macOS:
| Cliente | Configuração do usuário | Configuração do projeto |
|---|---|---|
| Codex | ~/.codex/config.toml | <projeto>/.codex/config.toml |
| Claude Code | ~/.claude.json | <projeto>/.mcp.json |
| OpenCode | ~/.config/opencode/opencode.json ou .jsonc | <projeto>/opencode.json ou <projeto>/.opencode/opencode.json |
| Pi | ~/.pi/agent/mcp.json ou ~/.config/mcp/mcp.json | <projeto>/.mcp.json ou <projeto>/.pi/mcp.json |
| Hermes Agent | ~/.hermes/config.yaml | — |
~ representa a pasta pessoal do usuário. Uma configuração de usuário fica disponível em vários projetos; uma configuração de projeto acompanha somente aquele diretório e pode ser compartilhada com a equipe quando o cliente permitir.
No Codex e no Claude Code, prefira codex mcp add e claude mcp add para gravar a configuração. No OpenCode e no Pi, edite o JSON/JSONC ou use o gerenciamento do próprio cliente. No Hermes Agent, edite o YAML e execute hermes mcp login zenifra.
Adicione somente a URL pública e os campos indicados neste guia. Não coloque access tokens, refresh tokens, client secrets ou cookies nesses arquivos. Cada cliente armazena as credenciais OAuth pelo próprio fluxo de autenticação. No Windows, prefira os comandos do cliente e consulte sua referência oficial para localizar o arquivo correspondente.
Última atualização em