> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-86180b7b.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Open WebUI 및 ClickHouse Cloud로 ClickHouse MCP 서버 설정하기
> 이 가이드에서는 Docker를 사용해 ClickHouse MCP 서버와 Open WebUI를 설정하는 방법을 설명합니다.
export const Image = ({img, alt, size}) => {
return
;
};
# Open WebUI에서 ClickHouse MCP 서버 사용하기
> 이 가이드에서는 [Open WebUI](https://github.com/open-webui/open-webui)를 ClickHouse MCP 서버와 함께 설정하고
> ClickHouse 예시 데이터셋에 연결하는 방법을 설명합니다.
## uv 설치
이 가이드의 지침을 따르려면 [uv](https://docs.astral.sh/uv/)를 설치해야 합니다.
uv를 사용하지 않으려면 다른 패키지 관리자를 사용하도록 MCP 서버 구성을 변경해야 합니다.
## Open WebUI 실행
Open WebUI를 실행하려면 다음 명령을 실행하십시오:
```bash theme={null}
uv run --with open-webui open-webui serve
```
UI를 보려면 [http://localhost:8080/](http://localhost:8080/) 로 이동하십시오.
## ClickHouse MCP 서버 구성
ClickHouse MCP 서버를 설정하려면 MCP 서버를 Open API 엔드포인트로 변환해야 합니다.
먼저 ClickHouse SQL Playground에 연결할 수 있도록 환경 변수를 설정하겠습니다:
```bash theme={null}
export CLICKHOUSE_HOST="sql-clickhouse.clickhouse.com"
export CLICKHOUSE_USER="demo"
export CLICKHOUSE_PASSWORD=""
```
그런 다음 `mcpo`를 실행해 Open API 엔드포인트를 생성할 수 있습니다:
```bash theme={null}
uvx mcpo --port 8000 -- uv run --with mcp-clickhouse --python 3.10 mcp-clickhouse
```
[http://localhost:8000/docs](http://localhost:8000/docs) 로 이동하면 생성된 엔드포인트 목록을 확인할 수 있습니다.
이 엔드포인트를 Open WebUI에서 사용하려면 설정으로 이동해야 합니다:
`Tools`를 클릭합니다:
도구 URL로 [http://localhost:8000](http://localhost:8000) 을 추가합니다:
이 작업을 완료하면 채팅 바의 도구 아이콘 옆에 `1`이 표시됩니다:
도구 아이콘을 클릭하면 사용 가능한 도구 목록을 볼 수 있습니다:
## OpenAI 구성
기본적으로 Open WebUI는 Ollama 모델과 함께 작동하지만, OpenAI 호환 엔드포인트도 추가할 수 있습니다.
이 설정은 설정 메뉴에서 구성하며, 이번에는 `Connections` 탭을 클릭해야 합니다:
엔드포인트와 OpenAI 키를 추가하겠습니다:
그러면 상단 메뉴에서 OpenAI 모델을 사용할 수 있습니다:
## Open WebUI로 ClickHouse MCP 서버와 대화하기
이제 대화를 시작할 수 있으며, 필요하면 Open WebUI가 MCP 서버를 호출합니다: