ClickHouse MCP server を使って SlackBot エージェントを構築する方法

​

Slack App を作成する

1. slack.com/apps にアクセスし、Create New App をクリックします。
2. From scratch を選択し、アプリに名前を付けます。
3. 使用する Slack ワークスペースを選択します。

​

アプリをワークスペースにインストールする

​

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) を追加する

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

​

ボットを使う

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.