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.
Einrichten
Abschnitt betitelt „Einrichten“-
Geh in Claude (Web, Desktop oder Mobil) auf Einstellungen → Connectors → Eigenen Connector hinzufügen.
-
Gib die Server-URL
https://api.vaicoa.com/mcpein. -
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:
claude mcp add --transport http cloudviewer https://api.vaicoa.com/mcpFühr dann in Claude Code /mcp aus, um dich anzumelden und das Team zu
wählen.
Was du fragen kannst
Abschnitt betitelt „Was du fragen kannst“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.
Prompt-Vorlagen
Abschnitt betitelt „Prompt-Vorlagen“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.
| Tool | Was es liefert |
|---|---|
list_projects | die verbundenen Hetzner-Projekte des Teams, mit Zustand und Anzahl der Ressourcen |
get_project_snapshot | jede Ressource eines Projekts: Status, Zustand, technische Daten, Labels und Abhängigkeiten |
get_resource | eine Ressource aus einem Projekt: technische Daten, Status, Labels, Standort, Abhängigkeiten |
list_events | die letzten Aktionen beim Provider in einem Projekt, etwa Anlegen, Löschen, Anhängen oder Rebuild (30 Tage) |
find_resource_by_ip | welche Ressourcen eine IP-Adresse haben oder enthalten |
get_dedicated_servers | die dedizierten Server (Robot) des Teams, mit Agent-Status und Vertragspreisen |
get_metrics | die 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_metrics | die Speicher-, Festplatten- und Last-Charts des Agents für einen dedizierten Server |
get_costs | Kosten diesen Monat und Prognose, den täglichen Trend, die teuersten Ressourcen oder die Kosten nach Label |
get_active_alerts | die jetzt aktiven Alarme, die schwersten zuerst, stummgeschaltete gekennzeichnet |
get_alert_history | die Alarm-Episoden der letzten 7 Tage, beendete eingeschlossen |
get_agent_logs | die letzten System-Log-Zeilen ab Schweregrad Warning (72 Stunden), für einen Server oder das ganze Team |
get_jobs | die Job-Reports eines Servers: letzter Durchlauf, letzter Erfolg, Exit-Code, ob veraltet |
get_checks | Uptime-Checks: Status, seit wann, Verfügbarkeit, letzte Fehlerklasse, verbleibende Tage des Zertifikats |
Grenzen
Abschnitt betitelt „Grenzen“- 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.
Zugriff widerrufen
Abschnitt betitelt „Zugriff widerrufen“Entferne den Connector in Claude.