開発作業に没頭していると、どうしてもSlackでの進捗報告がおろそかになりがちです。コードを書く手をとめ、ブラウザやアプリを開いて今の状況を文章にする作業は、意外と精神的なコストがかかるものです。
Claude Codeと「Slack MCP（Model Context Protocol）」を連携させれば、ターミナルから一歩も出ずにAIがあなたの代わりに状況を報告してくれます。設定の手順から、チームに喜ばれる質の高い報告を自動化するコツまで、エンジニアが今日から使える実践的な方法を詳しく解説します。
Slack MCPで進捗報告を行うメリット
開発の手を止めてSlackを開く手間は、想像以上に集中力を削ぐ原因になります。Claude CodeとSlackを直接つなぐことで、この「小さな中断」をゼロにできるだけでなく、AIならではの正確なログ活用が可能になります。
この章では、連携によって得られる具体的なメリットを3つの視点で紹介します。画面切り替えのストレス解消、作業履歴に基づいた正確な要約、そして報告業務そのものの自動化が、どのようにあなたの開発リズムを守るのかを確認していきましょう。
ブラウザやアプリへの画面切り替えをゼロにできる
エンジニアにとって、ターミナルとエディタは「聖域」のような場所です。そこから離れてSlackの入力欄に向かうのは、一種のコンテキストスイッチを引き起こします。
一度Slackを開いてしまうと、他の通知が目に入り、本来の作業に戻るのが遅れてしまった経験はありませんか？
Slack MCPを使えば、ターミナル上で「今の作業を報告して」と打つだけで済みます。マウスに手を伸ばす必要すらなく、開発の熱量を保ったままコミュニケーションが完結します。このリズムの維持こそが、高い生産性を支える土台となるのです。
作業履歴に基づいた正確な進捗を要約して送れる
人間が報告を書く際、つい「何を修正したか」をド忘れしてしまうことがあります。しかしClaude Codeは、直前まであなたがどのファイルをいじり、どんなテストを回したかをすべて把握しています。
AIは事実に基づいた正確なログを抽出し、誰が見てもわかりやすい形に整理してくれます。
「何をしていたっけ？」と記憶を掘り返す無駄な時間がなくなるため、報告の正確性が飛躍的に向上します。
- 変更ファイルを列挙
- エラー解決を記録
- テスト結果を添付
- 論理的な要約作成
このように、AIだからこそできる「漏れのない報告」は、チームメンバーからの信頼にもつながります。
報告のタイミングをAIに管理させることが可能
「この機能の実装が終わったら報告しよう」と思っていても、次のバグ修正に夢中になり、報告のタイミングを逃してしまうのはよくある話です。
Claude Codeに自律的な動作を許可していれば、特定のタスクが完了した瞬間に「今の状況を報告しましょうか？」とAI側から提案させることができます。
報告をタスクの一部として組み込むことで、チーム内の情報共有が滞る心配がなくなります。
自分から言い出す手間が省けるため、報告作業に対する心理的なハードルが劇的に下がります。
「報告しなきゃ」という強迫観念から解放され、目の前のコードを磨き上げることに集中できる環境が手に入ります。
| 項目 | 手動での報告 | Claude Code連携 |
| 画面操作 | アプリの切り替え | ターミナル内のみ |
| 要約の作成 | 記憶を頼りに執筆 | 実行ログから自動生成 |
| 所要時間 | 3〜5分程度 | 10秒程度 |
準備：Slack MCPをClaude Codeに導入する手順
連携を開始するには、あなたのClaude CodeがSlackという「外部ツール」を認識できるように設定する必要があります。設定は一度済ませてしまえば、あとは日常のコマンド操作の一部として報告が組み込まれます。
この章では、導入に必要な環境の確認から、MCPサーバーの準備、設定ファイルへの反映までをステップバイステップで説明します。全体の流れを把握して、スムーズに準備を整えましょう。
必要な環境とツールのバージョンを確認する
Claude CodeでMCPを動かすには、Node.jsのランタイムが適切にインストールされている必要があります。
まずは、お使いの環境が最新の仕様を満たしているか確認しましょう。
Node.jsは18系以上のバージョンが推奨されます。また、Claude Code自体も最新版にアップデートしておくことで、接続エラーを防ぐことができます。
- Node.jsの確認
- Claudeの更新
- npmの動作確認
- ネット接続の確保
これらが揃っていないと、途中でコマンドが通らずに立ち往生してしまいます。
土台となる環境をしっかりと固めることが、安定した連携への近道です。
MCPサーバーをインストールして起動できる状態にする
Slackと通信するためには、中継役となる「Slack MCPサーバー」というプログラムを用意します。これはオープンソースで公開されているパッケージを利用するのが一般的です。
以下のコマンドをターミナルで実行して、必要なサーバー機能を導入します。
グローバルにインストールするか、特定のプロジェクト内のみで管理するかは、自分の開発スタイルに合わせて選択してください。
# Slack MCPサーバーの導入例
npm install -g @modelcontextprotocol/server-slack
インストールが完了したら、実際にプログラムが呼び出せる状態にあるかを確認します。
AIはこのプログラムを呼び出すことで、はじめてSlackのチャンネルへメッセージを書き込めるようになります。
設定ファイルを編集して連携のパスを通す
サーバーが用意できたら、次はClaude Codeに対して「Slackを使うときはこのプログラムを使ってね」と教え込みます。
通常、Claude Codeの設定ファイル（json形式）に、MCPサーバーの設定を書き込みます。
ここに後述するAPIトークンや、サーバーの実行パスを正しく記述することで、AIとの対話中にSlack機能が有効になります。
設定ファイルの場所はOSによって異なりますが、正しいパスに配置しないと読み込まれません。
一度設定してしまえば、再起動後も自動で連携が有効になるため、最初の設定だけは丁寧に行いましょう。
Slack APIでトークンを取得する方法
MCPを動かすための「鍵」となるのが、Slack APIから発行されるトークンです。専用のSlackアプリを作成し、Claude Codeがメッセージを書き込める権限を与えてあげましょう。
この章では、Slackの管理画面で行う下準備について解説します。少し手順は多いですが、一つひとつの操作は簡単です。APIの仕組みに詳しくなくても、順番に進めていけば確実にトークンを手に入れることができます。
専用のSlack Appを新規作成する
まずは、Slack APIの公式サイト（api.slack.com）にアクセスし、新しいアプリを作成します。
アプリの名前は「Claude-Reporter」など、自分で判別しやすいものを付けてください。
作成場所として、自分の開発チームが使っているワークスペースを指定します。
名前が決まったら、アプリの基本設定を保存します。
これが、AIがSlackの世界にアクセスするための「身分証」になります。
自分で作成したアプリを使うことで、セキュリティを自分自身でコントロールできる安心感があります。
メッセージ送信に必要な権限を追加する
アプリを作っただけでは、AIは何もできません。どの範囲まで操作を許すかという「スコープ」を設定する必要があります。
「OAuth & Permissions」の項目から、以下の権限を追加してください。
最低限、メッセージを投稿するための機能と、チャンネル情報を読み取る機能があれば進捗報告には十分です。
- chat:write
- channels:read
- groups:read
- users:read
不必要に強い権限を与えないことが、セキュリティを守るコツです。
進捗報告に必要な範囲だけに絞って許可を与えるようにしましょう。
これにより、万が一の誤操作によるリスクを最小限に抑えることができます。
チャンネルへの参加とBotトークンのコピーを行う
権限の設定が終わったら、アプリをワークスペースにインストールします。
インストールが完了すると、xoxb- から始まる「Bot User OAuth Token」が表示されます。これが後で設定ファイルに書き込む非常に大切な文字列です。
このトークンをコピーし、安全な場所にメモしておいてください。
また、報告を送りたいSlackチャンネルに、作成したアプリ（Bot）を招待することを忘れないでください。
Slackの画面で /invite @アプリ名 と打つだけです。
招待されていないチャンネルには、AIは勝手にメッセージを送ることができません。
報告の「届け先」をしっかりと準備してあげましょう。
Claude CodeにMCP設定を反映させる
手に入れたトークンを使って、いよいよClaude Codeの設定を書き換えます。ここでは、AIが迷わずSlackサーバーを見つけられるように、情報を正しく指定することが重要です。
この章では、設定ファイルの具体的な書きかたと、接続テストの方法について解説します。文字一つ、スペース一つのミスで動かなくなることもあるため、慎重に進めていきましょう。
設定ファイルにSlackサーバー情報を追記する
Claude Codeの設定ファイルを開き、mcpServers という項目にSlackの設定を書き足します。
APIトークンは環境変数として渡すのが最も安全です。
直接ファイルに書き込むと、誤ってGitHubなどの公開リポジトリにアップしてしまった際に、他人にSlackを操作される恐れがあります。
{
"mcpServers": {
"slack": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-slack"],
"env": {
"SLACK_BOT_TOKEN": "xoxb-your-token-here"
}
}
}
}
このように構造化して記述することで、AIは起動時にSlack連携機能があることを認識します。
一度書けば、次からはAIに「Slackで送って」と言うだけで伝わるようになります。
正しく接続できているかテストコマンドで確認する
設定を保存したら、Claude Codeを立ち上げ直してテストを行いましょう。
いきなり本番のチャンネルに送るのではなく、自分一人のテスト用チャンネルを作って試すのがおすすめです。
AIに「Slackのチャンネル一覧を表示して」と頼んでみてください。
設定が成功していれば、参加しているチャンネルの名前がズラリと返ってきます。
もし「ツールが見つかりません」といったエラーが出る場合は、設定ファイルのパスや、サーバーのインストール状態を再確認しましょう。
最初の「疎通確認」が、その後の運用をスムーズにするための鍵となります。
複数のプロジェクトで設定を共有・分離する方法
仕事用と趣味用のワークスペースを分けている場合、設定もそれぞれ分ける必要があります。
プロジェクトごとのディレクトリに個別の設定ファイルを置くことで、送り先のSlackアカウントを自動で切り替えることができます。
共通の設定はホームディレクトリに、特有の設定はプロジェクトルートに置くといった使い分けを検討しましょう。
- グローバル設定
- プロジェクト別設定
- 環境ごとの分離
- トークンの使い分け
このように情報を整理しておくことで、「趣味の開発ログを誤って会社のSlackに流してしまった」という事故を防げます。
AIに正しい「コンテキスト（文脈）」を与えることは、開発者としての責任でもあります。
実践：ターミナルから状況を伝える指示の出し方
設定が終われば、あとはClaude Codeに言葉で頼むだけです。日常の会話と同じように指示を出すことで、AIが適切なチャンネルへメッセージを飛ばしてくれます。
この章では、実際にどのようなプロンプト（指示文）を出せば思い通りに報告できるのか、具体的な例を挙げて紹介します。効率を最大化する「指示の流儀」を身につけましょう。
特定のチャンネルへ直接投稿を依頼する
AIに対して、どのチャンネルに報告してほしいかを明示的に伝えます。
「 #dev-updates チャンネルに、今の作業が終わったことを報告して」
このようにチャンネル名を添えるだけで、AIは自動で目的の場所を探し出し、メッセージを書き込みます。
チャンネル名が日本語の場合でも、現在のAIは正確に理解してくれます。
ただし、複数のワークスペースに参加している場合は、チャンネルID（Cから始まる文字列）で指定すると、より確実に届けることができます。
「どこに送るか」を明確にすることが、AIへの指示の基本です。
メンションやスレッドを活用して報告する
ただ全体に流すだけでなく、特定の誰かに通知を送ったり、既存のスレッドに返信したりすることも可能です。
「リーダーの @Sato さん宛に、バグ修正が終わったことをメンションして送って」
「さっきの進捗スレッドに、詳細を追記して」
このように、Slackの機能を活用した指示も思いのままです。
わざわざSlackを開いてスレッドを探す手間が省けるため、コミュニケーションのスピードが劇的に上がります。
ターミナルの中から、Slackの対話の流れを自在に操ることができるのです。
今の作業状況を要約して「進捗報告」として送る
これが最も強力な使いかたです。具体的な変更内容を自分で書く必要はありません。
「今日やった作業をログから読み取って、簡潔な進捗報告として #daily-report に送って」
この指示一発で、AIはこれまでの履歴をスキャンし、整理された報告書を作成します。
自分が何に苦戦し、どう解決したかというプロセスまで含めて要約してくれるため、自分一人で書くよりも情報量の多い、質の高い報告になります。
毎日の「日報」の時間をゼロにできる。
これこそが、エンジニアがAIエージェントを導入する最大のメリットと言えるでしょう。
報告の質を上げる！作業ログを自動要約させるコツ
単に「終わりました」と送るだけなら簡単ですが、チームへの共有としては物足りないこともあります。Claude Codeの強みを活かし、人間が書くよりも具体的で分かりやすい報告を作成させましょう。
この章では、報告の内容をブラッシュアップするための具体的なテクニックを紹介します。AIへの「一言」の添えかたで、報告のクオリティは驚くほど変わります。
編集したファイル名や変更点をリストアップさせる
「何を変えたか」が明確でない報告は、レビュー担当者を困らせてしまいます。
AIに対して、「修正したファイル名とその理由を箇条書きにして」と指示を加えましょう。
AIはファイルシステムを直接読み取れるため、正確なファイルパスや修正行数を、間違いなく列挙してくれます。
「あっちのファイルを直し忘れていた」といったミスも、この過程で発見できることがあります。
正確な事実に基づいた報告は、チーム全体のデバッグ効率も高めてくれます。
機械的な作業はAIに、論理的な判断は人間に。この役割分担を徹底しましょう。
次のタスクや懸念点まで含めてまとめさせる
進捗報告で本当に知りたいのは、「これからどうなるか」という未来の話です。
「今の進捗を報告しつつ、次にやるべきことと、今の懸念点をまとめて」
このように指示を出してみてください。
AIはコードの現状から「次はテストコードを書く必要がありますね」といった推測を行ってくれます。
また、ロジックが複雑になった箇所を「保守性が下がる恐れがある」と指摘してくれることもあります。
未来の課題を先回りして共有することで、プロジェクトの炎上を未然に防ぐことができます。
- 次のアクション提示
- リスクの早期共有
- 技術的負債の指摘
- 残タスクの整理
チームの雰囲気に合わせた言葉遣いに調整する
AIの言葉は、時に丁寧すぎて固くなりがちです。チームの文化に合わせて、口調を微調整させましょう。
「もう少しフランクな口調で報告して」
「ビジネスライクに、結論から述べて」
このような指示で、報告文のトーンを自由に変えることができます。
絵文字を多用したり、英語で報告させたりすることも自由自在です。
自分自身のキャラクターに合った報告をAIに行わせることで、チーム内のコミュニケーションがより円滑になります。
「誰が書いたか」を意識させないほど自然な報告を目指しましょう。
権限やセキュリティでつまずかないための注意点
便利なツールですが、情報の扱いには細心の注意が必要です。特に社内の大切なコードや情報を扱う場合、どの範囲までAIにSlack操作を許すかを決めておく必要があります。
この章では、安全に運用を続けるための「守りの設定」について解説します。便利さとセキュリティのバランスをどう取るべきか、エンジニアとして押さえておくべきポイントを確認してください。
APIトークンを公開リポジトリに含めない
最も基本的なルールですが、最も事故が起きやすいポイントでもあります。
.claude-code-config.json などの設定ファイルを、そのままGitでプッシュしていませんか？
もしその中にAPIトークンが直書きされていたら、リポジトリを閲覧できる全員にSlackの操作権限を渡しているのと同じです。
トークンは必ず環境変数から読み込むように設定するか、設定ファイル自体を .gitignore で除外してください。
セキュリティの穴は、往々にして「ちょっとした油断」から生まれます。
鍵の管理を徹底すること。これがプロフェッショナルなAI使いの絶対条件です。
AIが読み取れるチャンネルの範囲を限定する
Slack MCPの設定によっては、AIが過去のメッセージをすべて読み取れるようになってしまいます。
機密性の高いチャンネルや、プライベートなやり取りが含まれるチャンネルの情報をAIに読み取らせるのはリスクがあります。
Botを招待するチャンネルを最小限に絞り、AIの「視界」を適切にコントロールしましょう。
- 公開チャンネルのみ
- 特定のプロジェクト用
- DMへのアクセス禁止
- ログの保存制限
AIに「すべて」を見せる必要はありません。
必要最小限のデータで最高の成果を出させるのが、スマートなエンジニアのありかたです。
送信前に人間が内容を確認するワークフローを作る
AIにすべてを丸投げし、確認せずに送信させるのは少し危険です。
「送信前に、一度メッセージの内容を表示して確認させて」
このプロンプトをルール化しておきましょう。
AIが意図しない解釈をしたり、間違った情報を報告したりする可能性はゼロではありません。
最後の一押しを人間が「OK」と判断することで、情報の正確性を100%に近づけることができます。
AIは優秀なアシスタントですが、最終的な責任を負うのは常に人間です。
確認の手間を惜しまないことが、信頼される報告を生む秘訣です。
連携がうまくいかない時のトラブルシューティング
「コマンドを打ってもSlackに届かない」といったトラブルは、初期設定時によく起こります。落ち着いて原因を切り分けられるように、チェックすべき項目を整理しました。
この章では、エラーに直面したときに、どこを最初に見直すべきかのチェックリストを提示します。問題を自力で解決する力（デバッグ能力）を身につけて、ツールを使いこなしましょう。
トークンの有効期限や権限設定を見直す
最も多い原因は、トークンの権限不足です。
Slackのアプリ管理画面で、必要なスコープ（chat:writeなど）を付け忘れていませんか？
設定を変更したあとは、必ず「Reinstall to Workspace（ワークスペースに再インストール）」を行う必要があります。
これを忘れると、新しい権限が反映されず、AIは「権限がありません」と言って止まってしまいます。
設定を変えたら再起動・再インストール。
この基本サイクルを繰り返すことで、大抵の接続問題は解決します。
チャンネルIDが正しく指定されているか確認する
チャンネル名が正しくても、内部の「チャンネルID」が一致していないとメッセージは迷子になります。
Slackのチャンネル名を右クリックし、「詳細を表示」の画面下部にある C から始まるIDを確認してください。
AIへの指示がうまくいかないときは、名前ではなくIDを使って指示を出してみましょう。
- IDの打ち間違い確認
- 公開/非公開の判別
- Botの参加状況確認
- ワークスペースの一致
意外と「Botがチャンネルに招待されていなかっただけ」という単純な原因も多いものです。
まずは足元の初歩的なミスを疑ってみることが、早い解決につながります。
MCPサーバーのプロセスが正常に動いているか調べる
設定ファイルは正しいのに動かない場合、中継役のサーバープログラム自体に問題があるかもしれません。
ターミナルで単体でサーバーを起動してみて、エラーが出ないか確認しましょう。
Node.jsのバージョン不整合や、依存ライブラリの不足が原因で、裏側でクラッシュしているケースがあります。
ログを詳細に出力させる設定にして、どこで通信が途切れているかを特定します。
インフラの問題さえ解決してしまえば、あとはAIがスムーズに仕事をこなしてくれます。
「裏側で何が起きているか」を把握する姿勢を持ちましょう。
まとめ：報告を自動化して開発効率を最大化しよう
Slack MCPとClaude Codeを連携させることで、エンジニアを苦しめる「報告業務」の負担は劇的に軽くなります。今回のポイントを1〜2行で振り返ると以下の通りです。
- 設定のコツ：Slack APIで適切な権限を持つトークンを発行し、Claude Codeの設定ファイルでパスを通す。
- 運用のコツ：送信前の人間による確認フローを入れつつ、AIに作業ログからの自動要約を任せる。
進捗報告を自動化すれば、その分だけ新しいコードを書く時間や、アーキテクチャを熟考する時間を増やすことができます。道具を賢く使いこなし、本来のクリエイティブな仕事に集中できる環境を整えましょう。
