Skip to main content
Este guia explica como configurar o Open WebUI com um ClickHouse MCP server e conectá-lo aos conjuntos de dados de exemplo do ClickHouse.
1

​
Instale o uv

Você precisará instalar o 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.
2

​
Inicie o Open WebUI

Para iniciar o Open WebUI, execute o seguinte comando:
Acesse http://localhost:8080/ para ver a UI.
3

​
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:
Em seguida, podemos executar mcpo para criar os endpoints da Open API:
Você pode ver uma lista dos endpoints criados acessando http://localhost:8000/docs
endpoints da Open API
Para usar esses endpoints com o Open WebUI, precisamos ir até as configurações:
configurações do Open WebUI
Clique em Tools:
ferramentas do Open WebUI
Adicione http://localhost:8000 como URL da ferramenta:
ferramenta do Open WebUI
Depois disso, você deverá ver um 1 ao lado do ícone da ferramenta na barra de chat:
ferramentas disponíveis no Open WebUI
Ao clicar no ícone da ferramenta, você poderá listar as ferramentas disponíveis:
lista de ferramentas do Open WebUI
4

​
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:
conexões do Open WebUI
Vamos adicionar o endpoint e nossa chave da OpenAI:
Open WebUI - Adicionar OpenAI como conexão
Os modelos da OpenAI ficarão disponíveis no menu superior:
Open WebUI - Modelos
5

​
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:
Open WebUI - Conversar com o ClickHouse MCP server
Última modificação em 12 de junho de 2026