okokumo in Ihrem KI-Assistenten

Ein gehosteter MCP-Server für Claude, ChatGPT, Cursor, VS Code und jeden anderen MCP-Client — Anmeldung im Browser oder API-Schlüssel, dieselben Regeln wie die REST-API, in jedem Tarif.

okokumo betreibt einen offiziellen, gehosteten Model-Context-Protocol-Server. Verbinden Sie ihn mit einem KI-Assistenten, und Sie können fragen, welche Checks ausgefallen sind, ob Sie alarmiert wurden, wie die Verfügbarkeit eines Checks diese Woche war — oder ihn einen Check anlegen, einen für ein Deployment pausieren oder einen Incident auf Ihrer Statusseite beschreiben lassen.

Er ist eine dünne Schicht über der öffentlichen REST-API: Jedes Tool ist ein Aufruf einer /v1-Route, in Ihrem Namen — per Anmeldung im Browser oder per API-Schlüssel —, durch dieselbe Authentifizierung, dieselbe Trennung nach Organisation, dieselben Rollenprüfungen und Tariflimits. Er kann nichts, was ein API-Schlüssel nicht schon per REST kann.

Endpunkt: https://app.okokumo.com/mcp, MCP Streamable HTTP
Authentifizierung: Anmeldung im Browser (OAuth), der Client braucht nur die URL; oder ein okokumo-API-Schlüssel, gesendet als Authorization: Bearer sk_…
Tarife: alle, Free eingeschlossen
Ratenlimit: das API-Budget Ihrer Organisation, 120 Anfragen pro Minute, geteilt mit REST

1. Per Anmeldung im Browser verbinden (empfohlen)

Claude, ChatGPT, Cursor, VS Code und Claude Code verbinden sich allein mit der URL https://app.okokumo.com/mcp. Kein Schlüssel, den Sie erstellen, einfügen oder aus git heraushalten müssen.

Fügen Sie okokumo mit dieser URL zu Ihrem Client hinzu (je Client unten).
Der Client öffnet okokumo in Ihrem Browser. Melden Sie sich an, falls nötig.
Ein Zustimmungsbildschirm zeigt den Namen der App, die Adresse, zu der sie Sie zurückschickt, Ihre Organisation und was die App erhält: vollen Zugriff, genau wie ein API-Schlüssel, mit Ihrer Rolle. Genehmigen oder ablehnen. Genehmigen Sie nur eine Verbindung, die Sie selbst gestartet haben.
Zurück im Client stehen die Tools bereit.

Nur Owner und Admins können genehmigen — dieselbe Regel wie beim Erstellen eines API-Schlüssels. Die App wird mit der Organisation verbunden, die auf dem Zustimmungsbildschirm steht, und nur mit dieser.

Claude (claude.ai, Claude Desktop)

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

ChatGPT

Fügen Sie in den Connector-Einstellungen von ChatGPT einen benutzerdefinierten Connector mit derselben URL hinzu.

Claude Code

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

Führen Sie dann in Claude Code /mcp aus, wählen Sie okokumo und melden Sie sich an.

Cursor

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

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

Cursor bietet die Anmeldung dann in seinen MCP-Einstellungen an.

VS Code

In .vscode/mcp.json:

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

VS Code fordert Sie beim Start des Servers zur Anmeldung auf.

Bisher durchgängig getestet: Claude Code und der MCP Inspector. claude.ai, ChatGPT, Cursor und VS Code implementieren dieselbe MCP-Autorisierungsspezifikation, wurden aber noch nicht live mit okokumo ausprobiert. Wenn einer davon scheitert, sagen Sie es uns; ein API-Schlüssel (Abschnitt 3) funktioniert in der Zwischenzeit.

2. Verbundene Apps und Widerruf

Account → Connected apps listet jede mit Ihrer Organisation verbundene App: ihren Namen, wer sie wann verbunden hat und wann sie zuletzt genutzt wurde. Jedes Mitglied sieht die Liste; Owner und Admins können eine App dort widerrufen (Revoke). Der Widerruf wirkt sofort: Die App wird bei ihrer nächsten Anfrage abgewiesen.

Zugriffstokens gelten eine Stunde und erneuern sich selbst. Eine App, die 30 Tage lang ungenutzt bleibt, muss erneut genehmigt werden.
Ein Passwort-Reset, ein gesperrtes Konto oder das Entfernen aus der Organisation trennt jede App, die diese Person verbunden hat.

3. Oder einen API-Schlüssel verwenden

Für Skripte, CI und Clients ohne OAuth-Anmeldung. API-Schlüssel funktionieren genau wie bisher, neben den verbundenen Apps.

Im Dashboard unter Account → API keys (Owner und Admins). Der Schlüssel wird nur einmal angezeigt.

Ein Schlüssel handelt mit der Rolle der Person, die ihn erstellt hat. Der Schlüssel eines Owners oder Admins kann alles unten Aufgeführte; der eines Mitglieds kann Checks verwalten, aber keine Incidents — genau wie per REST.
Verwenden Sie einen Schlüssel pro Client — einen für Claude Code, einen für Cursor —, damit sich jeder einzeln widerrufen lässt. Der Schlüssel wird bei jeder Anfrage geprüft: Ein widerrufener Schlüssel trennt den Client bei seiner nächsten Nachricht.
Die Konfiguration unten enthält ein Geheimnis. Behandeln Sie sie wie eine Passwortdatei und halten Sie sie aus git heraus.

4. Client mit einem Schlüssel verbinden

Ersetzen Sie sk_… durch Ihren Schlüssel.

Claude Code

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

Für eine projektweite .mcp.json (--scope project) schreiben Sie Bearer ${OKOKUMO_API_KEY} in den Header und exportieren die Variable in Ihrer Shell — so landet der Schlüssel nie im Repository.

Claude Desktop

Der benutzerdefinierte Connector aus Abschnitt 1 braucht keinen Schlüssel. Wenn Sie stattdessen einen Schlüssel verwenden möchten, verbinden Sie sich über die Brücke mcp-remote (benötigt 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_…" }
    }
  }
}

Der Header-Wert läuft über env, weil manche Plattformen Argumente am Leerzeichen in Bearer sk_… trennen. Starten Sie Claude Desktop nach der Änderung neu.

Cursor

In ~/.cursor/mcp.json (alle Projekte) oder .cursor/mcp.json (ein Projekt):

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

Andere Clients

Jeder MCP-Client, der Streamable HTTP spricht und einen Authorization-Header senden kann, verbindet sich genauso: der Endpunkt oben, Ihr Schlüssel als Bearer-Token.

5. Was er kann

18 Tools: 10 lesende, 8 schreibende. Keines löscht etwas, keines berührt API-Schlüssel — Löschen und Schlüsselverwaltung bleiben im Dashboard.

Lesen: Ihr Konto; Ihre Checks; Verfügbarkeit und Latenz eines Checks über einen Tag, eine Woche oder einen Monat; seine Zustandswechsel; die Alarme, die er gesendet hat; die Kanäle, die er alarmiert; Ihre Kanäle; Ihre Statusseite und ihre Incidents.
Schreiben: einen Check anlegen, ändern, pausieren, fortsetzen, festlegen, welche Kanäle er alarmiert; einen Incident anlegen, ändern, ein Update dazu veröffentlichen.

Was sich bewusst von einem direkten REST-Aufruf unterscheidet:

Teilweise Updates. Das Ändern eines Checks oder Incidents ändert nur die Felder, die Sie nennen; das Tool liest zuerst den aktuellen Datensatz und behält den Rest.
Dauern in Sekunden. grace_seconds: 600 sind zehn Minuten. Die Tool-Beschreibungen sagen das, weil Minuten hier der klassische Fehler eines Modells sind.
Ping-URLs inklusive. Heartbeat- und Cron-Checks kommen mit der ping_url zurück, die der Job aufrufen muss.
Kanal-Geheimnisse bleiben aus dem Verlauf. Webhook-URLs, Signatur-Secrets und Telegram-Chat-IDs werden nie zurückgegeben.
Strikte Argumente. Ein unbekanntes Argument wird mit der Liste der akzeptierten abgelehnt, statt stillschweigend ignoriert zu werden.
Schreibzugriffe sind gekennzeichnet. Jedes Tool erklärt, ob es nur liest oder was es ändert, damit Ihr Client vor einem Schreibzugriff nachfragen kann. Einen Check zu pausieren oder sein Alarm-Routing einzuschränken gilt als destruktiv — es bedeutet Alarme, die nicht gesendet werden —, und das Modell ist angewiesen, zuerst bei Ihnen nachzufragen und einen Incident nur auf Ihren Wunsch zu veröffentlichen: Incidents beginnen als private Entwürfe.

6. Limits und Fehler

Jede Anfrage an /mcp zählt gegen die 120 Anfragen pro Minute Ihrer Organisation — dasselbe Budget wie REST, beide werden addiert. Tools, die vor dem Schreiben lesen (einen Check ändern, pausieren oder fortsetzen, einen Incident ändern), zählen doppelt.
Über dem Limit erfährt der Assistent, wie viele Sekunden er warten soll, und dass er nicht in einer Schleife wiederholen soll.
Ein abgelehnter Aufruf — Tariflimit, nicht berechtigte Rolle, nicht existierende ID — kommt als Fehler zurück, den das Modell lesen und Ihnen erklären kann, mit dem HTTP-Status am Ende.
Ein unbekannter oder widerrufener Schlüssel erhält 401: Erstellen Sie einen neuen Schlüssel und aktualisieren Sie die Konfiguration des Clients. Eine widerrufene App erhält dieselbe Antwort und muss erneut genehmigt werden.

Kostenlos starten — 5 Checks Preise ansehen