craft-stadium-mcp

CraftStadiumをClaude(Desktop/Code)から直接操作するためのMCPサーバー。組織のPersonal Access Token(PAT)で認証する。

セットアップ

1. PATを発行する

Organizeアプリの「設定 > アクセストークン」からPersonal Access Token(cs_pat_...)を発行する。

2. Claude Desktopに登録する場合

1. Claude Desktopのメニューから「設定(Settings)> Developer > Edit Config」を開く。まだ設定ファイルがない場合はここで新規作成される。

   • 直接ファイルを開きたい場合のパスは以下の通り:
     • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
     • Windows: %APPDATA%\Claude\claude_desktop_config.json
     • Linux: ~/.config/Claude/claude_desktop_config.json

2. 開いたファイルに以下を追記して保存する(既にmcpServersに他のサーバーの設定がある場合は、その中にcraft-stadiumのエントリだけ追加する。ファイルが空の場合はこの内容をそのまま貼り付ければよい):

   {
     "mcpServers": {
       "craft-stadium": {
         "command": "npx",
         "args": ["craft-stadium-mcp"],
         "env": {
           "CRAFTSTADIUM_TOKEN": "cs_pat_..."
         }
       }
     }
   }

   cs_pat_...の部分は手順1で発行した実際のトークンに置き換える。

3. Claude Desktopを完全に再起動する(タスクバー/メニューバーからも終了し、起動し直す)。

4. 入力欄下部のツールアイコン(🔨)をクリックし、craft-stadiumのツール一覧(whoamiなど)が表示されていれば設定完了。表示されない場合はトラブルシューティングを参照。

3. Claude Codeに登録する場合

どちらか一方の方法で登録する。

方法A: CLIコマンドで登録

claude mcp add craft-stadium -e CRAFTSTADIUM_TOKEN=cs_pat_... -- npx craft-stadium-mcp

• プロジェクト内の他のメンバーとも設定を共有したい場合は --scope project を付ける(プロジェクト直下に.mcp.jsonが作成され、gitにコミットできる。ただしトークンをそのままコミットしないよう注意)。
• 自分のマシン全体で使いたい場合は --scope user を付ける。

方法B: .mcp.jsonを直接編集

プロジェクトのルートに.mcp.jsonを作成(既にあれば追記)し、手順2と同じmcpServersの内容を記述する。

登録後、Claude Codeで /mcp コマンドを実行すると接続状況を確認できる。

補足

npxが都度パッケージを取得して実行するため、事前インストールは不要。デフォルトで本番API(https://api.craftstadium.com)に接続する。

トラブルシューティング

| 症状 | 確認事項 | |---|---| | ツール一覧にcraft-stadiumが出てこない | JSON構文が正しいか(カンマ・波括弧の閉じ忘れなど)を確認。設定変更後にアプリを完全に再起動したか確認 | | ツール実行時に401/認証エラーが返る | CRAFTSTADIUM_TOKENが正しくコピーされているか、Organizeアプリでトークンが失効・削除されていないか確認。トークンは発行直後の画面にしか表示されないため、失念した場合は再発行する | | npx: command not found などが出る | Node.js(v18以上推奨)がインストールされているか確認 | | Claude Codeで動かない | claude mcp list で登録済みサーバー一覧にcraft-stadiumが表示されるか確認 |

提供ツール

| ツール | 内容 | |---|---| | whoami | 組織名・アカウント名・ロールを取得 | | list_organizers | 主催者一覧 | | create_plan | 企画作成 | | list_plans | 企画一覧 | | create_hackathon | 下書きハッカソン作成(公開設定・日程はWeb UIから編集) | | list_hackathons | 企画配下のハッカソン一覧 |