UptimeEye MCP-Server

Schnellstart

1. Management-Key erstellen

Öffne in der App API-Keys → Neuer API-Key, wähle den Typ „Management“ und kopiere den Key. Er beginnt mit ue_live_ und wird nur einmal angezeigt. Log-Ingest-Keys (ue_ingest_) funktionieren hier nicht.

2. Server im Client eintragen

Endpoint: https://api.uptimeeye.com/mcp (Streamable HTTP), authentifiziert mit Authorization: Bearer ue_live_…. In Claude Code ist das ein Befehl:

claude mcp add --transport http uptimeeye https://api.uptimeeye.com/mcp \
  --header "Authorization: Bearer ue_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"

3. Fragen

Probier „Liste meine UptimeEye-Monitore auf“ – und beschreib dann, was überwacht werden soll. Der Assistent schaut zuerst deine Benachrichtigungskanäle nach, weil jeder Monitor einen braucht.

Client verbinden

Claude Code

Der Befehl aus dem Schnellstart richtet den Server nur für dich ein. Mit --scope project teilst du ihn über .mcp.json mit deinem Team, und der Key landet nicht in dieser Datei: In einfachen Anführungszeichen steht ${UPTIMEEYE_API_KEY} unverändert in der Datei, und Claude Code liest den Key beim Start aus dieser Umgebungsvariable.

claude mcp add --transport http --scope project uptimeeye https://api.uptimeeye.com/mcp \
  --header 'Authorization: Bearer ${UPTIMEEYE_API_KEY}'

Cursor

Global in ~/.cursor/mcp.json oder pro Projekt in .cursor/mcp.json:

{
  "mcpServers": {
    "uptimeeye": {
      "url": "https://api.uptimeeye.com/mcp",
      "headers": { "Authorization": "Bearer ue_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" }
    }
  }
}

VS Code (GitHub Copilot im Agent-Modus)

VS Code fragt einmal nach dem Key und speichert ihn sicher:

{
  "inputs": [
    { "type": "promptString", "id": "uptimeeye-key", "description": "UptimeEye API key (ue_live_…)", "password": true }
  ],
  "servers": {
    "uptimeeye": {
      "type": "http",
      "url": "https://api.uptimeeye.com/mcp",
      "headers": { "Authorization": "Bearer ${input:uptimeeye-key}" }
    }
  }
}

Claude Desktop

Claude Desktop startet nur lokale Server und verbindet sich deshalb über die mcp-remote-Bridge (braucht Node.js). Trag das in claude_desktop_config.json ein und starte die App neu:

{
  "mcpServers": {
    "uptimeeye": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.uptimeeye.com/mcp", "--header", "Authorization:${UPTIMEEYE_AUTH}"],
      "env": { "UPTIMEEYE_AUTH": "Bearer ue_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" }
    }
  }
}

Andere Clients: Alles, was Remote-MCP-Server über Streamable HTTP mit einem eigenen Header unterstützt, funktioniert mit dem Endpoint und Header oben.

Verfügbare Tools

Die Tools tragen MCP-Annotationen: Lesende Tools sind als read-only markiert, Lösch-Tools als destruktiv, sodass gut gebaute Clients vor dem Ausführen nachfragen.

Dein Job schickt einem Scheduled Task seine Heartbeats: GET https://api.uptimeeye.com/v1/beat/{taskId} bei Erfolg. Optional: /start zu Beginn des Laufs und /fail, um einen fehlgeschlagenen Lauf zu melden und sofort einen Alert auszulösen. GET, POST und HEAD werden alle akzeptiert.

Logs-Tools

Fünf lesende Tools durchsuchen die Logs, die deine Services an UptimeEye Logs senden. Abfragen sind LogsQL, z. B. service:api level:error. Der Zeitraum wird mit start und end (RFC 3339) gesetzt und ist standardmäßig die letzte Stunde; jedes Ergebnis nennt den tatsächlich durchsuchten Zeitraum, den die Aufbewahrungsdauer deines Plans verkürzen kann.

Beispiel-Prompts

• „Überwache https://shop.example.com jede Minute aus eu-central-1 und us-east-1 und schick mir eine E-Mail an ops@example.com, wenn die Seite down oder langsamer als 2 Sekunden ist.“
• „Leg einen Heartbeat für unser nächtliches Backup um 02:30 Europe/Berlin mit 30 Minuten Karenzzeit an und gib mir die curl-Zeile für die Crontab.“
• „Schick mir einen Alert, wenn unser Postgres auf db.example.com:5432 keine Verbindungen mehr annimmt – prüfe jede Minute.“
• „Welche Monitore sind gerade down, und gibt es offene Incidents?“
• „Der Checkout-Monitor ist um 14:05 ausgefallen. Was hat der Checkout-Service um diese Zeit geloggt, und ist der Fehler neu?“
• „Tagge jeden Monitor, dessen URL staging enthält, mit staging und pausiere sie.“
• „Verschiebe alle Monitore vom Channel ‚Old alerts‘ nach ‚On-call‘ und lösche dann ‚Old alerts‘.“

Ein Projekt mit einem AI-Agent einrichten

Coding-Agents (Claude Code, Cursor, Copilot) können dein Repository und die UptimeEye-Doku gleichzeitig lesen. Füge einen dieser Prompts in den Agent in deinem Projekt ein; Endpoints, Jobs und Stack findet er selbst.

Jeden öffentlichen Endpoint überwachen

Heartbeats für Cron-Jobs ergänzen

Logs senden

Rechte & Sicherheit

• Ein Management-Key handelt für eine Organisation mit denselben Rechten wie die REST-API. Erstelle einen Key pro Client, damit du sie einzeln widerrufen kannst.
• Ein Management-Key kann alle Logs der Organisation lesen, innerhalb der Aufbewahrungsdauer deines Plans, über die Logs-Tools und die REST-API. Eine engere Log-Berechtigung gibt es nicht, behandle den Key also wie die Logs selbst.
• Lösch-Tools sind als destruktiv annotiert, und der Server weist den Assistenten an, vorher ausdrücklich nachzufragen.
• Plan-Limits gelten genau wie in der App – der Assistent kann deine Monitor-Anzahl oder dein Mindestintervall nicht überschreiten.
• Keys werden gehasht gespeichert; der Klartext-Key wird nur einmal beim Erstellen angezeigt. Anfragen werden in der EU (Deutschland) verarbeitet.

Lieber Infrastructure as Code? Dieselben Operationen gibt es über den Terraform-Provider.

FAQ