API, CLI e MCP

Um cliente, se quiseres um

Um ficheiro, Python 3.9 ou mais recente, sem dependências. Faz o download, torna-o executável e coloca o teu token no ambiente. Faz tudo o que a API faz, porque cada comando é uma chamada às rotas acima.

nomore404.py nomore404_mcp.py

curl -O https://nomore404.com/api/nomore404.py
curl -s https://nomore404.com/api/nomore404.py.sha256 | sha256sum -c
chmod +x nomore404.py
export N404_TOKEN=n404_...

./nomore404.py monitors list
./nomore404.py monitors add --type https --target shop.example.com
./nomore404.py incidents --state open

Vale a pena executar a segunda linha. Verifica o ficheiro contra o digest que publicamos ao lado, que é o digest exatamente do que este servidor envia, então um download que foi alterado no caminho não corresponde. ./nomore404.py --version indica de que versão veio, e cada pedido que faz diz o mesmo no seu User-Agent.

O token vem de N404_TOKEN ou de um ficheiro nomore404.env ao lado do script, nunca de uma flag na linha de comandos: um argumento é visível em ps para todos os utilizadores na máquina e fica no histórico do teu shell.

Para um assistente

Um assistente pode ler esta conta e alterá-la, através do Model Context Protocol. Há duas formas de acesso e não são a mesma coisa.

Um endereço, nada para instalar

Cola isto onde o teu assistente pedir um conector personalizado. Vai enviar-te aqui para fazer login e dizer para que organização é a ligação, e isso é toda a configuração.

Age como tu: a tua função é lida em cada chamada, então um assistente ligado por alguém que só pode ler só pode ler. Lê monitores, falhas, uptime, janelas de manutenção e grupos, e pode adicioná-los e alterá-los, o que inclui apagar um monitor e o histórico com ele. Desliga-o quando quiseres em Tokens da API, onde está listado ao lado deles.

Ou executa-o tu mesmo, e mantém-no a ler

nomore404_mcp.py serve a mesma API que as ferramentas da tua própria máquina. Mantém-no ao lado de nomore404.py, que usa para o token e para paginação. Lê e nunca escreve, que é a razão para escolhê-lo: um assistente é um chamador que pode ser convencido a fazer coisas, e uma ferramenta que apaga um monitor e o seu histórico está a um prompt de ser usada.

Dois ficheiros, um token ao lado deles, e uma linha para registar o servidor. Claude Code:

curl -O https://nomore404.com/api/nomore404.py
curl -O https://nomore404.com/api/nomore404_mcp.py
echo 'N404_TOKEN=n404_...' > nomore404.env

claude mcp add nomore404 -- python3 "$PWD/nomore404_mcp.py"

Qualquer outra coisa que fale o protocolo é o mesmo comando escrito como JSON, onde quer que esse cliente mantenha os seus servidores:

{
  "mcpServers": {
    "nomore404": {
      "command": "python3",
      "args": ["/path/to/nomore404_mcp.py"]
    }
  }
}

Nenhum nomeia o token, porque nenhum deve: é lido de nomore404.env ao lado dos scripts, ou de N404_TOKEN no ambiente com que o assistente o inicia. Depois pergunta-lhe o que está down, porque um incidente abriu, ou como um monitor esteve este mês.

Ambos têm algumas centenas de linhas e vale a pena lê-los antes de os executares. Nenhum está empacotado ou assinado, e nada te impede de gerar o teu próprio cliente a partir do documento.

Falhas e listas longas

{
  "error": {
    "code": "monitor_not_found",
    "message": "Nothing here with that id."
  }
}

GET /api/v1/incidents?limit=50
GET /api/v1/incidents?limit=50&cursor=...

Quanto podes pedir

Um token pode fazer cento e vinte chamadas por minuto. Cada resposta inclui RateLimit-Remaining e RateLimit-Reset, para que um cliente bem-comportado possa gerir o ritmo em vez de descobrir o limite ao ultrapassá-lo. Acima do limite, há um 429 com Retry-After.

Cria uma conta grátis