slack/skills/slack-troubleshooting/SKILL.md
Slack MCPの既知の問題と対処法のリファレンス。
npx skillsauth add hidetsugu-miya/claude-plugins slack-troubleshootingInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
| 症状 | 対処 |
|---|---|
| ワークスペースが未設定です | login でワークスペースを追加 |
| ヘッドレス環境を検出しました | デスクトップ環境(macOS / OrbStack Linux VM / Wayland or X11 付きLinux)で login を実行 |
| ModuleNotFoundError: No module named 'mcp' / httpx | pip3 install 'mcp>=1.13' httpx を実行 |
| RuntimeError: Unsupported protocol version from the server: 2025-06-18 | mcp SDK が古い。pip3 install -U 'mcp>=1.13' で更新 |
| 自動リフレッシュ後も 401 が返る | logout <workspace_key> → login で再認証 |
| auth.test failed: ... | トークンがスコープ不足または無効化されている。logout → login で再認証 |
| State parameter mismatch | 別の認証フローが並走している可能性。_pending が残っていれば rm -rf ~/.config/slack-mcp/_pending してから再試行 |
| MCP Error [...] | ツール名・引数を確認。tools で利用可能なツール一覧を確認 |
| ポート3118が使用中 | login 実行前に他のSlack MCP認証プロセスを終了(lsof -i :3118) |
| ワークスペースが見つかりません: <key> | workspaces でキーを確認。部分一致検索にも対応 |
tools
Slack MCP CLI の初期セットアップ skill。`~/.config/slack/bin/slack-mcp` wrapper を作成し、Codex / Claude / terminal から `CLAUDE_PLUGIN_ROOT` なしで Slack MCP を使えるようにする。「Slack MCP をセットアップ」「slack-mcp コマンドを作成」等で起動する。
tools
Slack MCP 連携の共通リファレンス。公式 MCP Python SDK、固定 Slack CLIENT_ID、ワークスペース単位の OAuth token 保存、Slack MCP CLI の実行規約を定義する。slack-connect / slack-bridge から参照する。
tools
Slack MCP 用の初回接続 skill。`~/.config/slack/bin/slack-mcp login` で公式 MCP Python SDK による OAuth 認証を実行し、ワークスペース単位で token を保存する。「Slack を接続」「Slack MCP の初回登録」等で起動する。
tools
登録済み Slack workspace を使って Slack MCP tool を実行する skill。`~/.config/slack/bin/slack-mcp call` 方式で、検索・チャンネル履歴・スレッド取得・送信を行う。「Slack を検索」「Slack の permalink を読んで」「Slack チャンネル履歴を見て」等で起動する。