Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs
49.6kGet Started

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

View as MarkdownEdit this pageReport an issueSet up docs MCP

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

사전 요구 사항

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

Slack App 만들기

  1. slack.com/apps로 이동해 Create New App을 클릭합니다.
  2. From scratch 옵션을 선택한 뒤 앱 이름을 입력합니다.
  3. 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

[object Object]

다음 환경 변수를 포함하는 .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 인스턴스를 사용할 수도 있습니다.

봇 사용하기

  1. 봇 시작하기:

    uv run main.py

  2. 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과 답변을 찾은 방법의 요약을 항상 표시합니다.

Navigation