Watchgoose MCP

Watchgoose MCP verbindet MCP-fähige KI-Clients mit der Watchgoose Management API. Es ermöglicht Ihnen, die Überwachung von Cron- und wiederkehrenden Aufgaben zu prüfen, wobei Check-Änderungen nur verfügbar sind, wenn Sie Schreibvorgänge explizit aktiveren.

Voraussetzungen

• Node.js 20 oder neuer

• Ein projektspezifischer Watchgoose-API-Schlüssel aus den Projekteinstellungen

Verwenden Sie einen hcr_- Schlüssel mit Nur-Lese-Zugriff, wenn Sie nur den Check-Status und die Statushistorie benötigen. Verwenden Sie einen hcw_- Schlüssel mit Lese-/Schreibzugriff, wenn Sie auch Pings, Integrationen oder Check-Änderungen benötigen.

Related MCP server: uptrack-mcp

Claude Desktop

Fügen Sie diesen Eintrag zu claude_desktop_config.json hinzu und starten Sie Claude Desktop neu:

{
  "mcpServers": {
    "watchgoose": {
      "command": "npx",
      "args": ["-y", "watchgoose-mcp"],
      "env": {
        "WATCHGOOSE_API_KEY": "hcr_your_project_key"
      }
    }
  }
}

Claude Code

claude mcp add --env WATCHGOOSE_API_KEY=hcr_your_project_key \
  --transport stdio --scope user watchgoose -- npx -y watchgoose-mcp

Führen Sie claude mcp get watchgoose aus, um die Verbindung zu prüfen.

Cursor

Erstellen Sie .cursor/mcp.json in Ihrem Projekt oder fügen Sie denselben Eintrag zu Ihrer Benutzer-MCP-Konfiguration hinzu:

{
  "mcpServers": {
    "watchgoose": {
      "command": "npx",
      "args": ["-y", "watchgoose-mcp"],
      "env": {
        "WATCHGOOSE_API_KEY": "hcr_your_project_key"
      }
    }
  }
}

VS Code

Erstellen Sie .vscode/mcp.json:

{
  "servers": {
    "watchgoose": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "watchgoose-mcp"],
      "env": {
        "WATCHGOOSE_API_KEY": "hcr_your_project_key"
      }
    }
  }
}

Führen Sie MCP: List Servers aus und starten Sie watchgoose.

Umgebung

Der Server klassifiziert Schlüsselpräfixe lokal und fragt die API nie ab, um auf Zugriffsrechte zu schließen. Das Setzen von WATCHGOOSE_ENABLE_WRITES=true kann einem schreibgeschützten Schlüssel keinen zusätzlichen Zugriff gewähren.

Werkzeuge

Checks werden über stabile unique_key- Werte mit 40 Zeichen adressiert. UUIDs, Ping-URLs und Integrations-UUIDs werden nur innerhalbb des Servers verwendet und dem KI-Client nicht angezeigt.

Integrationszuordnungen verwenden exakte Integrationsnamen. Namen müssen nicht leer und innerhalb des Projekts eindeutig sein.

Listenergebnisse sind auf 100 Checks, 100 Pings, 200 Flips und 100 Integrationen begrenzt. Jedes serialisierte Werkzeugergebnis ist ebenfalls auf 24.000 Zeichen begrenzt. Ergebnisse enthalten Metadaten, wenn Einträge ausgelassen werden.

Sicherheit

• Schreibvorgänge sind standardmäßig deaktivert, selbst mit einem hcw_- Schlüssel.

• Der API-Schlüssel wird nur im X-Api-Key-Header gesendet und niemals protokolliert oder zurückgegeben.

• API-Umleitungen werden abgelehnt, damit Anmeldedaten nicht an einen anderen Host weitergeleitet werden können.

• Check-UUIDs, Ping- und Update-URLs, Integrations-UUIDs und unbekannte zukünftige API-Felder werden aus der Ausgabe entfernt.

• Pings behalten nur type, date, n, scheme, method und duration. Quell-IP-Adressen, User-Agents, Run-IDs und Body-URLs werden entfernt.

• Ping-Bodies werden nie angefordert.

• Der Server verfügt über keine Telemetrie.

Schützen Sie Client-Konfigurationsdateien, die API-Schlüssel enthalten. Bevorzugen Sie ein dediziertes Projekt und den Schlüssel mit den geringsten Rechten, der die benötigten Werkzeuge verfügbar macht. Widerrufen Sie einen Schlüssel über die Watchgoose-Projekteinstellungen, wenn er nicht mehr verwendet wird.

Entwicklung

npm install
npm run format:check
npm run lint
npm run typecheck
npm test
npm run publish:dry-run

Produktions-Integrationstests sind optional (opt-in) und erfordern dedizierte Testprojekt-Schlüssel. Sie werden niemals in CI ausgeführt.

Lizenz

MIT