Zum Inhalt springen

Claude nach deinen Servern fragen

Der Claude-Connector gehört zu Vaicoa Pro und Vaicoa Team.

Vaicoa stellt einen MCP-Server bereit. Fügst du ihn in Claude hinzu, kann Claude die Vaicoa-Daten eines Teams lesen und damit Fragen zu deiner Infrastruktur beantworten: Inventar, Metriken mit ihren Alarm-Schwellwerten, aktive und vergangene Alarme, System-Logs, Job-Reports, Uptime-Checks und Kosten. Der Zugriff ist read-only, und die Analyse läuft über dein eigenes Claude-Abo.

  1. Geh in Claude (Web, Desktop oder Mobil) auf Einstellungen → Connectors → Eigenen Connector hinzufügen.

  2. Gib die Server-URL https://api.vaicoa.com/mcp ein.

  3. Claude öffnet eine Anmeldeseite. Melde dich mit deinem Vaicoa-Konto an, wähl unter Zugriff auf Team gewähren das Team und bestätige mit Read-only Zugriff erlauben.

Jedes Mitglied eines Teams mit Pro oder Team kann ihn verbinden. Dafür braucht es keine Admin-Rechte.

Andere MCP-Clients, die Remote-Server mit OAuth-Anmeldung unterstützen, verbinden sich über dieselbe URL. In Claude Code:

Terminal-Fenster
claude mcp add --transport http cloudviewer https://api.vaicoa.com/mcp

Führ dann in Claude Code /mcp aus, um dich anzumelden und das Team zu wählen.

Zum Beispiel: „Sind gerade Alarme aktiv?“, „Analysiere den Festplatten-Alarm auf prod-db-1“, „Welcher meiner Endpunkte ist nicht erreichbar, und seit wann?“, „Welcher Server hat die Adresse 203.0.113.7?“ oder „Warum sind meine Kosten diesen Monat gestiegen?“. Claude holt sich die Projekte, Charts, Log-Zeilen, Ereignisse und Kostentrends, die es braucht, zum Zeitpunkt deiner Frage.

Wo dein Client die Prompts des Connectors auflistet, sind zwei dabei:

  • diagnose_alert nimmt optional einen Alarmtitel oder Ressourcennamen, wie die App ihn zeigt, und nutzt sonst den schwersten aktiven Alarm. Die Vorlage bittet Claude, die aktiven Alarme, den Alarmverlauf, die Metriken der Ressource rund um den Zeitraum des Alarms, ihre Log-Zeilen und die letzten Änderungen zu lesen. Dann soll Claude die wahrscheinlichste Ursache, die Belege und den nächsten Check oder Fix nennen.
  • explain_cost_spike bittet Claude, die Kosten diesen Monat, die Prognose und den Vormonat zu vergleichen, im 30-Tage-Trend zu finden, wann die Änderung begann, die verantwortlichen Ressourcen zu finden und nach Ereignissen um diesen Zeitpunkt zu suchen.
ToolWas es liefert
list_projectsdie verbundenen Hetzner-Projekte des Teams, mit Zustand und Anzahl der Ressourcen
get_project_snapshotjede Ressource eines Projekts: Status, Zustand, technische Daten, Labels und Abhängigkeiten
get_resourceeine Ressource aus einem Projekt: technische Daten, Status, Labels, Standort, Abhängigkeiten
list_eventsdie letzten Aktionen beim Provider in einem Projekt, etwa Anlegen, Löschen, Anhängen oder Rebuild (30 Tage)
find_resource_by_ipwelche Ressourcen eine IP-Adresse haben oder enthalten
get_dedicated_serversdie dedizierten Server (Robot) des Teams, mit Agent-Status und Vertragspreisen
get_metricsdie Charts einer Ressource mit den Alarm-Schwellwerten: CPU, Speicher, Festplatte, Last und Netzwerk für Server; Requests, Verbindungen und Bandbreite für Load Balancer
get_server_metricsdie Speicher-, Festplatten- und Last-Charts des Agents für einen dedizierten Server
get_costsKosten diesen Monat und Prognose, den täglichen Trend, die teuersten Ressourcen oder die Kosten nach Label
get_active_alertsdie jetzt aktiven Alarme, die schwersten zuerst, stummgeschaltete gekennzeichnet
get_alert_historydie Alarm-Episoden der letzten 7 Tage, beendete eingeschlossen
get_agent_logsdie letzten System-Log-Zeilen ab Schweregrad Warning (72 Stunden), für einen Server oder das ganze Team
get_jobsdie Job-Reports eines Servers: letzter Durchlauf, letzter Erfolg, Exit-Code, ob veraltet
get_checksUptime-Checks: Status, seit wann, Verfügbarkeit, letzte Fehlerklasse, verbleibende Tage des Zertifikats
  • Read-only. Jedes Tool liest die eigenen Daten von Vaicoa. Keines davon kann einen Server, ein Projekt oder eine Einstellung ändern.
  • Kein Hetzner-Token. Der Connector hat nie Zugriff auf dein Hetzner-Token und kann die Hetzner-API nicht aufrufen.
  • Ein Team: das, das du bei der Anmeldung gewählt hast. Die Grenzen deines Plans gelten wie in der App, zum Beispiel wie weit Metriken zurückreichen.
  • 60 Tool-Aufrufe pro Minute. Darüber liefert ein Aufruf einen Fehler, der Claude bittet, eine Pause zu machen.
  • 64 KiB pro Ergebnis. Ein längeres Ergebnis wird abgeschnitten, mit einem Hinweis, die Abfrage einzugrenzen.
  • Nur Pro und Team. Jeder Aufruf prüft den aktuellen Plan des Teams. Der Connector funktioniert also nicht mehr, sobald ein Team Pro oder Team verlässt.

Entferne den Connector in Claude.