okokumo in uw AI-assistent

okokumo draait een officiële, gehoste Model Context Protocol-server. Koppel hem aan een AI-assistent en u kunt vragen welke checks down zijn, of u gewaarschuwd bent, wat de uptime van een check deze week was — of hem een check laten aanmaken, er een pauzeren voor een deploy, of een incident op uw statuspagina laten beschrijven.

Het is een dunne laag boven op de publieke REST-API: elke tool is een aanroep van een /v1-route, namens u — via een login in de browser of een API-sleutel — met dezelfde authenticatie, dezelfde scheiding per organisatie, dezelfde rolcontroles en abonnementslimieten. Hij kan niets wat een API-sleutel niet al via REST kan.

• Endpoint: https://app.okokumo.com/mcp, MCP Streamable HTTP
• Authenticatie: inloggen via de browser (OAuth), de client heeft alleen de URL nodig; of een okokumo-API-sleutel, verstuurd als Authorization: Bearer sk_…
• Abonnementen: allemaal, Free inbegrepen
• Rate limit: het API-budget van uw organisatie, 120 verzoeken per minuut, gedeeld met REST

1. Koppelen door in te loggen (aanbevolen)

Claude, ChatGPT, Cursor, VS Code en Claude Code koppelen met alleen de URL https://app.okokumo.com/mcp. Geen sleutel om aan te maken, te plakken of buiten git te houden.

1. Voeg okokumo met die URL toe aan uw client (per client hieronder).
2. De client opent okokumo in uw browser. Log in als u dat nog niet bent.
3. Een toestemmingsscherm toont de naam van de app, het adres waar hij u naar terugstuurt, uw organisatie en wat de app krijgt: volledige toegang, dezelfde als een API-sleutel, met uw rol. Keur goed of weiger. Keur alleen een koppeling goed die u zelf hebt gestart.
4. Terug in de client staan de tools klaar.

Alleen eigenaren en admins kunnen goedkeuren, dezelfde regel als voor het aanmaken van een API-sleutel. De app wordt gekoppeld aan de organisatie die op het toestemmingsscherm staat, en alleen aan die.

Claude (claude.ai, Claude Desktop)

Settings → Connectors → Add custom connector, met de URL https://app.okokumo.com/mcp.

ChatGPT

Voeg in de connectorinstellingen van ChatGPT een aangepaste connector toe met dezelfde URL.

Claude Code

claude mcp add --transport http okokumo https://app.okokumo.com/mcp

Voer daarna /mcp uit in Claude Code, kies okokumo en log in.

Cursor

In ~/.cursor/mcp.json of .cursor/mcp.json:

{
  "mcpServers": {
    "okokumo": { "url": "https://app.okokumo.com/mcp" }
  }
}

Cursor biedt daarna aan om in te loggen vanuit zijn MCP-instellingen.

VS Code

In .vscode/mcp.json:

{
  "servers": {
    "okokumo": { "type": "http", "url": "https://app.okokumo.com/mcp" }
  }
}

VS Code vraagt u in te loggen wanneer het de server start.

Tot nu toe van begin tot eind getest: Claude Code en de MCP Inspector. claude.ai, ChatGPT, Cursor en VS Code implementeren dezelfde MCP-autorisatiespecificatie, maar zijn nog niet live met okokumo geprobeerd. Werkt een ervan niet, laat het ons weten; een API-sleutel (sectie 3) werkt intussen wel.

2. Gekoppelde apps en intrekken

Account → Connected apps toont elke app die aan uw organisatie gekoppeld is: de naam, wie hem koppelde en wanneer, en wanneer hij voor het laatst gebruikt is. Elk lid ziet de lijst; eigenaren en admins kunnen een app daar intrekken (Revoke). Intrekken werkt meteen: de app wordt bij zijn volgende verzoek geweigerd.

• Toegangstokens gelden een uur en vernieuwen zichzelf. Een app die 30 dagen ongebruikt blijft, moet opnieuw worden goedgekeurd.
• Een wachtwoordreset, een geschorst account of verwijdering uit de organisatie ontkoppelt elke app die die persoon koppelde.

3. Of gebruik een API-sleutel

Voor scripts, CI en clients zonder OAuth-login. API-sleutels werken precies zoals voorheen, naast gekoppelde apps.

In het dashboard, Account → API keys (eigenaren en admins). De sleutel wordt één keer getoond.

• Een sleutel handelt met de rol van degene die hem aanmaakte. De sleutel van een eigenaar of admin kan alles hieronder; die van een lid kan checks beheren maar geen incidenten — precies zoals via REST.
• Gebruik één sleutel per client — een voor Claude Code, een voor Cursor — zodat u elke apart kunt intrekken. De sleutel wordt bij elk verzoek gecontroleerd: een ingetrokken sleutel sluit de client af bij zijn volgende bericht.
• De configuratie hieronder bevat een geheim. Behandel haar als een wachtwoordbestand en houd haar buiten git.

4. Koppel een client met een sleutel

Vervang sk_… door uw sleutel.

Claude Code

claude mcp add --transport http okokumo https://app.okokumo.com/mcp \
  --header "Authorization: Bearer sk_…"
claude mcp get okokumo

Voor een projectbrede .mcp.json (--scope project) zet u Bearer ${OKOKUMO_API_KEY} in de header en exporteert u de variabele in uw shell, zodat de sleutel nooit in de repository belandt.

Claude Desktop

De aangepaste connector uit sectie 1 heeft geen sleutel nodig. Wilt u toch een sleutel gebruiken, koppel dan via de brug mcp-remote (vereist Node.js) in claude_desktop_config.json:

{
  "mcpServers": {
    "okokumo": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://app.okokumo.com/mcp",
               "--header", "Authorization:${OKOKUMO_AUTH}"],
      "env": { "OKOKUMO_AUTH": "Bearer sk_…" }
    }
  }
}

De headerwaarde gaat via env omdat sommige platforms argumenten splitsen op de spatie in Bearer sk_…. Herstart Claude Desktop na het bewerken.

Cursor

In ~/.cursor/mcp.json (alle projecten) of .cursor/mcp.json (één project):

{
  "mcpServers": {
    "okokumo": {
      "url": "https://app.okokumo.com/mcp",
      "headers": { "Authorization": "Bearer sk_…" }
    }
  }
}

Andere clients

Elke MCP-client die Streamable HTTP spreekt en een Authorization-header kan meesturen, koppelt op dezelfde manier: het endpoint hierboven, uw sleutel als bearer-token.

5. Wat hij kan

18 tools: 10 die lezen, 8 die schrijven. Niets verwijdert iets, niets raakt API-sleutels — verwijderen en sleutelbeheer blijven in het dashboard.

• Lezen: uw account; uw checks; de uptime en latency van een check over een dag, week of maand; zijn statuswijzigingen; de alerts die hij verstuurde; de kanalen die hij waarschuwt; uw kanalen; uw statuspagina en haar incidenten.
• Schrijven: een check aanmaken, wijzigen, pauzeren, hervatten, kiezen welke kanalen hij waarschuwt; een incident aanmaken, wijzigen, er een update bij plaatsen.

Wat bewust anders werkt dan zelf REST aanroepen:

• Gedeeltelijke updates. Een check of incident wijzigen verandert alleen de velden die u noemt; de tool leest eerst het huidige record en behoudt de rest.
• Duur in seconden. grace_seconds: 600 is tien minuten. De toolbeschrijvingen zeggen dat, omdat minuten hier de klassieke fout van een model zijn.
• Ping-URL's inbegrepen. Heartbeat- en cron-checks komen terug met de ping_url die de job moet aanroepen.
• Kanaalgeheimen blijven buiten het gesprek. Webhook-URL's, ondertekeningsgeheimen en Telegram-chat-id's worden nooit teruggegeven.
• Strikte argumenten. Een onbekend argument wordt geweigerd met de lijst van geaccepteerde, in plaats van stilzwijgend genegeerd.
• Schrijfacties zijn gemarkeerd. Elke tool geeft aan of hij alleen leest of wat hij verandert, zodat uw client kan vragen voordat hij iets schrijft. Een check pauzeren of zijn alertroutering beperken geldt als destructief — het betekent alerts die niet verstuurd worden — en het model krijgt de instructie eerst bij u te bevestigen, en een incident alleen te publiceren als u daarom vraagt: incidenten beginnen als privéconcept.

6. Limieten en fouten

• Elk verzoek naar /mcp telt mee in de 120 verzoeken per minuut van uw organisatie — hetzelfde budget als REST, en die tellen op. Tools die lezen voordat ze schrijven (een check wijzigen, pauzeren of hervatten, een incident wijzigen) tellen dubbel.
• Boven de limiet hoort de assistent hoeveel seconden hij moet wachten, en dat hij niet in een lus opnieuw moet proberen.
• Een geweigerde aanroep — een abonnementslimiet, een rol die het niet mag, een id die niet bestaat — komt terug als een fout die het model kan lezen en u kan uitleggen, eindigend met de HTTP-status.
• Een onbekende of ingetrokken sleutel krijgt 401: maak een nieuwe sleutel aan en werk de configuratie van de client bij. Een ingetrokken app krijgt hetzelfde antwoord en moet opnieuw worden goedgekeurd.