Zum Hauptinhalt springen

für Custom Connectors in Grok

Verbinden Sie Grok mit Ihrer Uptime-Überwachung

Der Custom Connector von Grok registriert sich nicht selbst, wie es Claude, Cursor und VS Code tun. Sein Formular fragt nach einer Client-ID, zwei Endpunkt-URLs und einer Liste von Scopes. Fügen Sie die Werte unten ein, speichern Sie, melden Sie sich mit Ihrem Uptimepage-Login an, stimmen Sie auf der Zustimmungsseite zu, und Grok kann im Chat Ihre Monitore, Störungen und Statusseiten lesen.

Das Connector-Formular ausfüllen

Öffnen Sie auf grok.com „Connectors → New Connector → Custom“. Geben Sie die MCP-Server-URL an, und fügen Sie im OAuth-Bereich die Client-ID, den Autorisierungs-Endpunkt und den Token-Endpunkt aus der Tabelle oben ein. Bei „Token auth method“ wählen Sie "none", mit PKCE. Als Scopes beantwortet targets:read status_page:read incidents:read maintenance:read jede Frage; ergänzen Sie channels:read für die Übersicht der Benachrichtigungskanäle und variables:read für Variablenschlüssel. Gewähren Sie einen Schreib-Scope erst, wenn Sie gesehen haben, dass Grok eine Bestätigungsabfrage anzeigt, denn ein Client, der keine anzeigen kann, führt Schreibzugriffe mit dem gewährten Scope aus, ohne dass jemand gefragt wird: incidents:write zum Bestätigen, Beheben oder Veröffentlichen, status_page:write zum Aufbauen einer Seite, maintenance:write zum Planen von Wartungen und targets:write zusammen mit targets:execute zum Anlegen eines Monitors, weil beim Anlegen zuerst sein Check läuft. Die Zustimmungsseite zeigt genau, was gewährt wird. Speichern Sie, und Grok schickt Sie zur Anmeldung.

Warum eine veröffentlichte Client-ID sicher ist

Die ID gehört zu einem öffentlichen Client ohne Secret, sie gewährt also für sich allein nichts. Die einzige dafür registrierte Weiterleitung ist grok.com, ein Autorisierungscode kann also nirgendwo anders hin. PKCE sorgt dafür, dass nur die Grok-Sitzung, die den Ablauf gestartet hat, den Code einlösen kann. Und die Zustimmungsseite bleibt in Ihrer Hand: Sie nennt Ihre Organisation, listet die Fähigkeiten auf, sagt, dass Sie zu grok.com zurückkehren, und stellt nichts aus, bevor Sie auf „Approve“ klicken. Stimmen Sie nur einer Verbindung zu, die Sie selbst gestartet haben.

Was Grok tun kann

Fragen Sie, was ausgefallen ist, und Grok ruft get_org_health auf, dann get_monitor_history für den Monitor, auf den es ankommt, mit der Antwortzeit aufgeteilt in DNS, Verbindungsaufbau, TLS und erstes Byte. Fragen Sie nach einer Störung, und Grok liest die Zeitleiste und die Updates Ihres Teams. Fragen Sie nach den Zahlen des Monats, und get_incident_metrics liefert MTTA, MTTR und die Monitore mit den meisten Alarmen. Alle 39 Tools werden aufgelistet, aber die Scopes oben sind Lese-Scopes, also funktionieren die 19 Lese-Tools, und dort liegt ohnehin der größte Nutzen; die 20, die handeln, verweigern den Dienst, bis auf der Zustimmungsseite ein Schreib-Scope gewährt wird. Ist einer gewährt, fragt jedes davon Sie zuerst, wenn Grok die Abfrage anzeigen kann, und läuft andernfalls mit dem gewährten Scope, im Audit-Trail als unbestätigt markiert.

Drei Prompts für den Anfang

„Was ist gerade kaputt, und wie lange schon?“ „Die Störungen dieser Woche mit denen der letzten Woche vergleichen und sagen, welcher Monitor die meisten verursacht hat.“ „Ist der Checkout-Flow langsamer als vor einem Monat, und bei welchem Schritt?“ Die letzte Frage liest get_flow_step_trend, das pro Schritt meldet, wie sich die mittlere Dauer verändert hat und wie viele Läufe ihn bestanden haben oder an ihm gescheitert sind. So fällt ein Login, der zwar noch besteht, aber doppelt so lange braucht, auf, bevor er fehlschlägt.

Grok Build und andere Clients mit festem Header

Ein Client, der statt OAuth einen statischen Authorization-Header sendet, darunter Grok Build, funktioniert mit einem API-Token mit Scopes: Erstellen Sie in der App unter „Settings → API tokens“ ein an die Organisation gebundenes, nur lesendes Token mit Ablaufdatum, und setzen Sie den Header auf Bearer, gefolgt vom Token. Wer selbst hostet, registriert mit dem Befehl unten einmal einen eigenen Client und fügt die zurückgegebene client_id in dasselbe Formular ein, mit den eigenen Hosts für die beiden Endpunkte. Stimmen Sie direkt danach einmal zu: Ein Client, dem innerhalb einer Woche nach der Registrierung niemand zugestimmt hat, wird entfernt.

Selbst gehostet: einen eigenen Grok-Client registrieren

curl -X POST https://app.example.com/oauth/register \
  -H 'Content-Type: application/json' \
  -d '{"client_name":"Grok","redirect_uris":["https://grok.com/connectors-oauth-exchange-code/"]}'

Häufige Fragen

Warum fragt Grok nach einer Client-ID?
Der Custom Connector von Grok beherrscht keine dynamische Client-Registrierung und kann sich deshalb nicht selbst registrieren wie andere Clients. Die gemeinsame Client-ID auf dieser Seite ist für den Callback von Grok registriert; fügen Sie sie mit den beiden Endpunkten und den Scopes ein.
Ist es sicher, dass die Client-ID öffentlich ist?
Ja. Es ist ein öffentlicher Client ohne Secret, die einzige hinterlegte Weiterleitung ist grok.com, und PKCE sorgt dafür, dass nur die Grok-Sitzung, die den Ablauf gestartet hat, den Code einlösen kann. Nichts wird gewährt, bis Sie sich selbst anmelden und auf der Zustimmungsseite zustimmen.
Welche Scopes soll ich einfügen?
targets:read status_page:read incidents:read maintenance:read beantwortet jede Frage; channels:read und variables:read ergänzen die Übersicht der Kanäle und die Variablenschlüssel. Gewähren Sie einen Schreib-Scope erst, wenn Grok Ihnen eine Bestätigungsabfrage gezeigt hat, und beachten Sie, dass das Anlegen eines Monitors targets:execute neben targets:write braucht. Die Zustimmungsseite listet genau auf, was gewährt wird.
Kann ich es stattdessen mit Grok Build nutzen?
Ja. Grok Build sendet einen statischen Authorization-Header. Erstellen Sie also in der App ein an die Organisation gebundenes, nur lesendes API-Token mit Ablaufdatum und setzen Sie den Header auf Bearer, gefolgt vom Token. Ganz ohne OAuth-Formular.

Auf einen Blick

  • MCP-Server-URL https://mcp.uptimepage.dev/mcp
  • Client-ID ump_DWhz9cACC1T6Tr-5oEw2qw
  • Autorisierungs-Endpunkt https://app.uptimepage.dev/oauth/authorize
  • Token-Endpunkt https://app.uptimepage.dev/oauth/token
  • Token-Authentifizierung none (PKCE)
  • Scopes targets:read status_page:read incidents:read maintenance:read
  • Hinterlegter Callback nur grok.com
  • Einstiegspreis kostenlos, ohne Karte

Links

In unter 5 Minuten startklar.

Kostenlos starten

Funktionen · Preise · Notizen