Skip to main content
No todos los usuarios interactúan con ClickHouse a través de la consola de ClickHouse Cloud. Por ejemplo, muchos desarrolladores trabajan directamente desde sus editores de código preferidos, agentes de CLI o se conectan a la base de datos mediante configuraciones personalizadas, mientras que otros dependen de asistentes de IA de propósito general como Anthropic Claude para gran parte de su exploración. Estos usuarios y las cargas de trabajo basadas en agentes que actúan en su nombre necesitan una forma de acceder a ClickHouse Cloud y realizar consultas de forma segura sin configuraciones complejas ni infraestructura personalizada. La capacidad de servidor MCP remoto de ClickHouse Cloud resuelve esto al exponer una interfaz estándar que los agentes externos pueden usar para obtener contexto analítico. MCP, o Model Context Protocol, es un estándar de acceso a datos estructurados para aplicaciones de IA basadas en LLM. Con esta integración, los agentes externos pueden listar bases de datos y tablas, inspeccionar esquemas y ejecutar consultas SELECT limitadas y de solo lectura. La autenticación se gestiona mediante OAuth 2.0 o una clave de API de ClickHouse Cloud. El servidor está totalmente gestionado en ClickHouse Cloud, por lo que no requiere configuración ni mantenimiento. Esto facilita que las herramientas basadas en agentes se conecten a ClickHouse y obtengan los datos que necesitan, ya sea para análisis, resúmenes, generación de código o exploración.

​
Servidor MCP remoto vs. servidor MCP de código abierto

ClickHouse ofrece dos servidores MCP. El servidor MCP remoto ofrece la integración más completa con ClickHouse Cloud, incluida la gestión de servicios, la monitorización de copias de seguridad, la visibilidad de ClickPipe y los datos de facturación, sin necesidad de gestionar infraestructura. Para instancias autogestionadas de ClickHouse, consulta las guías del servidor MCP de código abierto.

​
Habilitar el servidor MCP remoto

El servidor MCP remoto debe habilitarse en cada servicio antes de poder aceptar conexiones. En la consola de ClickHouse Cloud, abra el servicio, haga clic en el botón Connect, seleccione MCP y habilítelo. Para habilitar o deshabilitar el servidor MCP remoto se requiere el permiso control-plane:service:manage-mcp (consulte Roles y permisos de la consola). Para ver los pasos detallados con capturas de pantalla, consulte la guía de configuración.

​
Endpoint

Una vez habilitado, el servidor MCP remoto estará disponible en:

​
Autenticación

El servidor MCP remoto admite dos métodos de autenticación:
  • OAuth 2.0: recomendado para Clients interactivos. Cuando un Client MCP se conecta por primera vez, abre una ventana del navegador para que el usuario inicie sesión con sus credenciales de ClickHouse Cloud. El acceso se limita a las organizaciones y los servicios para los que el usuario autenticado tiene permisos.
  • Clave de API de ClickHouse Cloud: pensada para entornos remotos, sin interfaz gráfica (headless) y automatizados en los que no resulta práctico un flujo OAuth basado en navegador. Envíe el ID y el secreto de la clave de API mediante autenticación HTTP Basic:
El acceso mediante clave de API queda limitado por los roles, los permisos y la fecha de expiración configurados para la clave. Utilice una clave dedicada con privilegios mínimos e inyéctela a través de un sistema de gestión de secretos. La codificación Base64 no cifra las credenciales, así que no haga commit del valor codificado en el control de versiones ni lo exponga en los logs. Para ver un ejemplo de cómo configurar un Client MCP en un entorno sin interfaz gráfica, consulte Autenticarse desde un entorno sin interfaz gráfica.

​
Seguridad

Todas las herramientas expuestas por el servidor MCP remoto son de solo lectura. Cada herramienta está marcada con readOnlyHint: true en sus metadatos de MCP. Ninguna herramienta puede modificar datos, alterar la configuración del servicio ni realizar operaciones destructivas.

​
Herramientas disponibles

El servidor MCP remoto ofrece 13 herramientas organizadas en las siguientes categorías.

​
Exploración de consultas y del esquema

Estas herramientas permiten a los agentes descubrir qué datos hay disponibles y ejecutar consultas analíticas.

​
Organizaciones

​
Servicios

​
Copias de seguridad

​
ClickPipes

​
Facturación

​
Primeros pasos

Consulta la guía de configuración para ver instrucciones paso a paso sobre cómo habilitar el servidor MCP remoto y conectarlo a un cliente MCP.