4分で読了

Slack連携オンボーディングガイド

新しいプロジェクトをGIIPの対話型Slackボット（giipclaude）に接続するための全手順を7ステップで案内します。各ステップを順番に進めると、最後にSlackチャンネルで@giipclaudeをメンションしてgiip issueを登録・照会できるようになります。

1. プロジェクト（csn）の確認

Slackボットを接続するには、まずこのボットが属するGIIPプロジェクト（csn）が必要です。すでに登録・オンボーディング済みの会社があれば、このステップは飛ばしてステップ2へ進んでください。新規登録が必要な場合は:

➡️ 会員登録ガイド を先に進めてください。

次のステップ: 2. サービスグループの作成

2. サービスグループの作成

GIIPでは、SK（Secret Key）は「サービスグループ」単位で発行されます。このSlackボット専用のグループがまだなければ、新規に作成してください。

プロジェクトグループ一覧 ページへ移動します。
[+ グループ追加] ボタンで新しいグループを作成します（例: slack-bot のように用途がわかる名前を推奨）。

次のステップ: 3. SK（Secret Key）の発行

3. SK（Secret Key）の発行

同じ プロジェクトグループ一覧 ページで、先ほど作成した（または既存の）グループ横の [Generate Secret Key] ボタンをクリックします。発行されたSK文字列は安全な場所にコピーしておいてください — ステップ7でそのまま使用します。

次のステップ: 4. giip-fde-agentのローカルインストール

4. giip-fde-agentのローカルインストール

Slackボットは、皆さんのPC（またはボットを常時起動させておくサーバー）上でローカルに実行されます。正本のテンプレートリポジトリをクローンしてインストールしてください。

git clone https://github.com/LowyShin/giip-fde-agent.git
cd giip-fde-agent/slack-bot
npm install

次のステップ: 5. Slack Appの作成と連携

5. Slack Appの作成と連携

slack-bot/SLACK_APP_SETUP.md（リポジトリ内に既にあります）の全手順に従ってください。要点のみまとめると:

api.slack.com/apps → Create New App → From scratch
OAuth & Permissions → Bot Token Scopesを追加: chat:write, app_mentions:read, channels:history, channels:read, groups:history, groups:read, im:history, im:read, im:write（任意: users:read）
Socket Mode を有効化 → App-Level Tokenを発行（connections:write スコープ） → xapp-... をコピー
Event Subscriptions を有効化 → app_mention, message.im, message.channels, message.groups を購読
Install to Workspace → Bot User OAuth Token（xoxb-...）をコピー
slack-bot/.env.example を .env にコピーし、SLACK_BOT_TOKEN（xoxb-）、SLACK_APP_TOKEN（xapp-）、WORKSPACE_DIR を入力
node index.js（または pm2 start index.js --name giipclaude-bot）で実行

問題が発生した場合は、SLACK_APP_SETUP.md 下部の「Troubleshooting」表をまず確認してください。

次のステップ: 6. Slackチャンネルの準備

6. Slackチャンネルの準備

ボットが応答するSlackチャンネルを新規作成するか、既存のチャンネルを決めます。
そのチャンネルで /invite @<ボット名> によりボットを招待します。
チャンネルIDを確認します: チャンネル名を右クリック → チャンネル詳細を表示 → 下部の C0XXXXXXXXX 形式のID。

次のステップ: 7. GIIP連携の仕上げ

7. GIIP連携の仕上げ

ボットがSlack上で生きていることを確認したら、そのチャンネルをステップ3で発行したSK/csnと接続します。ボットへDMで（または連携するチャンネルで）以下のコマンドを順番に入力してください。

giip account set <login_id> <SK> <csn>
giip channel set <プロジェクト名> <チャンネルID>
giip project set <プロジェクト名> <csn>

<login_id>: このアカウントを識別するメールアドレスなど（表示用、例: you@example.com）
<SK>: ステップ3で発行された値
<csn>: ステップ1で確認したプロジェクト番号
<プロジェクト名>: 自由に決める小文字の識別子（giip issue登録時にこの名前でルーティングされます）

すべてのコマンドが成功すると、そのチャンネルで @<ボット名> issue登録 <内容> のように話しかけて、すぐにgiip issueを登録できます。

⚠️ 新規プロジェクトの場合: giip project set は自動的にボットのDBアクセス権限（tUserPerCorp）を付与しようとしますが、完全に新規のcsnはセキュリティゲートによりこの自動付与が失敗します（想定された動作です）。この場合、コマンド応答に警告が表示され、csn 47に対応フォローアップのgiip issueが自動登録されます — GIIP管理者がそのissueを確認し、giipdb/data/seed_tUserPerCorp_botuser.sql に1行追加して手動で権限を付与する必要があります。このステップのみ管理者の介入が必要で、それ以外はすべてセルフサービスです。

バージョン: 2.0（giip-fde-agentベースの対話型ボットオンボーディングとして全面改訂） 最終更新: 2026-09-10 ソースファイル: giipv3/public/help/slack-bot-setup.ja.md