> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# AnythingLLM에서 ClickHouse MCP 서버 사용하기
> 이 가이드에서는 Docker를 사용해 ClickHouse MCP 서버와 연동되도록 AnythingLLM을 설정하는 방법을 설명합니다.
export const Image = ({img, alt, size = "lg"}) => {
const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
return
;
};
> 이 가이드는 Docker를 사용하여 [AnythingLLM](https://anythingllm.com/)을 ClickHouse MCP 서버와 함께 설정하고
> ClickHouse 예시 데이터셋에 연결하는 방법을 설명합니다.
AnythingLLM과 MCP 서버를 실행하려면 Docker가 필요합니다. Docker를 설치하려면 다음 단계를 따르십시오.
1. [docker.com](https://www.docker.com/products/docker-desktop)을 방문합니다
2. 운영 체제에 맞는 Docker Desktop을 다운로드합니다
3. 운영 체제별 안내에 따라 Docker를 설치합니다
4. Docker Desktop을 열고 실행 중인지 확인합니다
자세한 내용은 [Docker 문서](https://docs.docker.com/get-docker/)를 참조하십시오.
다음 명령을 실행하여 AnythingLLM Docker image를 로컬 머신으로 가져옵니다.
```bash theme={null}
docker pull anythingllm/anythingllm
```
스토리지용 디렉터리를 만들고 환경 파일을 초기화합니다.
```bash theme={null}
export STORAGE_LOCATION=$PWD/anythingllm && \
mkdir -p $STORAGE_LOCATION && \
touch "$STORAGE_LOCATION/.env"
```
`plugins` 디렉터리를 생성합니다.
```bash theme={null}
mkdir -p "$STORAGE_LOCATION/plugins"
```
`plugins` 디렉터리에 `anythingllm_mcp_servers.json` 파일을 만들고 다음 내용을 추가합니다.
```json theme={null}
{
"mcpServers": {
"mcp-clickhouse": {
"command": "uv",
"args": [
"run",
"--with",
"mcp-clickhouse",
"--python",
"3.10",
"mcp-clickhouse"
],
"env": {
"CLICKHOUSE_HOST": "sql-clickhouse.clickhouse.com",
"CLICKHOUSE_USER": "demo",
"CLICKHOUSE_PASSWORD": ""
}
}
}
}
```
자체 데이터를 탐색하려는 경우
사용 중인 ClickHouse Cloud 서비스의 [host, username and password](/docs/ko/get-started/setup/cloud#connect-with-your-app)를
사용하면 됩니다.
다음 명령을 실행하여 AnythingLLM Docker 컨테이너를 시작합니다.
```bash theme={null}
docker run -p 3001:3001 \
--cap-add SYS_ADMIN \
-v ${STORAGE_LOCATION}:/app/server/storage \
-v ${STORAGE_LOCATION}/.env:/app/server/.env \
-e STORAGE_DIR="/app/server/storage" \
mintplexlabs/anythingllm
```
시작되면 브라우저에서 `http://localhost:3001`로 이동합니다.
사용할 모델을 선택하고 API Key를 입력합니다.
UI 왼쪽 하단의 도구 아이콘을 클릭합니다.
`Agent Skills`를 클릭한 다음 `MCP servers` 섹션을 확인합니다.
`Mcp ClickHouse`가 `On`으로 표시될 때까지 기다립니다
이제 채팅을 시작할 준비가 되었습니다.
채팅에서 MCP 서버를 사용할 수 있도록 하려면 대화의 첫 번째 메시지 앞에 `@agent`를 붙여야 합니다.