incident.io über MCP mit Gemini verbinden

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → incident.io klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein git clone, kein lokaler Server.

incident.io + Gemini

Incident Response mit incident.io in jedem KI-Agent: Incidents mit Updates und Timeline lesen, Schweregrade, Status, Rollen, Typen und Custom Fields nachschlagen, Actions und Follow-ups pflegen, Alerts lesen und auflösen, sehen, wer Bereitschaft hat, Personen per Eskalation alarmieren sowie Benutzer, Teams und den Katalog durchsuchen. Der Connector kann auch Incidents ausrufen, bearbeiten und Updates posten.

Voraussetzungen

Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:

INCIDENT_IO_API_KEY

Schritt 1 — Zugangsdaten holen

Die Einrichtung dauert etwa 2 Minuten. Du brauchst ein incident.io-Konto und einen API-Key.

1. Öffne in incident.io Settings, API keys (https://app.incident.io/settings/api-keys) und klicke auf Add new. Das kann nur ein Admin oder eine Rolle, die API-Keys verwalten darf.
2. Gib dem Key einen Namen und hake an, was er darf. Zum Lesen braucht er mindestens View Data (viewer) sowie das Ansehen von Katalog, Schedules und On-Call; private Incidents brauchen eine eigene Berechtigung. Zum Schreiben kommen Incidents anlegen, Incidents bearbeiten, Actions und Follow-ups verwalten, Eskalationen anlegen usw. dazu. Ein Tool, für das dem Key die Berechtigung fehlt, antwortet mit 403.
3. Kopiere den Key (er wird nur einmal angezeigt) ohne Bearer davor in INCIDENT_IO_API_KEY. Der Connector schickt ihn als Bearer-Token an https://api.incident.io.
4. Installiere den Connector und führe incident_io_get_identity aus: Es zeigt den Namen des Keys, die Dashboard-URL deiner Organisation und die Rollen des Keys, etwa viewer, incident_creator, incident_editor, on_call_viewer oder escalation_creator.

Was gerade los ist: incident_io_list_incidents mit status_category: ["live"] (in der App „Active“) oder ["triage"], neueste zuerst, mit Referenz, Name, Zusammenfassung, Status, Schweregrad, Typ, Modus, Sichtbarkeit, Rollen, Custom Fields, Zeitstempeln, Slack-Channel und Permalink. Filtern kannst du nach Statuskategorie, Status, Schweregrad (mit severity_gte auch „mindestens so schwer wie“), Typ, Modus und Erstellungs- oder Änderungsdatum, verknüpft mit filter_mode all oder any; Filter auf Custom Fields und Rollen kommen in extra_filters. Danach liefert incident_io_get_incident den ganzen Incident mit Dauer-Kennzahlen und Postmortem-Link, incident_io_list_incident_updates die Updates und incident_io_list_incident_timeline_items Notizen, angeheftete Nachrichten und Updates der Reihe nach. Test- und Tutorial-Incidents bleiben ausgeblendet, solange du diese Modi nicht ausdrücklich abfragst.

Konfiguration zum Nachschlagen der IDs: incident_io_list_severities, incident_io_list_incident_statuses, incident_io_list_incident_roles, incident_io_list_incident_types, incident_io_list_custom_fields, incident_io_get_custom_field, incident_io_list_custom_field_options und incident_io_list_incident_timestamps. Die KI liest sie zuerst und nutzt die IDs dann zum Filtern, Anlegen oder Bearbeiten.

Einen Incident führen:

• incident_io_create_incident ruft einen Incident aus, mit Name, Zusammenfassung, Schweregrad, Status, Typ, Sichtbarkeit (public oder private), Modus, Rollen, Custom-Field-Werten und Zeitstempeln. Pflicht sind ein idempotency_key und visibility. Mit Modus test probierst du es ohne echten Incident aus; retrospective erfasst einen vergangenen.
• incident_io_create_incident_update postet ein Update für Responder und Stakeholder und kann dabei Status und Schweregrad ändern.
• incident_io_edit_incident ändert Name, Zusammenfassung, Schweregrad, Status (gelöst wird mit einem Closed-Status), Rollen, Custom Fields, Zeitstempel, Call-Link oder Slack-Channel-Namen. Es ändert sich nur, was du mitgibst; notify_incident_channel informiert den Channel darüber.
• Actions während des Incidents: incident_io_list_actions, incident_io_get_action, incident_io_create_action, incident_io_update_action (outstanding, completed, not_doing).
• Follow-ups nach dem Incident: incident_io_list_follow_ups, incident_io_get_follow_up, incident_io_create_follow_up, incident_io_update_follow_up, mit Priorität, Kategorie, Labels, zuständiger Person oder Team und einem verknüpften externen Ticket (Jira, Linear und andere). Ein Update ersetzt die Action bzw. das Follow-up vollständig, deshalb schickt die KI Text und Status immer mit.

Alerts: incident_io_list_alerts (Filter nach Status wie firing, Quelle, Deduplication-Key oder Datum), incident_io_get_alert, incident_io_list_incident_alerts für die Zuordnung von Alerts zu Incidents und incident_io_resolve_alert, um einen feuernden Alert von Hand aufzulösen, wenn die Quelle kein Resolve-Event schickt; je nach Alert-Route lösen sich damit auch die von ihm gestarteten Incidents und Eskalationen. Alert-Quellen (Datadog, Grafana, Prometheus, CloudWatch, HTTP, E-Mail, Heartbeat und mehr) liest du mit incident_io_list_alert_sources und incident_io_get_alert_source; ihre geheimen Tokens werden weggelassen.

Bereitschaft: incident_io_list_schedules und incident_io_get_schedule zeigen Rotationen, Layer und aktuelle Schichten; incident_io_list_schedule_entries liefert für ein Zeitfenster die endgültigen Einträge nach Overrides und beantwortet damit „wer hat gerade Bereitschaft“. incident_io_list_escalation_paths und incident_io_list_escalations zeigen, wer alarmiert wird und was passiert ist; incident_io_create_escalation alarmiert Personen über einen Eskalationspfad oder direkt per User-ID.

Organisation und Katalog: incident_io_list_users (jemanden per E-Mail oder Slack-ID finden), incident_io_get_user, incident_io_list_teams, incident_io_list_catalog_types, incident_io_get_catalog_type, incident_io_list_catalog_entries (einen Eintrag mit identifier suchen) und incident_io_get_catalog_entry.

Vor dem Schreiben: Ein neuer Standard-Incident öffnet einen Slack- oder Teams-Channel und alarmiert Leute, ein Update geht an Responder und Abonnenten, eine Eskalation weckt die Bereitschaft. Die KI zeigt dir, was sie vorhat, und wartet auf dein Ja. Wiederholt sie ein Anlegen, nutzt sie denselben idempotency_key, damit kein zweiter Incident, kein zweites Update und kein zweiter Alarm entsteht.

Bei der Installation deaktiviert: keine. Alle 43 Tools sind aktiv, auch die schreibenden; was der Key darf, legst du über die Berechtigungen fest, die du ihm in incident.io gibst.

Datenformate: IDs sind ULIDs (26 Zeichen, zum Beispiel 01FCNDV6P870EA6S7TK1DSYDG0); die lesbare Referenz steht in reference (INC-123). Zeiten sind ISO 8601 in UTC, Datumsfilter nehmen YYYY-MM-DD. Statuskategorien in der API: triage, live (Active), learning (Post-incident), paused, closed, declined, canceled, merged. Ein höherer rank beim Schweregrad heißt schwerer. Antworten zu Custom Fields enthalten keine Optionslisten; die liefert incident_io_list_custom_field_options.

Blättern: Listen liefern pagination_meta mit after; die KI ruft erneut mit diesem after auf, bis es fehlt. page_size ist standardmäßig 25 und bei den meisten Listen bis 250. incident_io_list_schedule_entries blättert, indem pagination_meta.after in entry_window_start kommt.

Limits: 1.200 Anfragen pro Minute und Key.

Häufige Fehler: 401 bedeutet einen falschen oder gelöschten Key. 403 heißt, dem Key fehlt die Berechtigung für diesen Aufruf; incident_io_get_identity zeigt seine Rollen, und unter Settings, API keys hakst du die fehlende an. 404 ist eine unbekannte ID. 422 ist ein Validierungsfehler, dessen errors das Feld nennen, etwa ein nicht erlaubter Statuswechsel. 429 ist das Rate Limit; warte eine Minute.

Der Connector löscht keine Incidents, Actions, Follow-ups oder Katalogeinträge, legt keine Alert-Quellen, Schedules oder Eskalationspfade an und ändert sie nicht, und er gibt keine geheimen Tokens von Alert-Quellen zurück.

Schritt 2 — Adapter installieren

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Schritt 3 — Connector in Gemini hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese Anleitung YOUR_SERVER_ID zeigt.

Gemini CLI liest MCP-Server aus ~/.gemini/settings.json (unter Windows %USERPROFILE%\.gemini\settings.json). Füge hinzu:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Erstelle in AnythingMCP unter MCP Servers → dein Server → API keys einen MCP-API-Key und setze ihn anstelle von YOUR_MCP_API_KEY ein.
2. Speichere die Datei und starte gemini neu.
3. Führe in der Gemini CLI /mcp aus (oder gemini mcp list im Terminal): anythingmcp sollte als verbunden erscheinen.
4. Leg los: Gemini CLI kann jetzt die incident.io-Tools aufrufen.

Verfügbare Tools

Beispiel-Prompts

• „Welche Incidents sind gerade aktiv? Nenn mir zu jedem Schweregrad, Status, Incident Lead und das letzte Update.“
• „Wer hat gerade Bereitschaft im Platform-Schedule, und wer übernimmt als Nächstes?“
• „Fass die Timeline von INC-123 zusammen und liste die offenen Follow-ups mit den Zuständigen auf.“
• „Ruf einen privaten Test-Incident namens Checkout-Latenz mit Schweregrad Minor aus. Zeig mir die Angaben, bevor du ihn anlegst.“
• „Welche Alerts von Datadog feuern noch, und hängt einer davon an einem Incident?“

FAQ

Wo sucht Gemini CLI nach MCP-Servern? In ~/.gemini/settings.json für deinen Benutzer oder in .gemini/settings.json innerhalb eines Projekts. gemini mcp list zeigt jeden Server und ob er sich verbindet.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden
• Mit Cursor verbinden
• Mit Meta Muse verbinden
• Mit Microsoft Copilot verbinden