@geekbeer/minion 2.60.0 → 2.62.0

package/docs/environment-setup.md

@@ -28,9 +28,20 @@ requires:
 
 ## MCP サーバーの設定
 
-MCP サーバーは `~/.mcp.json` に JSON 形式で設定する。このファイルが Claude Code セッション起動時に読み込まれる。
+MCPサーバーの設定ファイルは使用するCLIツールによって異なる。
+いずれも LLM から直接編集可能（パーミッション設定とは異なり、API経由は不要）。
 
-### ファイル形式
+### CLI別の設定ファイル
+
+| CLI | 設定ファイル | フォーマット | 編集方法 |
+|-----|------------|------------|---------|
+| Claude Code | `.mcp.json`（プロジェクトルート） | JSON | Edit/Write ツールで直接編集 |
+| Gemini CLI | `.gemini/settings.json` | JSON | Edit/Write ツールで直接編集 |
+| Codex CLI | `~/.codex/config.toml` | TOML | `codex mcp add/remove` コマンド推奨 |
+
+### Claude Code
+
+設定ファイル: `.mcp.json`（プロジェクトルート）または `~/.mcp.json`（ユーザーレベル）
 
 ```json
 {
@@ -43,9 +54,8 @@ MCP サーバーは `~/.mcp.json` に JSON 形式で設定する。このファ
 }
 ```
 
-### 設定の追加・変更手順
-
-1. `~/.mcp.json` が存在しない場合は新規作成する
+**設定の追加・変更手順:**
+1. `.mcp.json` が存在しない場合は新規作成する
 2. 既存の場合は内容を読み取り、`mcpServers` オブジェクトにエントリを追加する
 3. 既存エントリを壊さないよう注意する
 
@@ -54,10 +64,54 @@ MCP サーバーは `~/.mcp.json` に JSON 形式で設定する。このファ
 cat ~/.mcp.json 2>/dev/null || echo '(not found)'
 ```
 
+**スコープの優先順:**
+1. ローカル (`~/.claude.json` 内のプロジェクト固有設定) — 最優先
+2. プロジェクト (`.mcp.json`) — チーム共有
+3. ユーザー (`~/.claude.json`) — 全プロジェクト共通
+
+### Gemini CLI
+
+設定ファイル: `.gemini/settings.json`（プロジェクト）または `~/.gemini/settings.json`（ユーザーレベル）
+
+```json
+{
+  "mcpServers": {
+    "<server-name>": {
+      "command": "<起動コマンド>",
+      "args": ["<引数1>", "<引数2>"],
+      "timeout": 30000
+    }
+  }
+}
+```
+
+追加フィールド: `cwd`（作業ディレクトリ）、`timeout`（ミリ秒）、`trust`（確認プロンプト省略）、`includeTools`/`excludeTools`（ツールフィルタ）
+
+### Codex CLI
+
+設定ファイル: `.codex/config.toml`（プロジェクト）または `~/.codex/config.toml`（ユーザーレベル）
+
+```toml
+[mcp_servers.<server-name>]
+command = "<起動コマンド>"
+args = ["<引数1>", "<引数2>"]
+startup_timeout_sec = 10.0
+tool_timeout_sec = 60.0
+```
+
+**注意:** `.codex/` ディレクトリは LLM からの直接編集が制限される場合がある。以下のコマンドを使用すること:
+
+```bash
+codex mcp add <name> --command "<command>" --args "<arg1>,<arg2>"
+codex mcp remove <name>
+codex mcp list
+```
+
 ### よく使う MCP サーバーの設定例
 
 #### Playwright（ブラウザ自動化）
 
+**Claude Code / Gemini CLI:**
 ```json
 {
   "mcpServers": {
@@ -69,10 +123,18 @@ cat ~/.mcp.json 2>/dev/null || echo '(not found)'
 }
 ```
 
+**Codex CLI:**
+```toml
+[mcp_servers.playwright]
+command = "npx"
+args = ["-y", "@playwright/mcp@latest"]
+```
+
 `npx -y` により、未インストールでも自動ダウンロード・実行される。事前の `npm install` は不要。
 
 #### Supabase（データベース）
 
+**Claude Code / Gemini CLI:**
 ```json
 {
   "mcpServers": {
@@ -83,14 +145,20 @@ cat ~/.mcp.json 2>/dev/null || echo '(not found)'
 }
 ```
 
+**Codex CLI:**
+```toml
+[mcp_servers.supabase]
+url = "http://<supabase-host>:54321/mcp?read_only=true&features=database,docs"
+```
+
 URL ベースの MCP サーバーは `url` フィールドで指定する（`command`/`args` は不要）。
 
 ### 注意事項
 
-- `~/.mcp.json` は手動で編集する。Claude Code の設定 UI からは変更できない
+- MCP設定ファイルはLLMから直接編集できる（パーミッション設定ファイルとは異なり書き込み保護がない）
 - `npx -y <package>` 形式を使えば、グローバルインストールなしで MCP サーバーを起動できる
 - サーバー名はスキルの `requires.mcp_servers` と一致させる必要がある（例: `playwright`）
-- `claude-settings.json`（`~/.claude/settings.json`）の `mcpServers` に設定しても同様に動作するが、`~/.mcp.json` が推奨
+- Claude Code では `.mcp.json`（プロジェクトルート）が推奨。`~/.claude/settings.json` の `mcpServers` には設定しない
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@geekbeer/minion",
-  "version": "2.60.0",
+  "version": "2.62.0",
   "description": "AI Agent runtime for Minion - manages status and skill deployment on VPS",
   "main": "linux/server.js",
   "bin": {

package/rules/core.md

@@ -67,6 +67,51 @@ curl -X POST -H "Authorization: Bearer $API_TOKEN" -H "Content-Type: application
 
 対応CLI: `claude-code` (.claude/settings.local.json), `gemini` (.gemini/settings.json), `codex` (.codex/config.toml)
 
+#### MCP Server Configuration
+
+MCPサーバーの設定は各CLIの設定ファイルを直接編集して行う（APIは不要）。
+パーミッション（allow/deny）とは異なり、MCP設定ファイルはLLMから直接編集可能。
+
+| CLI | 設定ファイル | 編集方法 |
+|-----|------------|---------|
+| Claude Code | `.mcp.json`（プロジェクトルート） | 直接編集（Write/Edit ツール） |
+| Gemini CLI | `.gemini/settings.json` | 直接編集 |
+| Codex CLI | `.codex/config.toml` | `codex mcp add/remove` コマンドを使用 |
+
+**Claude Code** — `.mcp.json` を編集:
+```json
+{
+  "mcpServers": {
+    "playwright": {
+      "command": "npx",
+      "args": ["-y", "@playwright/mcp@latest"]
+    }
+  }
+}
+```
+
+**Gemini CLI** — `.gemini/settings.json` の `mcpServers` を編集:
+```json
+{
+  "mcpServers": {
+    "playwright": {
+      "command": "npx",
+      "args": ["-y", "@playwright/mcp@latest"],
+      "timeout": 30000
+    }
+  }
+}
+```
+
+**Codex CLI** — `codex mcp add` コマンド、または `~/.codex/config.toml` を編集:
+```toml
+[mcp_servers.playwright]
+command = "npx"
+args = ["-y", "@playwright/mcp@latest"]
+```
+
+Note: Codex CLI の `.codex/` ディレクトリはLLMからの直接編集が制限される場合がある。その場合は `codex mcp add` コマンドを使用すること。
+
 ### HQ API
 
 `$HQ_URL/api/minion/*` — 認証: `Authorization: Bearer $API_TOKEN`