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

Instalar 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 config do servidor MCP para usar um gerenciador de pacotes alternativo.
2

Iniciar o Open WebUI

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

Configurar o servidor MCP do ClickHouse

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:
Em seguida, podemos executar mcpo para criar os endpoints OpenAPI:
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 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:
4

Configurar 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

Conversar com o servidor MCP do ClickHouse no Open WebUI

Em seguida, podemos iniciar uma conversa, e o Open WebUI acionará o servidor MCP se necessário:
Última modificação em 23 de julho de 2026