Habilitar y conectar el servidor MCP remoto de ClickHouse Cloud

Esta guía muestra cómo habilitar el servidor MCP remoto de ClickHouse Cloud y configurarlo para usarlo con herramientas de desarrollo habituales.

Requisitos previos

• Un servicio de ClickHouse Cloud en ejecución
• El IDE o la herramienta de desarrollo con agentes que prefiera

Conéctese al servicio de ClickHouse Cloud en el que desea habilitar el servidor MCP remoto. En el menú de la izquierda, haga clic en Conectar. Se abrirá una ventana con los detalles de conexión.

Seleccione Conectar with MCP:

Active el botón para habilitar MCP en el servicio:

Copie la URL que se muestra, que es la misma que aparece a continuación:

https://mcp.clickhouse.cloud/mcp

Elige tu IDE o herramienta a continuación y sigue las instrucciones de configuración correspondientes.

Desde tu directorio de trabajo, ejecuta el siguiente comando para agregar la configuración del MCP Server de ClickHouse Cloud a Claude Code:

claude mcp add --transport http clickhouse-cloud https://mcp.clickhouse.cloud/mcp

Después, inicia Claude Code:

claude

Ejecute el siguiente comando para ver la lista de servidores MCP:

/mcp

Selecciona clickhouse-cloud y autentícate con OAuth usando tus credenciales de ClickHouse Cloud.

1. Ve a Personalizar > Conectores
2. Haz clic en el icono "+" y en Agregar conector personalizado
3. Asigna al conector personalizado un nombre como clickhouse-cloud y agrégalo
4. Haz clic en el conector clickhouse-cloud que acabas de agregar y luego en Conectar
5. Autentícate con tus credenciales de ClickHouse Cloud mediante OAuth

1. Explora e instala servidores MCP desde el Marketplace de Cursor.
2. Busca ClickHouse y haz clic en "Add to Cursor" en cualquiera de los servidores para instalarlo
3. Autentícate con OAuth.

Añade la siguiente configuración a tu .vscode/mcp.json:

{
  "servers": {
    "clickhouse-cloud": {
      "type": "http",
      "url": "https://mcp.clickhouse.cloud/mcp"
    }
  }
}

Para obtener más información, consulta la documentación de Visual Studio Code.

Edita el archivo mcp_config.json con la siguiente configuración:

{
  "mcpServers": {
    "clickhouse-cloud": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.clickhouse.cloud/mcp"]
    }
  }
}

Para más detalles, consulta la documentación de Windsurf.

Añade ClickHouse como un servidor personalizado. Añade lo siguiente a la configuración de Zed, en context_servers:

{
  "context_servers": {
    "clickhouse-cloud": {
      "url": "https://mcp.clickhouse.cloud/mcp"
    }
  }
}

Zed debería solicitarte que te autentiques mediante OAuth cuando se conecte por primera vez al servidor. Para obtener más información, consulta la documentación de Zed.

Ejecute el siguiente comando para agregar el servidor MCP de ClickHouse Cloud desde la CLI:

codex mcp add clickhouse-cloud --url https://mcp.clickhouse.cloud/mcp

Una vez conectado, puedes interactuar con ClickHouse Cloud mediante prompts en lenguaje natural. A continuación, se muestran algunos flujos de trabajo habituales y las herramientas que tu cliente MCP invocará en segundo plano. Para consultar la lista completa de herramientas disponibles, consulta la referencia de herramientas.

Comienza por descubrir qué hay disponible:

Haz preguntas en lenguaje natural y el agente las traducirá a SQL:

La herramienta run_select_query solo permite sentencias SELECT. Todas las consultas son de solo lectura.

Consulta tus recursos de ClickHouse Cloud:

• ClickHouse agent skills