> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Uso de ClickHouse MCP server con Claude Desktop
> Esta guía explica cómo configurar Claude Desktop con un ClickHouse MCP server.
export const Image = ({img, alt, size = "lg"}) => {
const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
return
;
};
> Esta guía explica cómo configurar Claude Desktop con un ClickHouse MCP server usando uv
> y conectarlo a los conjuntos de datos de ejemplo de ClickHouse.
Necesitarás instalar [uv](https://docs.astral.sh/uv/) para seguir las instrucciones de esta guía.
Si no quieres usar uv, tendrás que actualizar la configuración del MCP server para usar otro gestor de paquetes.
También tendrás que instalar la aplicación Claude Desktop, que puedes descargar desde el [sitio web de Claude Desktop](https://claude.ai/desktop).
Una vez que hayas instalado Claude Desktop, es hora de configurar el [ClickHouse MCP server](https://github.com/ClickHouse/mcp-clickhouse).
Podemos hacerlo mediante el [archivo de configuración de Claude Desktop](https://claude.ai/docs/configuration).
Para encontrar este archivo, primero ve a la página de configuración (`Cmd+,` en Mac) y luego haz clic en la pestaña `Developer` del menú de la izquierda.
A continuación verás la siguiente pantalla, en la que tendrás que hacer clic en el botón `Edit config`:
Esto te llevará a un directorio que contiene el archivo de configuración (`claude_desktop_config.json`).
La primera vez que abras ese archivo, probablemente contendrá lo siguiente:
```json theme={null}
{
"mcpServers": {}
}
```
El diccionario `mcpServers` toma como clave el nombre de un MCP server y como valor un diccionario de opciones de configuración.
Por ejemplo, la configuración de ClickHouse MCP server para conectarse a ClickHouse Playground tendría este aspecto:
```json theme={null}
{
"mcpServers": {
"mcp-clickhouse": {
"command": "uv",
"args": [
"run",
"--with",
"mcp-clickhouse",
"--python",
"3.10",
"mcp-clickhouse"
],
"env": {
"CLICKHOUSE_HOST": "sql-clickhouse.clickhouse.com",
"CLICKHOUSE_PORT": "8443",
"CLICKHOUSE_USER": "demo",
"CLICKHOUSE_PASSWORD": "",
"CLICKHOUSE_SECURE": "true",
"CLICKHOUSE_VERIFY": "true",
"CLICKHOUSE_CONNECT_TIMEOUT": "30",
"CLICKHOUSE_SEND_RECEIVE_TIMEOUT": "30"
}
}
}
}
```
Una vez que hayas actualizado la configuración, tendrás que reiniciar Claude Desktop para que los cambios surtan efecto.
Dependiendo de cómo hayas instalado `uv`, es posible que veas el siguiente error al reiniciar Claude Desktop:
```text theme={null}
MCP mcp-clickhouse: spawn uv ENOENT
```
Si eso ocurre, tendrás que actualizar `command` para que incluya la ruta completa a `uv`. Por ejemplo, si lo has instalado mediante Cargo, será `/Users//.cargo/bin/uv`
Una vez que hayas reiniciado Claude Desktop, puedes encontrar el ClickHouse MCP server haciendo clic en el icono `Search and tools`:
Luego puedes elegir si quieres desactivar todas o solo algunas de las herramientas.
Ahora ya estamos listos para hacerle a Claude algunas preguntas que harán que use el ClickHouse MCP server.
Por ejemplo, podríamos preguntarle `¿Cuál es el conjunto de datos más interesante del Playground de SQL?`.
Claude nos pedirá que confirmemos el uso de cada herramienta del MCP server la primera vez que se invoque:
A continuación puedes ver parte de una conversación que incluye algunas llamadas a herramientas del ClickHouse MCP server: