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/docsPara usar esses endpoints com o Open WebUI, precisamos ir até as configurações:Clique em Tools:Adicione 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:
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:Vamos adicionar o endpoint e nossa chave da OpenAI:Os modelos da OpenAI ficarão disponíveis no menu superior:
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:
Última modificação em 3 de julho de 2026