slack-task-mcp: Instructions file for Claude Code

CLAUDE.md - Slack Task MCP Server

このプロジェクトはClaude Code / Claude Desktop用のSlackタスク管理MCPサーバーです。

コンセプト

解決する課題: Slackでメンションがたまると、どこから手を付けていいか迷い、難しい依頼は諦めてしまう

ターゲット: ADHDの特性を持つユーザー

提供する価値: メンションから着手までの摩擦をゼロに近づける

メンション来た
    ↓
「何求められてる？」が曖昧で固まる → 目的の明確化
    ↓
「何聞けばいい？」がわからない   → 不明点の洗い出し + 確認メッセージ案
    ↓
「どう返せばいい？」で時間かかる → 返信メッセージの添削・構造化
    ↓
「次何する？」で迷う            → ネクストアクション提示

利用可能なMCPツール

get_slack_thread

SlackスレッドのURLからメッセージを取得し、文脈DBとして保持します。

使用例: このスレッドを読んで https://xxx.slack.com/archives/C12345678/p1234567890

analyze_request

スレッドの依頼を分析し、目的・不明点・確認メッセージ案・ネクストアクションを生成します。

使用例: この依頼を分析して

draft_reply

返信の下書きを添削し、ロジカルに構造化します。

使用例: この返信を添削して「〇〇の件、確認しました...」

save_task

タスクを保存します。スレッドの文脈情報も一緒に保存されます。

list_tasks

アクティブなタスクの一覧を表示します（アーカイブ済みは非表示）。

search_tasks

キーワードや日付でタスクを検索します（アーカイブ済みタスクも含む）。

使用例:
- 過去の対応を検索: 「レポート」で検索して
- 今週完了したタスク: 過去7日のタスクを検索して
- アーカイブのみ: アーカイブされたタスクを検索して

パラメータ:

• keyword: 検索キーワード（タイトル・目的・ステップ内容を検索）
• status: all / active / archived（デフォルト: all）
• days: 過去N日以内に作成/完了したタスク

complete_step

タスクのステップを完了にします。全ステップ完了時は自動でアーカイブされます。

search_slack

Slackメッセージをキーワードで検索します（search:readスコープが必要）。

使用例:
- キーワード検索: 「週次レポート」で検索して
- 特定の人の発言: 「from:@yamada 進捗」で検索して
- チャンネル指定: 「ミーティング」を#generalで検索して

パラメータ:

• query: 検索クエリ（必須）- Slack検索構文対応
  • from:@user: 特定ユーザーの発言
  • in:#channel: 特定チャンネル内
  • before:2024-12-01, after:2024-12-01: 日付指定
  • has:link, has:reaction: リンク・リアクション付き
• count: 最大件数（デフォルト10、上限100）
• channel: チャンネル名で絞り込み（#なし）

検索結果には各メッセージのpermalinkが含まれ、get_slack_threadでスレッド全体を取得できます。

推奨ワークフロー

1. get_slack_thread  → スレッド取得（文脈DB化）
2. analyze_request   → 目的・不明点・確認案を生成
3. draft_reply       → 返信の下書きを添削・構造化
4. save_task         → タスクとして保存
5. complete_step     → 進捗管理

依頼分析のルール

Slackの依頼を分析する際は、以下のルールに従ってください：

1. 目的の明確化

「結局何を求められているか」を言語化する。

• この依頼の最終ゴールは何か？
• 何を作る/する必要があるか？
• 誰のため？誰と連携？

2. 不明点の洗い出し

「これを聞かないと進めない」を特定する。