# Problemas comuns

Todo erro vem com um **código estável**, uma mensagem e, quase sempre, uma
dica. A lista completa, em inglês, está em [errors.md](../errors.md). Aqui vão os
que mais aparecem.

## `not logged in` / `unauthorized`

Você ainda não entrou nesta máquina, ou o token expirou ou foi revogado.
Rode `rapadura login`.

## `not_invited`

Seu usuário do GitHub ainda não foi convidado. Mande o usuário para o
administrador e tente de novo depois do convite.

## `login_unavailable`

O login pelo GitHub está desligado no gateway no momento. Peça um token ao
administrador e use `RAPADURA_TOKEN`, ou aguarde.

## `slug_taken`, `slug_reserved`, `invalid_slug`

O nome já existe, é reservado ou tem caractere inválido. Use letras
minúsculas, dígitos e hifens simples, e escolha outro nome. Veja
[Regras e limites](regras.md#nomes).

## `archive_forbidden_file`

A pasta tem arquivo que não pode subir: código de servidor (`.php` e
similares) ou segredos (`.env`, chaves). A mensagem lista cada um. Publique
só a pasta de saída do build, ou remova os arquivos. Não existe opção para
forçar.

## `archive_too_large` / `quota_exceeded`

Passou do tamanho ou do número de sites. `rapadura zones` mostra os limites.
Reduza, apague um site antigo ou peça mais ao administrador.

## `publish_failed`

O servidor recusou a configuração ou a verificação pós-publicação falhou.
A versão anterior continua no ar. Tente de novo; se persistir, mande a
mensagem completa ao administrador.

## O site não abre em HTTPS logo depois de publicar

A primeira visita a um endereço novo emite o certificado e pode levar de 5 a
15 segundos. Recarregue. Se depois de um minuto ainda falhar, confira
`rapadura sites show <nome>` e avise o administrador.

## "command not found: rapadura"

O instalador coloca o binário em `~/.local/bin`. Adicione ao PATH
(`export PATH="$HOME/.local/bin:$PATH"` no seu `.bashrc`/`.zshrc`) ou chame
pelo caminho completo. No Windows, veja [Começando](comecando.md#2-instale-a-cli).

## O agente diz que não encontra o servidor MCP

Garanta que `rapadura` está no PATH que o agente usa, ou registre com o
caminho completo do binário. Teste no terminal: `rapadura whoami` tem que
funcionar antes de o MCP funcionar.

## Quero o site de volta depois de apagar

Os arquivos ficam guardados por um tempo. Peça ao administrador para
restaurar; informe o endereço completo.