> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-55d9d317.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Usando o ClickHouse MCP server com o Open WebUI
> Este guia explica como configurar o Open WebUI com um ClickHouse MCP server usando Docker.
export const Image = ({img, alt, size}) => {
return
;
};
> Este guia explica como configurar o [Open WebUI](https://github.com/open-webui/open-webui) com um ClickHouse MCP server
> e conectá-lo aos conjuntos de dados de exemplo do ClickHouse.
## Instale o uv
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 configuração do MCP server para usar um gerenciador de pacotes alternativo.
## Inicie o Open WebUI
Para iniciar o Open WebUI, execute 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.
## Configure o ClickHouse MCP server
Para configurar o ClickHouse MCP server, precisaremos converter o MCP server em endpoints da Open API.
Primeiro, vamos definir variáveis de ambiente que permitirão a conexão com o ClickHouse SQL Playground:
```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 da Open API:
```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 disso, você deverá ver um `1` ao lado do ícone da ferramenta na barra de chat:
Ao clicar no ícone da ferramenta, você poderá listar as ferramentas disponíveis:
## Configure o OpenAI
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:
## Converse com o ClickHouse MCP server usando o Open WebUI
Podemos então iniciar uma conversa, e o Open WebUI chamará o MCP server quando necessário: