ClickHouse MCP 서버를 사용해 SlackBot 에이전트를 구축하는 방법

이 가이드에서는 SlackBot 에이전트를 구축하는 방법을 알아봅니다. 이 봇을 사용하면 자연어로 Slack에서 직접 ClickHouse 데이터에 관해 질문할 수 있습니다. 이 봇은 ClickHouse MCP 서버와 PydanticAI를 사용합니다.

예시 프로젝트이 예시의 코드는 examples 리포지토리에서 확인할 수 있습니다.

사전 요구 사항

uv이 설치되어 있어야 합니다
Slack 워크스페이스에 접근할 수 있어야 합니다
Anthropic API Key 또는 다른 LLM 제공업체의 API Key가 필요합니다

Slack App 만들기

slack.com/apps로 이동해 Create New App을 클릭합니다.
From scratch 옵션을 선택한 뒤 앱 이름을 입력합니다.
Slack 워크스페이스를 선택합니다.

워크스페이스에 앱 설치하기

다음으로, 이전 단계에서 만든 앱을 워크스페이스에 추가해야 합니다. Slack 문서의 “Add apps to your Slack workspace” 안내를 따르면 됩니다.

Slack 앱 설정 구성하기

App Home으로 이동합니다
- Show Tabs → Messages Tab에서 Allow users to send Slash commands and messages from the messages tab을 활성화합니다
- Socket Mode로 이동합니다
  - Socket Mode를 활성화합니다
  - 환경 변수 SLACK_APP_TOKEN에 사용할 Socket Mode Handler를 기록해 둡니다
- OAuth & Permissions로 이동합니다
  - 다음 Bot Token Scopes를 추가합니다:
    - app_mentions:read
    - assistant:write
    - chat:write
    - im:history
    - im:read
    - im:write
    - channels:history
  - 앱을 워크스페이스에 설치한 뒤 환경 변수 SLACK_BOT_TOKEN에 사용할 Bot User OAuth Token을 기록해 둡니다.
- Event Subscriptions로 이동합니다
  - Events를 활성화합니다
  - Subscribe to bot events 아래에 다음 항목을 추가합니다:
    - app_mention
    - assistant_thread_started
    - message:im
  - Save Changes

환경 변수 추가하기 (.env)

다음 환경 변수를 포함하는 .env 파일을 프로젝트 루트에 생성합니다. 이렇게 하면 앱이 ClickHouse의 SQL playground에 연결할 수 있습니다.

SLACK_BOT_TOKEN=your-slack-bot-token
SLACK_APP_TOKEN=your-slack-app-level-token
ANTHROPIC_API_KEY=your-anthropic-api-key
CLICKHOUSE_HOST=sql-clickhouse.clickhouse.com
CLICKHOUSE_PORT=8443
CLICKHOUSE_USER=demo
CLICKHOUSE_PASSWORD=
CLICKHOUSE_SECURE=true

원한다면 ClickHouse 관련 변수를 조정해 자체 ClickHouse 서버나 Cloud 인스턴스를 사용할 수도 있습니다.

봇 사용하기

봇 시작하기:
uv run main.py
Slack에서:
- 채널에서 봇을 멘션합니다: @yourbot Who are the top contributors to the ClickHouse git repo?
- 스레드에서 멘션으로 답글합니다: @yourbot how many contributions did these users make last week?
- 봇에 DM을 보냅니다: Show me all tables in the demo database.

해당하는 경우 봇은 현재 스레드의 이전 메시지를 모두 문맥으로 활용해 스레드에 답글합니다.스레드 문맥: 스레드에 답글할 때 봇은 이전 메시지 전체(현재 메시지 제외)를 불러와 AI의 문맥에 포함합니다.도구 사용: 봇은 MCP를 통해 사용할 수 있는 도구만 사용하며(예: schema 탐색, SQL 실행), 사용한 SQL과 답변을 찾은 방법의 요약을 항상 표시합니다.

​사전 요구 사항

사전 요구 사항