Cómo conectar ClickHouse Cloud a Claude vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → ClickHouse Cloud, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

ClickHouse Cloud + Claude

Gestiona una organización de ClickHouse Cloud desde tu agente de IA: lista los servicios con su estado, endpoints y escalado, arráncalos, detenlos o despiértalos, cambia el acceso por IP, las etiquetas y el autoescalado, revisa copias de seguridad y ClickPipes, consulta los costes de uso en ClickHouse Credits y los créditos restantes, y mira notificaciones, cuotas, miembros, roles, claves de API y el registro de auditoría.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

CLICKHOUSE_CLOUD_KEY_ID, CLICKHOUSE_CLOUD_KEY_SECRET

Paso 1 — Obtener credenciales

La configuración lleva unos 3 minutos. Necesitas acceso a la consola de ClickHouse Cloud de la organización.

1. En la consola de ClickHouse Cloud (https://console.clickhouse.cloud) abre Organization, API keys y haz clic en New API key.
2. Ponle un nombre, una caducidad, opcionalmente una lista de IP permitidas y el rol que necesita: para las lecturas basta un rol de solo lectura o developer; arrancar, detener, escalar y modificar servicios requiere admin o un rol personalizado con el permiso de gestionar servicios.
3. Copia el Key ID en CLICKHOUSE_CLOUD_KEY_ID y el Key secret en CLICKHOUSE_CLOUD_KEY_SECRET. El secreto solo se muestra una vez; si lo pierdes, crea una clave nueva. La API recibe ambos como HTTP Basic auth (key id como usuario, secreto como contraseña).
4. Instala el conector y ejecuta clickhouse_cloud_list_organizations: devuelve el organization_id que necesitan todas las demás herramientas y confirma la clave.

El conector habla con el plano de control de Cloud (https://api.clickhouse.cloud/v1) y no ejecuta SQL. Para consultar tus tablas instala el conector ClickHouse, que usa la interfaz HTTPS de un servicio.

Qué lee:

• Organización y clave: clickhouse_cloud_list_organizations, clickhouse_cloud_get_organization (endpoints privados, ajustes BYOC) y clickhouse_cloud_whoami (la clave, su organización y sus roles; un endpoint beta de ClickHouse).
• Servicios: clickhouse_cloud_list_services (con filtro opcional por etiquetas como tag:Environment=Production) y clickhouse_cloud_get_service con estado, proveedor de nube y región, versión de ClickHouse, tier, endpoints, memoria y número de réplicas, escalado en reposo, lista de acceso por IP, canal de versiones y etiquetas. clickhouse_cloud_get_service_settings muestra los ajustes del servidor que difieren de los predeterminados, y clickhouse_cloud_get_service_metrics las métricas actuales de Prometheus en texto (filtered_metrics para la lista corta seleccionada).
• Copias de seguridad: clickhouse_cloud_list_backups, clickhouse_cloud_get_backup (estado, inicio y fin, tamaño, duración, completa o incremental) y clickhouse_cloud_get_backup_configuration (periodo, retención y hora de inicio diaria).
• Ingesta: clickhouse_cloud_list_clickpipes y clickhouse_cloud_get_clickpipe para ClickPipes desde Kafka, S3, Postgres, MySQL y otras fuentes. Necesitan una clave con el permiso de gestionar ClickPipes.
• Costes y estado: clickhouse_cloud_get_usage_cost por día y por entidad (data warehouse, servicio, ClickPipe) con las métricas que lo componen (cómputo, almacenamiento, copias, transferencia de datos), clickhouse_cloud_get_credit_balances (requiere el permiso de ver la facturación), clickhouse_cloud_list_notifications (facturación, salud de servicios, fallos de ClickPipes, actualizaciones; con filtro por gravedad, tipo, recurso o fechas) y clickhouse_cloud_list_quotas.
• Personas y accesos: clickhouse_cloud_list_members, clickhouse_cloud_list_invitations, clickhouse_cloud_list_roles, clickhouse_cloud_list_api_keys (los secretos nunca se devuelven) y clickhouse_cloud_list_activities, el registro de auditoría con autor, dirección IP e ids de destino.

Qué cambia:

• clickhouse_cloud_change_service_state arranca, detiene o despierta (awake) un servicio. Detenerlo apaga el cómputo: los datos se conservan y se deja de facturar el cómputo, pero las consultas fallan hasta que se vuelve a arrancar, así que la IA te pregunta antes.
• clickhouse_cloud_update_service renombra un servicio, fija el canal de versiones (slow, default o fast) y añade o quita entradas de la lista de acceso por IP y etiquetas. Solo cambian los campos indicados; las eliminaciones se aplican antes que las altas.
• clickhouse_cloud_update_replica_scaling cambia la memoria por réplica (mínimo y máximo en GB, múltiplos de 4; límites de memoria solo en el tier Production), el modo de autoescalado, el número de réplicas, el escalado en reposo y el tiempo de inactividad (al menos 5 minutos).
• clickhouse_cloud_change_clickpipe_state arranca, detiene o resincroniza una ClickPipe. Un resync vuelve a copiar las tablas de origen, así que la IA lo confirma contigo.
• clickhouse_cloud_create_invitation invita a una persona por correo con ids de rol de clickhouse_cloud_list_roles.

Las 26 herramientas están activas tras la instalación; ninguna está desactivada. Da a la clave un rol de solo lectura si la IA solo debe mirar.

Formatos de datos: cada respuesta es {status, requestId, result} y los datos están en result. Los ids son UUID y las horas ISO 8601 en UTC. Los costes están en ClickHouse Credits (CHC): grandTotalCHC para el periodo y totalCHC por registro. La memoria va en GB, el tamaño de las copias en bytes y las duraciones en segundos. El state de un servicio pasa por starting o stopping antes de running o stopped; idle significa escalado a cero, y la siguiente consulta lo despierta.

Paginación: clickhouse_cloud_list_organizations, clickhouse_cloud_list_api_keys y clickhouse_cloud_list_notifications aceptan limit (hasta 250) y devuelven nextCursor cuando hay más elementos; la IA lo pasa como cursor hasta que deja de aparecer. Las demás listas llegan completas de una vez.

Límites: un informe de costes cubre como máximo 31 días (to_date como mucho 30 días después de from_date); para periodos más largos la IA hace varias llamadas. La API tiene un límite de peticiones por clave.

Errores comunes: 401 indica un key id o secreto incorrectos, o una clave caducada o desactivada. 403 indica que el rol de la clave no tiene el permiso para la llamada (facturación, ClickPipes y gestión de servicios son permisos distintos) o que la IP de origen está fuera de la lista permitida de la clave: en AnythingMCP Cloud añade la IP de salida del servidor; en self-hosted, la IP de tu servidor. 404 indica un id de organización, servicio o copia incorrecto. 429 es el límite de peticiones; espera unos segundos y vuelve a intentarlo.

El conector no ejecuta SQL, no crea ni elimina servicios, no restaura ni borra copias de seguridad, no crea ni revoca claves de API y no elimina miembros.

Paso 2 — Instalar el adapter

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

Paso 3 — Añadir el conector en Claude

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Ruta recomendada: funciona en claude.ai web sin tocar ningún archivo de configuración.

1. En Claude, abre Customize → Connectors.
2. Pulsa + y después Add custom connector.
3. Escribe un nombre, por ejemplo ClickHouse Cloud, y la URL del servidor MCP remoto https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, y pulsa Add.
4. Pulsa Connect e inicia sesión en AnythingMCP (OAuth) para permitir el acceso.

Todas las herramientas debajo aparecen en tu chat: empieza a escribir prompts.

Herramientas disponibles

Ejemplos de prompts

• "¿Cuáles de nuestros servicios de ClickHouse Cloud están en marcha ahora mismo y cuáles están en reposo o detenidos?"
• "¿Cuántos ClickHouse Credits gastamos en octubre, desglosados por servicio? ¿Qué día fue el más caro?"
• "¿Terminó la copia de seguridad de anoche del servicio de producción? Muéstrame tamaño y duración."
• "Añade 203.0.113.0/24 con la descripción 'oficina' a la lista de acceso por IP del servicio de staging."
• "¿Quién detuvo o escaló un servicio en los últimos 7 días? Muéstrame las entradas del registro de auditoría."

FAQ

¿Funciona con Claude Code igual que con Claude Desktop? Sí, apunta ambos a https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.

Siguientes pasos

• Página del conector
• Conectar a ChatGPT
• Conectar a Cursor
• Conectar a Gemini
• Conectar a Meta Muse
• Conectar a Microsoft Copilot