craft-stadium-mcp 1.0.0 → 1.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +48 -16
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -4,8 +4,18 @@ CraftStadiumをClaude(Desktop/Code)から直接操作するためのMCPサーバ
|
|
|
4
4
|
|
|
5
5
|
## セットアップ
|
|
6
6
|
|
|
7
|
-
1.
|
|
8
|
-
|
|
7
|
+
### 1. PATを発行する
|
|
8
|
+
|
|
9
|
+
Organizeアプリの「設定 > アクセストークン」からPersonal Access Token(`cs_pat_...`)を発行する。
|
|
10
|
+
|
|
11
|
+
### 2. Claude Desktopに登録する場合
|
|
12
|
+
|
|
13
|
+
1. Claude Desktopのメニューから「設定(Settings)> Developer > Edit Config」を開く。まだ設定ファイルがない場合はここで新規作成される。
|
|
14
|
+
- 直接ファイルを開きたい場合のパスは以下の通り:
|
|
15
|
+
- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
|
|
16
|
+
- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
|
|
17
|
+
- Linux: `~/.config/Claude/claude_desktop_config.json`
|
|
18
|
+
2. 開いたファイルに以下を追記して保存する(既に`mcpServers`に他のサーバーの設定がある場合は、その中に`craft-stadium`のエントリだけ追加する。ファイルが空の場合はこの内容をそのまま貼り付ければよい):
|
|
9
19
|
|
|
10
20
|
```json
|
|
11
21
|
{
|
|
@@ -21,7 +31,42 @@ CraftStadiumをClaude(Desktop/Code)から直接操作するためのMCPサーバ
|
|
|
21
31
|
}
|
|
22
32
|
```
|
|
23
33
|
|
|
24
|
-
`
|
|
34
|
+
`cs_pat_...`の部分は手順1で発行した実際のトークンに置き換える。
|
|
35
|
+
|
|
36
|
+
3. Claude Desktopを完全に再起動する(タスクバー/メニューバーからも終了し、起動し直す)。
|
|
37
|
+
4. 入力欄下部のツールアイコン(🔨)をクリックし、`craft-stadium`のツール一覧(`whoami`など)が表示されていれば設定完了。表示されない場合は[トラブルシューティング](#トラブルシューティング)を参照。
|
|
38
|
+
|
|
39
|
+
### 3. Claude Codeに登録する場合
|
|
40
|
+
|
|
41
|
+
どちらか一方の方法で登録する。
|
|
42
|
+
|
|
43
|
+
**方法A: CLIコマンドで登録**
|
|
44
|
+
|
|
45
|
+
```bash
|
|
46
|
+
claude mcp add craft-stadium -e CRAFTSTADIUM_TOKEN=cs_pat_... -- npx craft-stadium-mcp
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
- プロジェクト内の他のメンバーとも設定を共有したい場合は `--scope project` を付ける(プロジェクト直下に`.mcp.json`が作成され、gitにコミットできる。ただしトークンをそのままコミットしないよう注意)。
|
|
50
|
+
- 自分のマシン全体で使いたい場合は `--scope user` を付ける。
|
|
51
|
+
|
|
52
|
+
**方法B: `.mcp.json`を直接編集**
|
|
53
|
+
|
|
54
|
+
プロジェクトのルートに`.mcp.json`を作成(既にあれば追記)し、手順2と同じ`mcpServers`の内容を記述する。
|
|
55
|
+
|
|
56
|
+
登録後、Claude Codeで `/mcp` コマンドを実行すると接続状況を確認できる。
|
|
57
|
+
|
|
58
|
+
### 補足
|
|
59
|
+
|
|
60
|
+
`npx`が都度パッケージを取得して実行するため、事前インストールは不要。デフォルトで本番API(`https://api.craftstadium.com`)に接続する。
|
|
61
|
+
|
|
62
|
+
## トラブルシューティング
|
|
63
|
+
|
|
64
|
+
| 症状 | 確認事項 |
|
|
65
|
+
|---|---|
|
|
66
|
+
| ツール一覧に`craft-stadium`が出てこない | JSON構文が正しいか(カンマ・波括弧の閉じ忘れなど)を確認。設定変更後にアプリを完全に再起動したか確認 |
|
|
67
|
+
| ツール実行時に401/認証エラーが返る | `CRAFTSTADIUM_TOKEN`が正しくコピーされているか、Organizeアプリでトークンが失効・削除されていないか確認。トークンは発行直後の画面にしか表示されないため、失念した場合は再発行する |
|
|
68
|
+
| `npx: command not found` などが出る | Node.js(v18以上推奨)がインストールされているか確認 |
|
|
69
|
+
| Claude Codeで動かない | `claude mcp list` で登録済みサーバー一覧に`craft-stadium`が表示されるか確認 |
|
|
25
70
|
|
|
26
71
|
## 提供ツール
|
|
27
72
|
|
|
@@ -33,16 +78,3 @@ CraftStadiumをClaude(Desktop/Code)から直接操作するためのMCPサーバ
|
|
|
33
78
|
| `list_plans` | 企画一覧 |
|
|
34
79
|
| `create_hackathon` | 下書きハッカソン作成(公開設定・日程はWeb UIから編集) |
|
|
35
80
|
| `list_hackathons` | 企画配下のハッカソン一覧 |
|
|
36
|
-
|
|
37
|
-
## 開発
|
|
38
|
-
|
|
39
|
-
```bash
|
|
40
|
-
npm run dev # tsx で直接起動
|
|
41
|
-
npx tsc --noEmit # 型チェック
|
|
42
|
-
```
|
|
43
|
-
|
|
44
|
-
MCP Inspectorで動作確認する場合:
|
|
45
|
-
|
|
46
|
-
```bash
|
|
47
|
-
npx @modelcontextprotocol/inspector npx tsx src/index.ts
|
|
48
|
-
```
|