# Presets e permissões

Na tela de aprovação você escolhe um de três níveis. Os dois primeiros são prontos; o terceiro deixa você marcar item por item. Em todos, o Claude só enxerga os projetos que você escolher.

## Os três níveis

| Nível | O que o Claude consegue | Escopos concedidos |
|---|---|---|
| **Somente leitura** | Consultar projetos, variáveis e logs. Não altera nada. | `projects:read`, `env:read`, `logs:read` |
| **Operar** | Publicar, alterar variáveis, domínios, volumes e bancos, instanciar templates e ler logs. Não apaga nada. | `projects:read`, `projects:write`, `deploy`, `env:read`, `env:write`, `domains:write`, `volumes:write`, `databases:write`, `logs:read`, `templates:deploy` |
| **Personalizado** | Só o que você marcar. Precisa incluir **Ver projetos e serviços**. | Lista abaixo |

:::note
A tela de aprovação mostra um resumo do nível **Operar** com 7 escopos. A conexão de fato recebe 10: além dos 7, `volumes:write`, `databases:write` e `templates:deploy`. A tabela acima é o que a API concede.
:::

## Escopos do Personalizado, em linguagem simples

| Opção na tela | Escopo | Permite |
|---|---|---|
| Ver projetos e serviços | `projects:read` | listar e ver detalhes, deploys e domínios |
| Gerenciar projetos e serviços | `projects:write` | criar projetos e serviços, ajustar CDN |
| Publicar e reverter | `deploy` | disparar deploys |
| Ler variáveis | `env:read` | ver variáveis (valores sensíveis ficam mascarados) |
| Alterar variáveis | `env:write` | criar e mudar variáveis |
| Gerenciar domínios | `domains:write` | adicionar, verificar e ajustar domínios |
| Gerenciar volumes | `volumes:write` | volumes dos serviços |
| Gerenciar bancos | `databases:write` | bancos dos projetos |
| Ler logs | `logs:read` | logs de build e de execução |
| Instanciar templates | `templates:deploy` | criar a partir de templates |

## O que nunca é concedido

- **Apagar e reverter** não é uma opção que você marca: essas ações passam sempre por aprovação humana ([veja como](/mcp/acoes-destrutivas/)).
- **Revelar segredos**: o valor de variáveis sensíveis continua mascarado para o Claude.
- Ver dados dentro dos bancos (as ferramentas de explorador de dados) exige um escopo que o login pelo navegador não concede. Hoje isso só funciona com [token de API](/mcp/claude-code-e-cli/) que tenha esse escopo. Confirme na prática antes de depender disso.

## Mudar depois

Em **Configurações**, **Aplicativos conectados**, o botão **Editar** altera nome, nível e projetos. Ampliar o acesso pede confirmação de identidade. Para reduzir, basta editar ou clicar em **Revogar**.

## Próximos passos

- [Ações que pedem aprovação](/mcp/acoes-destrutivas/)
- [Tokens e escopos](/seguranca/tokens-e-escopos/)
