API, CLI en MCP

Een client, als je er een wilt

Eén bestand, Python 3.9 of nieuwer, geen dependencies. Download het, maak het uitvoerbaar, en zet je token in de omgeving. Het doet alles wat de API doet, want elke opdracht is één call naar de routes hierboven.

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

De tweede regel is de moeite waard om uit te voeren. Die controleert het bestand tegen de digest die we naast het bestand publiceren, wat de digest is van precies wat deze server verstuurt, zodat een download die onderweg is aangepast niet overeenkomt. ./nomore404.py --version geeft aan van welke release het afkomstig is, en elke aanvraag die het doet vermeldt hetzelfde in zijn User-Agent.

De token komt uit N404_TOKEN of uit een nomore404.env-bestand naast het script, nooit uit een commandoregelvlag: een argument is zichtbaar in ps voor elke gebruiker op de machine en blijft in je shellgeschiedenis staan.

Voor een assistent

Een assistant kan dit account lezen en wijzigen via het Model Context Protocol. Er zijn twee manieren om toegang te krijgen en die zijn niet hetzelfde.

Eén adres, niets te installeren

Plak dit waar je assistant vraagt om een aangepaste connector. Het stuurt je hierheen om in te loggen en aan te geven voor welke organisatie de verbinding is, en dat is de hele setup.

Het handelt als jij: je rol wordt bij elke oproep gelezen, dus een assistant die is verbonden door iemand die alleen mag lezen, kan alleen lezen. Het leest monitors, storingen, uptime, onderhoudsvensters en groepen, en het kan ze toevoegen en wijzigen, inclusief het verwijderen van een monitor en de geschiedenis ervan. Ontkoppel het wanneer je wilt via API-tokens, waar het naast hen wordt vermeld.

Of voer het zelf uit en laat het blijven lezen

nomore404_mcp.py biedt dezelfde API als tools vanaf je eigen machine. Houd het naast nomore404.py, die het gebruikt voor de token en voor paginering. Het leest en schrijft nooit, wat de reden is om het te kiezen: een assistant is een beller die tot dingen kan worden overgehaald, en een tool die een monitor en zijn geschiedenis verwijdert, is één prompt verwijderd van gebruik.

Twee bestanden, een token ernaast, en één regel om de server te registreren. 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"

Alles wat het protocol spreekt is hetzelfde commando geschreven als JSON, waar die client zijn servers ook bewaart:

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

Geen van beide noemt de token, omdat dat niet zou moeten: het wordt gelezen uit nomore404.env naast de scripts, of uit N404_TOKEN in de omgeving waarmee de assistant het start. Vraag het daarna wat er down is, waarom een incident is geopend, of hoe een monitor deze maand heeft gepresteerd.

Beide zijn een paar honderd regels en de moeite waard om te lezen voordat je ze uitvoert. Geen van beide is verpakt of ondertekend, en niets weerhoudt je ervan om je eigen client te genereren vanuit het document.

Fouten en lange lijsten

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

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

Hoeveel je mag vragen

Eén token mag honderdtwintig oproepen per minuut doen. Elk antwoord bevat RateLimit-Remaining en RateLimit-Reset, zodat een goed functionerende client zichzelf kan reguleren in plaats van de limiet te vinden door deze te overschrijden. Over de limiet is een 429 met Retry-After.

Maak een gratis account aan