Visual Sentinel MCP-Server

Model Context Protocol-Server für Visual Sentinel, die Sechs-Ebenen-Website-Überwachungsplattform: Uptime, Performance, SSL, DNS, visuelle Regression und Erkennung von Inhaltsänderungen.

Verbinden Sie Claude Desktop, Claude Code, Cline, Continue oder einen beliebigen MCP-kompatiblen Client mit Ihrem Visual Sentinel-Konto, damit ein KI-Assistent Monitore auflisten, erstellen, Vorfallverläufe abrufen, kostenlose DNS-/SSL-/Geschwindigkeitstests durchführen und Warnungen in Ihrem Namen bestätigen kann.

• npm: @visualsentinel/mcp-server

• OpenAPI-Spezifikation: https://github.com/VisualSentinel/openapi

• API-Schlüssel erhalten: https://visualsentinel.com/settings/api-keys

• Gehostete API-Referenz: https://visualsentinel.com/docs

Was Sie erhalten

16 Tools, die die öffentliche Visual Sentinel-API abdecken:

Öffentliche Tools (kein API-Schlüssel erforderlich)

Authentifizierte Tools (erfordern VS_API_KEY)

Installation

Claude Desktop

Fügen Sie dies zu ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) oder %APPDATA%\Claude\claude_desktop_config.json (Windows) hinzu:

{
  "mcpServers": {
    "visualsentinel": {
      "command": "npx",
      "args": ["-y", "@visualsentinel/mcp-server"],
      "env": {
        "VS_API_KEY": "vs_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Starten Sie Claude Desktop neu. Die 16 Tools erscheinen im Tools-Menü.

Claude Code (CLI)

claude mcp add visualsentinel \
  -- npx -y @visualsentinel/mcp-server

Exportieren Sie dann VS_API_KEY in der Shell, in der Claude Code ausgeführt wird.

Cline (VS Code-Erweiterung)

Fügen Sie in den MCP-Einstellungen von Cline Folgendes hinzu:

{
  "visualsentinel": {
    "command": "npx",
    "args": ["-y", "@visualsentinel/mcp-server"],
    "env": { "VS_API_KEY": "vs_live_..." }
  }
}

Continue

In ~/.continue/config.json:

{
  "mcpServers": [
    {
      "name": "visualsentinel",
      "command": "npx",
      "args": ["-y", "@visualsentinel/mcp-server"],
      "env": { "VS_API_KEY": "vs_live_..." }
    }
  ]
}

Generischer MCP-Client (stdio)

VS_API_KEY=vs_live_xxx npx -y @visualsentinel/mcp-server

Der Server spricht JSON-RPC über stdio gemäß der MCP-Spezifikation (2025-06-18).

Konfiguration

Zwei Umgebungsvariablen, beide optional, außer in den angegebenen Fällen:

Wenn ein Tool, das Authentifizierung benötigt, ohne VS_API_KEY aufgerufen wird, gibt der Server einen klaren Fehler zurück, anstatt stillschweigend zu scheitern.

VISUALSENTINEL_API_KEY wird als Alias für VS_API_KEY für Clients akzeptiert, die den längeren Namen bevorzugen.

Anwendungsbeispiele

Fragen Sie den KI-Assistenten nach der Installation Dinge wie:

• "Wie sieht es mit dem SSL-Zertifikat auf visualsentinel.com aus? Wann läuft es ab?"

• "Liste meine Visual Sentinel-Monitore auf, die derzeit ausgefallen sind."

• "Erstelle einen neuen HTTPS-Monitor für https://shop.example.com, der jede Minute prüft."

• "Zeige mir Vorfälle der letzten 24 Stunden und bestätige die für die Monitor-ID clm123."

• "Wie hoch ist der Uptime-Prozentsatz für meine Landingpage in den letzten 30 Tagen?"

• "Führe einen Geschwindigkeitstest auf https://example.com/checkout durch."

Der Assistent wählt das entsprechende Tool aus, füllt die Argumente aus dem Gespräch aus und zeigt die JSON-Antwort an.

Sicherheitshinweise

• Ihr API-Schlüssel verlässt niemals den Computer, auf dem dieser MCP-Server läuft. Anfragen gehen direkt über HTTPS an https://visualsentinel.com.

• Öffentliche Tools (vs_health, vs_dns_check, vs_ssl_check, vs_speed_test, vs_website_check) funktionieren ohne API-Schlüssel, aber ihre Ergebnisse sind für jeden sichtbar, der Ihre Gesprächsprotokolle lesen kann. Behandeln Sie sie wie jeden anderen Shell-Befehl.

• Widerrufen Sie einen kompromittierten API-Schlüssel sofort unter https://visualsentinel.com/settings/api-keys. Der Widerruf wird innerhalb von Sekunden wirksam.

• Tools, die den Status ändern (vs_monitors_create, vs_monitors_check_now, vs_alerts_acknowledge), erben die rollenbasierten Berechtigungen Ihres API-Schlüssels. Ein schreibgeschützter Schlüssel kann keine Monitore erstellen.

Entwicklung

git clone https://github.com/VisualSentinel/mcp-server.git
cd mcp-server
npm install
npm run build      # tsup, output to dist/
npm run lint       # tsc --noEmit
npm run dev        # tsup --watch

Für einen Smoke-Test lokal gegen die Produktions-API:

VS_API_KEY=vs_live_... node dist/index.js

Der Server spricht JSON-RPC über stdin / stdout. Leiten Sie eine tools/list-Anfrage per Pipe weiter, um die registrierten Tools zu sehen.

Versionierung

Semantische Versionierung. Breaking Changes an Toolnamen oder erforderlichen Argumenten führen zu einer Major-Version. Das Hinzufügen neuer Tools oder neuer optionaler Argumente ist eine Minor- oder Patch-Version.

Die Tool-Oberfläche des Servers folgt der öffentlichen Visual Sentinel-API-Spezifikation unter https://github.com/VisualSentinel/openapi. Wenn die Upstream-API einen nützlichen Endpunkt erhält, zieht dieses Repository normalerweise innerhalb eines Releases nach.

Lizenz

MIT. Siehe LICENSE.

Der Visual Sentinel API-Dienst selbst unterliegt https://visualsentinel.com/terms.