Pulsetic MCP Server

Pulsetic MCP Server

Verbinden Sie KI-Assistenten mit Ihrer Pulsetic-Überwachungsplattform unter Verwendung des Model Context Protocol (MCP).

---

Was ist MCP?

Das Model Context Protocol ist ein offener Standard, der es KI-Assistenten ermöglicht, mit externen Werkzeugen und Diensten zu interagieren. Mit dem MCP-Server von Pulsetic können Sie Ihren KI-Assistenten bitten, den Monitorstatus zu überprüfen, Vorfälle zu erstellen, Wartungsarbeiten zu planen und vieles mehr – alles durch natürliche Konversation.

Unterstützte Clients:

• Claude Desktop – Anthropics Desktop-App
• Claude Code – Anthropics CLI für Entwickler
• ChatGPT – OpenAIs KI-Assistent (via OAuth)
• Cursor – KI-gestützter Code-Editor
• Windsurf – KI-gestützte IDE
• Jeder Client, der die MCP-Spezifikation implementiert

---

Voraussetzungen

• Ein Pulsetic-Konto mit einem Tarif, der API-Zugriff beinhaltet (Business oder Enterprise).
• Ein Pulsetic-API-Schlüssel – generieren Sie einen unter Einstellungen → API in Ihrem Dashboard.
• Ein MCP-kompatibler KI-Client.

---

Einrichtung

Claude Desktop

Claude Desktop verwendet stdio-basierte MCP-Server. Verwenden Sie mcp-remote, um den entfernten HTTP-Endpunkt zu überbrücken. Öffnen Sie Einstellungen → Entwickler → Konfiguration bearbeiten und fügen Sie hinzu:

{
  "mcpServers": {
    "pulsetic": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://api.pulsetic.com/mcp",
        "--header", "Authorization: Bearer YOUR_API_KEY"
      ]
    }
  }
}

Ersetzen Sie YOUR_API_KEY durch Ihren tatsächlichen API-Schlüssel. Starten Sie Claude Desktop neu, um die Änderungen zu übernehmen.

Claude Code

Fügen Sie den Server zur .mcp.json-Datei Ihres Projekts hinzu:

{
  "mcpServers": {
    "pulsetic": {
      "type": "streamableHttp",
      "url": "https://api.pulsetic.com/mcp",
      "headers": {
        "Authorization": "YOUR_API_KEY"
      }
    }
  }
}

Cursor

Öffnen Sie Einstellungen → MCP-Server → Server hinzufügen und konfigurieren Sie:

• Typ: streamableHttp
• URL: https://api.pulsetic.com/mcp
• Header: Authorization: YOUR_API_KEY

ChatGPT

ChatGPT verfügt über native MCP-Unterstützung durch den Entwicklermodus. Es verwendet OAuth zur Authentifizierung bei Pulsetic.

Schritt 1. Aktivieren Sie den Entwicklermodus in ChatGPT: Gehen Sie zu Aktivierte Apps → Erweiterte Einstellungen → Entwicklermodus und schalten Sie ihn ein. Dies ist für ChatGPT Pro, Plus, Team, Business, Enterprise und Edu-Nutzer verfügbar.

Schritt 2. Erstellen Sie eine neue App: Gehen Sie zu Aktivierte Apps → App erstellen.

Schritt 3. Füllen Sie die App-Details aus:

Feld	Wert
Name	Pulsetic MCP (oder ein beliebiger Name)
Beschreibung	Uptime monitoring (optional)
MCP-Server-URL	https://api.pulsetic.com/mcp
Authentifizierung	OAuth

Schritt 4. Die OAuth-Endpunkte werden automatisch vom Server erkannt. Sie können sie unter Erweiterte Einstellungen überprüfen:

Feld	Wert
Auth-URL	https://api.pulsetic.com/mcp/oauth/authorize
Token-URL	https://api.pulsetic.com/mcp/oauth/token
Registrierungs-URL	https://api.pulsetic.com/mcp/oauth/register

Schritt 5. Aktivieren Sie "Ich verstehe und möchte fortfahren" und klicken Sie auf Erstellen.

Schritt 6. Schließen Sie den OAuth-Anmeldevorgang ab. Sie werden auf eine Pulsetic-Autorisierungsseite weitergeleitet, auf der Sie Ihre Konto-E-Mail und Ihr API-Token eingeben.

Die E-Mail muss mit Ihrem API-Token übereinstimmen. Auf der Autorisierungsseite muss die von Ihnen eingegebene E-Mail mit dem Besitzer des von Ihnen angegebenen API-Tokens übereinstimmen.

Halten Sie Ihren API-Schlüssel geheim. Ihr API-Schlüssel hat vollen Zugriff auf Ihr Pulsetic-Konto. Geben Sie ihn niemals in die Versionskontrolle oder teilen Sie ihn öffentlich.

---

Verfügbare Werkzeuge

Der MCP-Server stellt 17 Werkzeuge in vier Kategorien bereit.

Monitore

Werkzeug	Beschreibung
list_monitors	Alle Monitore mit Status, Betriebszeit und Antwortzeit auflisten.
get_monitor	Detaillierte Informationen zu einem bestimmten Monitor abrufen.
get_monitor_stats	Betriebszeit-%, Ausfallzeit und Antwortzeiten über 1T/7T/30T/90T.
get_monitor_events	Online-/Offline-Ereignisse innerhalb eines Datumsbereichs.
get_monitor_downtime	Gesamte Ausfallzeit in Sekunden für einen bestimmten Zeitraum.
create_monitor	Einen neuen HTTP-, TCP- oder ICMP-Monitor erstellen.
update_monitor	Name, URL, Häufigkeit oder Einstellungen eines Monitors aktualisieren.
delete_monitor	Einen Monitor dauerhaft löschen.
pause_monitor	Überwachung pausieren (Prüfungen stoppen).
resume_monitor	Einen pausierten Monitor fortsetzen.

Statusseiten

Werkzeug	Beschreibung
list_status_pages	Alle Statusseiten mit Titel, Slug und Domain auflisten.

Vorfälle

Werkzeug	Beschreibung
list_incidents	Vorfälle für eine Statusseite auflisten.
create_incident	Einen neuen Vorfall mit einer ersten Statusaktualisierung erstellen.
update_incident	Eine Statusaktualisierung zu einem bestehenden Vorfall veröffentlichen.
resolve_incident	Einen Vorfall als behoben markieren.

Wartung

Werkzeug	Beschreibung
create_maintenance	Ein Wartungsfenster auf einer Statusseite planen.
delete_maintenance	Ein geplantes Wartungsfenster löschen.

---

Anwendungsbeispiele

Sobald die Konfiguration abgeschlossen ist, können Sie mit Pulsetic in natürlicher Sprache interagieren.

Überprüfen Sie Ihre Monitore

"Show me all my monitors and their current status."

"What's the uptime for my production API monitor over the last 30 days?"

"Are any of my monitors currently down?"

"Show me the downtime events for monitor 42 in the past week."

Monitore verwalten

"Create a new monitor for https://api.example.com that checks every 30 seconds."

"Pause the staging monitor while we do the migration."

"Resume all paused monitors."

"Change the check frequency of monitor 15 to 60 seconds."

"Delete the old marketing-site monitor."

Vorfälle bearbeiten

"Create an incident on our main status page: 'Elevated API latency'
 with status investigating and message 'We're looking into slow response times.'"

"Update the API latency incident to identified: 'Root cause is a database
 connection pool issue. Working on a fix.'"

"Resolve incident 8 with message 'Connection pool limits increased.
 Response times back to normal.'"

Wartung planen

"Schedule a maintenance window on status page 1 called 'Database upgrade'
 starting 2025-03-20 at 2am UTC and ending at 4am UTC."

"Delete the maintenance window we scheduled for next week."

---

Testen mit cURL

Sie können den MCP-Endpunkt direkt mit cURL testen, um zu überprüfen, ob Ihr API-Schlüssel funktioniert.

Initialisieren

curl -X POST https://api.pulsetic.com/mcp \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2025-03-26",
      "capabilities": {},
      "clientInfo": {"name": "curl", "version": "1.0"}
    }
  }'

Werkzeuge auflisten

curl -X POST https://api.pulsetic.com/mcp \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

Ein Werkzeug aufrufen

curl -X POST https://api.pulsetic.com/mcp \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 3,
    "method": "tools/call",
    "params": {
      "name": "list_monitors",
      "arguments": {}
    }
  }'

---

Werkzeugreferenz

list_monitors

Gibt alle Monitore für Ihr Konto zurück.

Keine Parameter.

---

get_monitor

Gibt vollständige Details für einen einzelnen Monitor zurück, einschließlich SSL-Zertifikatsinformationen.

Parameter	Typ	Erforderlich	Beschreibung
monitor_id	integer	Ja	Die Monitor-ID.

---

get_monitor_stats

Gibt Betriebszeit-%, Ausfallzeit, Vorfallanzahl und durchschnittliche Antwortzeit über Zeiträume von 1 Tag, 7 Tagen, 30 Tagen und 90 Tagen zurück.

Parameter	Typ	Erforderlich	Beschreibung
monitor_id	integer	Ja	Die Monitor-ID.

---

get_monitor_events

Gibt Online-/Offline-Ereignisse in einem Datumsbereich zurück (max. 100, neueste zuerst).

Parameter	Typ	Erforderlich	Beschreibung
monitor_id	integer	Ja	Die Monitor-ID.
from	string	Nein	Startdatum (JJJJ-MM-TT). Standard: vor 7 Tagen.
to	string	Nein	Enddatum (JJJJ-MM-TT). Standard: heute.

---

get_monitor_downtime

Gibt die gesamte Ausfallzeit in Sekunden und die Vorfallanzahl für einen Zeitraum zurück.

Parameter	Typ	Erforderlich	Beschreibung
monitor_id	integer	Ja	Die Monitor-ID.
days	integer	Nein	Zurückzuverfolgende Tage. Standard: 30.

---

create_monitor

Erstellt einen neuen Betriebszeit-Monitor.

Parameter	Typ	Erforderlich	Beschreibung
url	string	Ja	Zu überwachende URL oder Hostname.
name	string	Nein	Anzeigename.
request_type	string	Nein	http, tcp oder icmp. Standard: http.
uptime_check_frequency	integer	Nein	Prüfintervall in Sekunden. Standard: 60.
request_method	string	Nein	HTTP-Methode. Standard: GET.
request_timeout	integer	Nein	Timeout in Sekunden. Standard: 30.
ssl_check	boolean	Nein	SSL-Überwachung aktivieren.

---

update_monitor

Aktualisiert die Einstellungen eines bestehenden Monitors. Geben Sie nur die Felder an, die Sie ändern möchten.

Parameter	Typ	Erforderlich	Beschreibung
monitor_id	integer	Ja	Die Monitor-ID.
name	string	Nein	Neuer Anzeigename.
url	string	Nein	Neue URL oder Hostname.
uptime_check_frequency	integer	Nein	Neues Prüfintervall in Sekunden.
request_method	string	Nein	HTTP-Methode.
request_timeout	integer	Nein	Timeout in Sekunden.
ssl_check	boolean	Nein	SSL-Überwachung aktivieren/deaktivieren.

---

delete_monitor

Löscht einen Monitor und alle zugehörigen Daten dauerhaft.

Parameter	Typ	Erforderlich	Beschreibung
monitor_id	integer	Ja	Die Monitor-ID.

---

pause_monitor

Pausiert einen Monitor. Er wird bis zur Fortsetzung nicht mehr überprüft.

Parameter	Typ	Erforderlich	Beschreibung
monitor_id	integer	Ja	Die Monitor-ID.

---

resume_monitor

Setzt einen pausierten Monitor fort.

Parameter	Typ	Erforderlich	Beschreibung
monitor_id	integer	Ja	Die Monitor-ID.

---

list_status_pages

Gibt alle Statusseiten für Ihr Konto zurück.

Keine Parameter.

---

list_incidents

Gibt Vorfälle für eine Statusseite zurück, einschließlich der letzten Aktualisierung für jeden.

Parameter	Typ	Erforderlich	Beschreibung
status_page_id	integer	Ja	Die Statusseiten-ID.

---

create_incident

Erstellt einen neuen Vorfall mit einer ersten Statusaktualisierung, die auf der Statusseite erscheint.

Parameter	Typ	Erforderlich	Beschreibung
status_page_id	integer	Ja	Die Statusseiten-ID.
title	string	Ja	Vorfalltitel.
status	string	Ja	investigating, identified, monitoring oder resolved.
message	string	Ja	Erste Aktualisierungsnachricht.

---

update_incident

Veröffentlicht eine neue Statusaktualisierung zu einem bestehenden Vorfall.

Parameter	Typ	Erforderlich	Beschreibung
incident_id	integer	Ja	Die Vorfall-ID.
status	string	Ja	investigating, identified, monitoring oder resolved.
message	string	Ja	Aktualisierungsnachricht.
title	string	Nein	Den Vorfalltitel aktualisieren.

---

resolve_incident

Markiert einen Vorfall als behoben mit einer Lösungsnachricht.

Parameter	Typ	Erforderlich	Beschreibung
incident_id	integer	Ja	Die Vorfall-ID.
message	string	Ja	Lösungsnachricht.

---

create_maintenance

Plant ein Wartungsfenster auf einer Statusseite.

Parameter	Typ	Erforderlich	Beschreibung
status_page_id	integer	Ja	Die Statusseiten-ID.
name	string	Ja	Wartungstitel.
description	string	Nein	Beschreibung der Wartung.
start	string	Ja	Startzeit im ISO-8601-Format.
end	string	Ja	Endzeit im ISO-8601-Format.
timezone	string	Nein	Zeitzone (z. B. UTC, America/New_York). Standard: UTC.

---

delete_maintenance

Löscht ein geplantes Wartungsfenster.

Parameter	Typ	Erforderlich	Beschreibung
maintenance_id	integer	Ja	Die Wartungsfenster-ID.

---

Fehlerbehebung

401 Unauthorized

• Überprüfen Sie, ob Ihr API-Schlüssel korrekt und nicht abgelaufen ist.
• Stellen Sie sicher, dass Sie den Schlüssel im Authorization-Header übergeben (entweder als reines Token oder mit dem Präfix Bearer).
• Bestätigen Sie, dass Ihr Konto einen Tarif mit aktiviertem API-Zugriff hat.

OAuth-Autorisierung schlägt fehl (ChatGPT)

• Auf der Autorisierungsseite muss die von Ihnen eingegebene E-Mail mit dem Besitzer des API-Tokens übereinstimmen.
• Stellen Sie sicher, dass der Entwicklermodus in Ihren ChatGPT-Einstellungen aktiviert ist.
• Stellen Sie sicher, dass Sie einen ChatGPT-Tarif haben, der den Entwicklermodus unterstützt (Pro, Plus, Team, Business, Enterprise oder Edu).

"Monitor nicht gefunden oder Zugriff verweigert"

• Die Monitor-ID existiert nicht oder gehört zu einem anderen Konto.
• Verwenden Sie list_monitors, um Ihre verfügbaren Monitor-IDs anzuzeigen.

Werkzeuge werden in Ihrem KI-Client nicht angezeigt

• Starten Sie den KI-Client nach der Bearbeitung der MCP-Konfiguration neu.
• Überprüfen Sie, ob die URL genau https://api.pulsetic.com/mcp ist.
• Testen Sie den Endpunkt mit cURL, um die Konnektivität zu überprüfen.

Protokollfehler erhalten

• Stellen Sie sicher, dass Anfragen Content-Type: application/json verwenden.
• Das Feld jsonrpc muss genau "2.0" sein.
• Fügen Sie für alle Anfragen außer Benachrichtigungen ein id-Feld (Integer oder String) hinzu.

---

API-Referenz

Der MCP-Server implementiert die MCP-Spezifikation (2025-03-26) unter Verwendung von Streamable HTTP-Transport über einen einzelnen POST /mcp-Endpunkt mit JSON-RPC 2.0.