> ## 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.
# Como usar o servidor MCP do ClickHouse com o Open WebUI
> Este guia explica como configurar o Open WebUI com o servidor MCP do ClickHouse usando Docker.
export const Image = ({img, alt, size = "lg"}) => {
const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
return
;
};
> Este guia explica como configurar o [Open WebUI](https://github.com/open-webui/open-webui) com um servidor MCP do ClickHouse
> e conectá-lo aos conjuntos de dados de exemplo do ClickHouse.
Você precisará instalar o [uv](https://docs.astral.sh/uv/) para seguir as instruções deste guia.
Se não quiser usar o uv, será necessário atualizar a config do servidor MCP para usar um gerenciador de pacotes alternativo.
Para iniciar o Open WebUI, você pode executar o seguinte comando:
```bash theme={null}
uv run --with open-webui open-webui serve
```
Acesse [http://localhost:8080/](http://localhost:8080/) para ver a UI.
Para configurar o servidor MCP do ClickHouse, precisaremos converter o servidor MCP em endpoints OpenAPI.
Primeiro, vamos definir variáveis de ambiente que nos permitirão conectar ao playground SQL do ClickHouse:
```bash theme={null}
export CLICKHOUSE_HOST="sql-clickhouse.clickhouse.com"
export CLICKHOUSE_USER="demo"
export CLICKHOUSE_PASSWORD=""
```
Em seguida, podemos executar `mcpo` para criar os endpoints OpenAPI:
```bash theme={null}
uvx mcpo --port 8000 -- uv run --with mcp-clickhouse --python 3.10 mcp-clickhouse
```
Você pode ver uma lista dos endpoints criados acessando [http://localhost:8000/docs](http://localhost:8000/docs)
Para usar esses endpoints com o Open WebUI, precisamos ir até as configurações:
Clique em `Tools`:
Adicione [http://localhost:8000](http://localhost:8000) como URL da ferramenta:
Depois de fazer isso, deveremos ver um `1` ao lado do ícone da ferramenta na barra de chat:
Se clicarmos no ícone da ferramenta, poderemos listar as ferramentas disponíveis:
Por padrão, o Open WebUI funciona com modelos do Ollama, mas também podemos adicionar endpoints compatíveis com OpenAI.
Eles são configurados pelo menu de configurações, mas desta vez precisamos clicar na aba `Connections`:
Vamos adicionar o endpoint e nossa chave da OpenAI:
Os modelos da OpenAI ficarão disponíveis no menu superior:
Em seguida, podemos iniciar uma conversa, e o Open WebUI acionará o servidor MCP se necessário: