Cómo conectar ClickHouse Cloud a Microsoft Copilot 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 + Microsoft Copilot

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 Microsoft Copilot

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.

Microsoft Copilot usa servidores MCP a través de agentes creados en Copilot Studio: añades AnythingMCP a un agente como herramienta y luego publicas el agente en Microsoft 365 Copilot y Teams. Copilot Studio se conecta desde la nube de Microsoft por Streamable HTTP, que AnythingMCP admite.

1. En Copilot Studio, abre tu agente (o crea uno), ve a Tools y elige Add a tool → New tool → Model Context Protocol.
2. Escribe un Server name (por ejemplo AnythingMCP), una Server description que diga qué hace el conector y la Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descripción para decidir cuándo llamar al servidor.
3. En la autenticación, elige API key, pon Type en Header y X-API-Key como nombre de la cabecera, y selecciona Create.
4. En Add tool, elige Create a new connection, pega una clave de API MCP de AnythingMCP (MCP Servers → tu servidor → API keys) y selecciona Add to agent.
5. Pruébalo en el panel Test del agente: pide algo que necesite las herramientas de ClickHouse Cloud.
6. Selecciona Publish y luego Channels → Microsoft 365 and Microsoft Teams, deja marcada Make agent available in Microsoft Copilot y elige Add channel. See agent in Teams lo instala para ti; en Microsoft 365 Copilot, escribe @ y elige el agente.

¿Prefieres que cada persona inicie sesión? En lugar de la clave de API elige OAuth 2.0 → Dynamic discovery: cada usuario inicia sesión en AnythingMCP la primera vez que el agente lo llama.

¿Lo alojas tú mismo? Usa la dirección HTTPS pública de tu instancia en lugar de https://cloud.anythingmcp.com. Copilot Studio se conecta desde la nube de Microsoft, así que localhost no funciona.

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

¿Para qué Copilot es? Para Microsoft 365 Copilot en el trabajo, mediante agentes de Copilot Studio. La app de Microsoft Copilot para cuentas personales no permite añadir tu propio servidor MCP.

¿Qué necesito? Una cuenta de trabajo con acceso a Copilot Studio (licencia o prueba) para crear el agente. Quien lo use en Microsoft 365 Copilot o Teams necesita acceso al agente: compártelo o pide a un administrador que lo publique para la organización. Si tu organización aplica directivas de datos a los conectores de Power Platform, también cubren los servidores MCP.

El agente no llama a las herramientas. Comprueba que el nombre de la cabecera sea exactamente X-API-Key y que la clave pertenezca al mismo servidor MCP que la URL, y escribe una Server description concreta: Copilot Studio la usa para decidir cuándo llamar al servidor. Vuelve a publicar el agente después de cada cambio; en un chat abierto, escribe "start over" para usar la nueva versión.

Siguientes pasos

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