/setup-slack

description: "Lesson command"
duration: "約15分"
prerequisites: ["Slack ワークスペースの管理者権限"]
level: "beginner"
tags: ["setup", "slack", "api"]
nonInteractiveMode: incompatible

Slack API セットアップ

Step 0: セットアップ進捗の確認

**AIが自動実行する内容:** 1. `uv run python tools/setup_progress.py show --current setup-slack` を実行して進捗を表示 2. **このステップは任意です。** Slack連携を使わない場合はスキップできます 3. 既存トークンを自動検出:

• `.env` や credential store に `SLACK_USER_TOKEN` が存在するか確認
• 存在する場合、Slack API `auth.test` で有効性を確認。有効なら「Slack設定は完了しています。スキップしますか？」と確認

4. スキップする場合: `uv run python tools/setup_progress.py skip setup-slack --reason 'ユーザーがスキップ'` を実行

このセッションでやること

| 項目 | 内容 | |------|------| | ゴール | Slack Appを作成し、User Tokenを取得して安全に保存し、Slack検索・メッセージ取得機能を使えるようにする | | 所要時間 | 約15分 | | 前提条件 | Slackワークスペースの管理者権限（またはApp追加の許可）、ブラウザが使えること | | 操作レベル | CLIコマンド入力なし（すべてAIが自動実行 + GUI操作のみ） |

**このセッションの流れ:** 1. Slack App管理画面を開く（AIが自動でブラウザを起動） 2. 新しいSlack Appを作成する（画面上のボタンをクリック） 3. User Token Scopesを設定する（必要な権限を追加） 4. ワークスペースにインストールする（許可ボタンをクリック） 5. User Tokenを安全に保存する（credential_managerを使用） 6. 動作テスト（AIが自動実行）

> **ヒント**: AIの応答が途中で止まった場合は「続きを表示して」「止まってるよ」と入力すると再開します。

---

準備チェック

**AskQuestionの設定:**

{
  "title": "セッション開始前の確認",
  "questions": [{
    "id": "readiness",
    "prompt": "準備はできていますか？",
    "options": [
      {"id": "ready", "label": "準備OK！始めましょう"},
      {"id": "chrome", "label": "/chrome でブラウザ操作を自動化する"},
      {"id": "check_prereq", "label": "前提条件を確認したい"},
      {"id": "no_slack", "label": "Slackワークスペースを持っていない"},
      {"id": "different_lesson", "label": "別のレッスンに移動したい"}
    ]
  }]
}

(ready → Step 1へ) (chrome → Step 1 でブラウザを開いた後、「Chrome 統合で自動化する場合」セクションの手順で自動実行する) (check_prereq → 「Slackワークスペースにログイン済みで、App追加の権限があれば準備OKです。権限がない場合はワークスペース管理者に確認してください」と案内) (no_slack → 「Slackは無料で作成できます。https://slack.com/create からテスト用ワークスペースを作成してから、このセットアップを再開してください」と案内) (different_lesson → モジュール一覧を表示)

---

Step 1: Slack App管理画面を開く

**AIが実行すること:** 1. OSを自動判定する（Mac / Windows / Linux） 2. 以下のコマンドを実行してブラウザを自動起動する:

# Mac:
open https://api.slack.com/apps
# Windows:
start https://api.slack.com/apps
# Linux:
xdg-open https://api.slack.com/apps

**ブラウザが開いたら、以下のAskQuestionを表示:**

{
  "title": "Step 1: Slack App を作成する",
  "questions": [{
    "id": "app_create",
    "prompt": "ブラウザでSlack App管理画面が開きました。以下の手順で新しいAppを作成してください:\n\n1. 右上の「Create New App」ボタンをクリック\n2. 「From scratch」を選択\n3. App Name に「AIAgent Bootcamp」と入力\n4. Pick a workspace で自分のワークスペースを選択\n5. 「Create App」ボタンをクリック\n\nAppを作成できましたか？",
    "options": [
      {"id": "created", "label": "Appを作成しました！"},
      {"id": "browser_not_open", "label": "ブラウザが開かない"},
      {"id": "no_create_button", "label": "「Create New App」ボタンが見つからない"},
      {"id": "no_workspace", "label": "ワークスペースが表示されない"},
      {"id": "permission_error", "label": "権限エラーが表示された"}
    ]
  }]
}

(created → Step 2へ) (browser_not_open → 「ブラウザで直接このURLを開いてください: https://api.slack.com/apps」と案内) (no_create_button → 「Slackにログインしていない可能性があります。まず右上の 'Sign in' からSlackアカウントでログインしてください」と案内) (no_workspace → 「ワークスペースにログインした状態でページを再読み込みしてください。それでも表示されない場合は、新しいワークスペースを作成する必要があるかもしれません」と案内) (permission_error → 「ワークスペースの管理者がApp追加を制限している可能性があります。管理者に『AIAgent Bootcamp という Slack App を追加したい』と依頼してください。または、テスト用の無料ワークスペースを https://slack.com/create から作成してください」と案内)

---

Chrome 統合で自動化する場合（`/chrome` モード）

**前提条件:** Chrome に「Claude in Chrome」拡張機能（v1.0.36+）がインストール済みで、`claude --chrome` で起動しているか、セッション内で `/chrome` を実行済みであること。

**AIが Chrome 統合で自動実行する内容:** 1. ブラウザで https://api.slack.com/apps を開く 2. Chrome 統合を使って以下の操作を順番に実行する:

• 「Create New App」ボタンをクリック
• 「From scratch」を選択
• App Name に「AIAgent Bootcamp」と入力
• 「Pick a workspace」でワークスペースを選択
• 「Create App」をクリック
• 左メニューの「OAuth & Permissions」をクリック
• 「User Token Scopes」セクションで「Add an OAuth Scope」をクリックし、以下の4つを1つずつ追加: channels:history, channels:read, chat:write, users:read
• ページ上部の「Install to Workspace」をクリック
• 権限確認画面で「Allow」をクリック

3. User OAuth Token（xoxp-...）が表示されたことを確認したら、ユーザーに「トークンの横のCopyボタンをクリックしてコピーしてください」と案内する 4. Step 4 に進む

**注意:** トークンの値はブラウザ画面から読み取らないこと。ユーザーが手動でコピーする。

Chrome 統合が利用できない場合は、以下の Step 2〜3 の手順を手動で実行してください。

---

Step 2: User Token Scopes を設定する

**AskQuestionの設定:**

{
  "title": "Step 2: User Token Scopes を設定する",
  "questions": [{
    "id": "scope_setup",
    "prompt": "Appの設定画面が表示されています。以下の手順でUser Token Scopesを設定してください:\n\n1. 左メニューの「OAuth & Permissions」をクリック\n2. 下にスクロールして「Scopes」セクションを見つける\n3. 「User Token Scopes」の「Add an OAuth Scope」をクリック\n4. 以下の4つのスコープを1つずつ追加する:\n\n   - channels:history（チャンネルのメッセージを読み取る）\n   - channels:read（チャンネル情報を読み取る）\n   - chat:write（メッセージを送信する）\n   - users:read（ユーザー情報を読み取る）\n\n4つのスコープを追加できましたか？",
    "options": [
      {"id": "scopes_added", "label": "4つのスコープを追加しました！"},
      {"id": "cant_find_oauth", "label": "「OAuth & Permissions」が見つからない"},
      {"id": "cant_find_scopes", "label": "「User Token Scopes」が見つからない"},
      {"id": "scope_not_found", "label": "追加したいスコープが候補に出てこない"},
      {"id": "what_are_scopes", "label": "スコープって何？"}
    ]
  }]
}

(scopes_added → Step 3へ) (cant_find_oauth → 「左側のサイドバーメニューを確認してください。「Features」セクションの下に「OAuth & Permissions」があります。サイドバーが見えない場合は、ブラウザの画面を横に広げてみてください」と案内) (cant_find_scopes → 「ページを下にスクロールしてください。「OAuth Tokens for Your Workspace」セクションの下に「Scopes」セクションがあります。その中の「User Token Scopes」が対象です。※「Bot Token Scopes」ではないので注意してください」と案内) (scope_not_found → 「スコープ名を正確に入力してください。入力欄にテキストを打つと候補がフィルタされます。例えば 'channels' と入力すると channels:history や channels:read が候補に表示されます」と案内) (what_are_scopes → 「スコープとは、Appに許可する操作範囲のことです。今回追加する4つは:\n- channels:history = チャンネルの過去メッセージを読む権限\n- channels:read = チャンネル一覧を見る権限\n- chat:write = Appとしてメッセージを投稿する権限\n- users:read = ワークスペースのメンバー情報を見る権限\nこれらはSlack検索やタスク管理機能に必要な最小限の権限です」と説明)

---

Step 3: ワークスペースにインストールする

**AskQuestionの設定:**

{
  "title": "Step 3: ワークスペースにインストール",
  "questions": [{
    "id": "install_app",
    "prompt": "スコープの設定が完了したら、Appをワークスペースにインストールします:\n\n1. ページを上にスクロールして「OAuth Tokens for Your Workspace」セクションを見つける\n2. 「Install to Workspace」ボタンをクリック\n   （ボタンが「Reinstall