ClickHouse Cloud über MCP mit Claude verbinden

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → ClickHouse Cloud klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein git clone, kein lokaler Server.

ClickHouse Cloud + Claude

Verwalte eine ClickHouse-Cloud-Organisation aus deinem KI-Agent: Services mit Status, Endpunkten und Skalierung auflisten, starten, stoppen oder aufwecken, IP-Zugriff, Tags und Autoscaling ändern, Backups und ClickPipes prüfen, Nutzungskosten in ClickHouse Credits und das Restguthaben lesen sowie Benachrichtigungen, Quotas, Mitglieder, Rollen, API-Keys und das Audit-Log ansehen.

Voraussetzungen

Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:

CLICKHOUSE_CLOUD_KEY_ID, CLICKHOUSE_CLOUD_KEY_SECRET

Schritt 1 — Zugangsdaten holen

Die Einrichtung dauert etwa 3 Minuten. Du brauchst Zugriff auf die ClickHouse-Cloud-Konsole der Organisation.

1. Öffne in der ClickHouse-Cloud-Konsole (https://console.clickhouse.cloud) Organization, API keys und klicke auf New API key.
2. Gib dem Key einen Namen, ein Ablaufdatum, optional eine IP-Allowlist und die nötige Rolle: Für das Lesen reicht eine Read-only- oder Developer-Rolle; Services starten, stoppen, skalieren und ändern braucht Admin oder eine eigene Rolle mit der Berechtigung, Services zu verwalten.
3. Kopiere die Key ID in CLICKHOUSE_CLOUD_KEY_ID und das Key secret in CLICKHOUSE_CLOUD_KEY_SECRET. Das Secret wird nur einmal angezeigt; geht es verloren, erstellst du einen neuen Key. Die API nimmt beides als HTTP Basic Auth entgegen (Key ID als Benutzername, Secret als Passwort).
4. Installiere den Connector und führe clickhouse_cloud_list_organizations aus: Es liefert die organization_id, die alle anderen Tools brauchen, und bestätigt den Key.

Der Connector spricht mit der Cloud Control Plane (https://api.clickhouse.cloud/v1) und führt kein SQL aus. Für Abfragen auf deine Tabellen installierst du den Connector ClickHouse, der die HTTPS-Schnittstelle eines Services nutzt.

Was er liest:

• Organisation und Key: clickhouse_cloud_list_organizations, clickhouse_cloud_get_organization (Private Endpoints, BYOC-Einstellungen) und clickhouse_cloud_whoami (der Key, seine Organisation und Rollen; bei ClickHouse ein Beta-Endpunkt).
• Services: clickhouse_cloud_list_services (optional nach Tags gefiltert, etwa tag:Environment=Production) und clickhouse_cloud_get_service mit Status, Cloud-Anbieter und Region, ClickHouse-Version, Tier, Endpunkten, Speicher und Anzahl der Replikas, Idle-Scaling, IP-Zugriffsliste, Release-Channel und Tags. clickhouse_cloud_get_service_settings zeigt die Servereinstellungen, die vom Standard abweichen, clickhouse_cloud_get_service_metrics die aktuellen Prometheus-Metriken als Text (filtered_metrics für die kurze kuratierte Liste).
• Backups: clickhouse_cloud_list_backups, clickhouse_cloud_get_backup (Status, Start und Ende, Größe, Dauer, voll oder inkrementell) und clickhouse_cloud_get_backup_configuration (Backup-Intervall, Aufbewahrung und tägliche Startzeit).
• Ingestion: clickhouse_cloud_list_clickpipes und clickhouse_cloud_get_clickpipe für ClickPipes aus Kafka, S3, Postgres, MySQL und anderen Quellen. Sie brauchen einen Key mit der Berechtigung, ClickPipes zu verwalten.
• Kosten und Zustand: clickhouse_cloud_get_usage_cost pro Tag und pro Einheit (Data Warehouse, Service, ClickPipe) mit den zugrunde liegenden Metriken (Compute, Storage, Backup, Datenübertragung), clickhouse_cloud_get_credit_balances (braucht die Berechtigung, Billing zu sehen), clickhouse_cloud_list_notifications (Abrechnung, Service-Zustand, ClickPipe-Fehler, Upgrades; filterbar nach Schweregrad, Typ, Ressource oder Datum) und clickhouse_cloud_list_quotas.
• Personen und Zugriff: clickhouse_cloud_list_members, clickhouse_cloud_list_invitations, clickhouse_cloud_list_roles, clickhouse_cloud_list_api_keys (Secrets werden nie zurückgegeben) und clickhouse_cloud_list_activities, das Audit-Log mit Akteur, IP-Adresse und Ziel-IDs.

Was er ändert:

• clickhouse_cloud_change_service_state startet, stoppt oder weckt (awake) einen Service. Ein Stopp fährt das Compute herunter: Die Daten bleiben erhalten und die Compute-Abrechnung endet, aber Abfragen schlagen fehl, bis der Service wieder gestartet ist. Deshalb fragt die KI vorher nach.
• clickhouse_cloud_update_service benennt einen Service um, setzt den Release-Channel (slow, default oder fast) und fügt Einträge der IP-Zugriffsliste und Tags hinzu oder entfernt sie. Nur die übergebenen Felder ändern sich; Entfernen läuft vor dem Hinzufügen.
• clickhouse_cloud_update_replica_scaling ändert den Speicher pro Replika (Minimum und Maximum in GB, Vielfache von 4; Speichergrenzen nur im Production-Tier), den Autoscaling-Modus, die Anzahl der Replikas, das Idle-Scaling und das Idle-Timeout (mindestens 5 Minuten).
• clickhouse_cloud_change_clickpipe_state startet, stoppt oder resynchronisiert eine ClickPipe. Ein Resync kopiert die Quelltabellen erneut, deshalb bestätigt die KI ihn mit dir.
• clickhouse_cloud_create_invitation lädt eine Person per E-Mail ein, mit Rollen-IDs aus clickhouse_cloud_list_roles.

Alle 26 Tools sind nach der Installation aktiv; keines ist abgeschaltet. Gib dem Key eine Read-only-Rolle, wenn die KI nur nachsehen soll.

Datenformate: Jede Antwort ist {status, requestId, result}, die Daten stehen in result. IDs sind UUIDs, Zeiten ISO 8601 in UTC. Kosten sind in ClickHouse Credits (CHC): grandTotalCHC für den Zeitraum und totalCHC pro Eintrag. Speicher ist in GB, die Backup-Größe in Bytes, Dauern in Sekunden. Der state eines Services läuft über starting oder stopping zu running oder stopped; idle heißt auf null skaliert, die nächste Abfrage weckt ihn.

Paging: clickhouse_cloud_list_organizations, clickhouse_cloud_list_api_keys und clickhouse_cloud_list_notifications nehmen limit (bis 250) und liefern nextCursor, wenn es mehr Einträge gibt; die KI gibt ihn als cursor weiter, bis er fehlt. Alle anderen Listen kommen vollständig auf einmal.

Limits: Ein Nutzungskostenbericht umfasst höchstens 31 Tage (to_date höchstens 30 Tage nach from_date); für längere Zeiträume macht die KI mehrere Aufrufe. Die API ist pro Key rate-limitiert.

Häufige Fehler: 401 bedeutet eine falsche Key ID oder ein falsches Secret oder einen abgelaufenen oder deaktivierten Key. 403 bedeutet, dass der Rolle des Keys die Berechtigung für den Aufruf fehlt (Billing, ClickPipes und Service-Verwaltung sind getrennte Berechtigungen) oder die IP des Aufrufers außerhalb der Allowlist des Keys liegt: Auf AnythingMCP Cloud trägst du die ausgehende IP des Servers ein, self-hosted die IP deines Servers. 404 bedeutet eine falsche Organisations-, Service- oder Backup-ID. 429 ist das Rate-Limit; warte ein paar Sekunden und versuche es erneut.

Der Connector führt kein SQL aus, erstellt oder löscht keine Services, stellt keine Backups wieder her und löscht keine, erstellt oder widerruft keine API-Keys und entfernt keine Mitglieder.

Schritt 2 — Adapter installieren

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Schritt 3 — Connector in Claude hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese Anleitung YOUR_SERVER_ID zeigt.

Empfohlener Weg: funktioniert auf claude.ai web ohne Anfassen einer Konfigurationsdatei.

1. Öffne in Claude Customize → Connectors.
2. Klicke auf + und dann auf Add custom connector.
3. Gib einen Namen ein, z. B. ClickHouse Cloud, und die Remote-MCP-Server-URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, dann klicke auf Add.
4. Klicke auf Connect und melde dich bei AnythingMCP an (OAuth), um den Zugriff zu erlauben.

Alle unten gelisteten Tools erscheinen in deinem Chat: Leg los mit Prompts.

Verfügbare Tools

Beispiel-Prompts

• „Welche unserer ClickHouse-Cloud-Services laufen gerade, und welche sind idle oder gestoppt?“
• „Wie viele ClickHouse Credits haben wir im Oktober verbraucht, aufgeteilt nach Service? Welcher Tag war am teuersten?“
• „Ist das Backup des Produktions-Services von heute Nacht fertig? Zeig mir Größe und Dauer.“
• „Füge 203.0.113.0/24 mit der Beschreibung ‚Büro‘ zur IP-Zugriffsliste des Staging-Services hinzu.“
• „Wer hat in den letzten 7 Tagen einen Service gestoppt oder skaliert? Zeig mir die Einträge im Audit-Log.“

FAQ

Funktioniert es mit Claude Code genauso wie mit Claude Desktop? Ja, beide auf https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID zeigen lassen.

Nächste Schritte

• Connector-Startseite
• Mit ChatGPT verbinden
• Mit Cursor verbinden
• Mit Gemini verbinden
• Mit Meta Muse verbinden
• Mit Microsoft Copilot verbinden