> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-detect-table-modification.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Uso de ClickHouse MCP server con Open WebUI
> Esta guía explica cómo configurar Open WebUI con un ClickHouse MCP server mediante Docker.
export const Image = ({img, alt, size = "lg"}) => {
const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
return
;
};
> Esta guía explica cómo configurar [Open WebUI](https://github.com/open-webui/open-webui) con un ClickHouse MCP server
> y conectarlo a los datasets de ejemplo de ClickHouse.
## Instalar uv
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.
## Iniciar Open WebUI
Para iniciar Open WebUI, puedes ejecutar el siguiente comando:
```bash theme={null}
uv run --with open-webui open-webui serve
```
Ve a [http://localhost:8080/](http://localhost:8080/) para ver la UI.
## Configurar ClickHouse MCP server
Para configurar el ClickHouse MCP server, tendremos que convertir el MCP server en endpoints de Open API.
Primero, definamos variables de entorno que nos permitirán conectarnos al Playground de SQL de ClickHouse:
```bash theme={null}
export CLICKHOUSE_HOST="sql-clickhouse.clickhouse.com"
export CLICKHOUSE_USER="demo"
export CLICKHOUSE_PASSWORD=""
```
Después, podemos ejecutar `mcpo` para crear los endpoints de Open API:
```bash theme={null}
uvx mcpo --port 8000 -- uv run --with mcp-clickhouse --python 3.10 mcp-clickhouse
```
Puedes ver una lista de los endpoints creados en [http://localhost:8000/docs](http://localhost:8000/docs)
Para usar estos endpoints con Open WebUI, tenemos que ir a la configuración:
Haz clic en `Tools`:
Añade [http://localhost:8000](http://localhost:8000) como URL de la herramienta:
Una vez hecho esto, deberíamos ver un `1` junto al icono de la herramienta en la barra de chat:
Si hacemos clic en el icono de la herramienta, podremos ver la lista de herramientas disponibles:
## Configurar OpenAI
De forma predeterminada, Open WebUI funciona con modelos de Ollama, pero también podemos añadir endpoints compatibles con OpenAI.
Esto se configura desde el menú de configuración, pero esta vez tenemos que hacer clic en la pestaña `Connections`:
Añadamos el endpoint y nuestra clave de OpenAI:
Los modelos de OpenAI estarán entonces disponibles en el menú superior:
## Chatear con ClickHouse MCP server desde Open WebUI
Después, podremos tener una conversación y Open WebUI llamará al MCP server si es necesario: