@autodevjapan/godd-mcp-alpha 1.40.0 → 1.42.0

package/README.md

@@ -10,7 +10,7 @@
 
 ## English
 
-AI prompt delivery system for MCP-compatible clients (Cursor IDE, Claude Code CLI). Delivers project-optimized prompts, mindsets, and agent definitions via MCP (Model Context Protocol). The server is client-agnostic — the same `serve` command works with any MCP host. Verified on Cursor IDE and Claude Code CLI.
+AI prompt delivery system for MCP-compatible clients (Cursor IDE, Claude Code CLI, and Codex). Delivers project-optimized prompts, mindsets, and agent definitions via MCP (Model Context Protocol). The server is client-agnostic — the same `serve` command works with any MCP host. Cursor, Claude Code, and Codex are officially supported.
 
 ### Installation
 
@@ -55,7 +55,18 @@ If `godd-a install` is unavailable, you can edit `~/.cursor/mcp.json` directly.
 
 ### Claude Code CLI Setup
 
-`godd-a install` currently targets Cursor only (`~/.cursor/mcp.json`). For Claude Code CLI, register the server manually. The startup command, args, and env are identical to Cursor.
+Register the server into Claude Code CLI with the `--client=claude-code` flag:
+
+```bash
+godd-a install --client=claude-code --license-key=YOUR_LICENSE_KEY
+```
+
+This delegates registration to `claude mcp add-json` at **user scope** (`~/.claude.json`), so it merges safely alongside your other MCP servers and is re-runnable (an existing entry is refreshed). When the `claude` CLI is not on your PATH, the installer prints the exact command to run by hand instead.
+
+Without `--client`, `godd-a install` targets Cursor (`~/.cursor/mcp.json`) as before. The startup command, args, and env are identical across clients, and the license device binding is per-device.
+
+<details>
+<summary>Manual registration (if you prefer not to use <code>godd-a install</code>)</summary>
 
 ```bash
 claude mcp add godd-a \
@@ -63,11 +74,22 @@ claude mcp add godd-a \
   -- npx -y @autodevjapan/godd-mcp-alpha@latest serve
 ```
 
-Or add a project-root `.mcp.json` with the same `mcpServers` structure shown above (the `serve` argument is required). The license device binding is per-device, so the same key works across Cursor and Claude Code CLI on the same machine.
+Or add a project-root `.mcp.json` with the same `mcpServers` structure shown above (the `serve` argument is required).
+</details>
+
+### Codex Setup
+
+Register through Codex's official MCP CLI. Codex CLI, the IDE extension, and the app share this MCP configuration:
+
+```bash
+godd-a install --client=codex --license-key=YOUR_LICENSE_KEY
+```
+
+Verify with `codex mcp list` or `/mcp`. Remove it with `godd-a uninstall --client=codex`.
 
 ### Usage
 
-After installation, restart your MCP client (Cursor IDE or Claude Code CLI) and the GoDD MCP α server will start automatically.
+After installation, restart your MCP client (Cursor IDE, Claude Code CLI, or Codex) and the GoDD MCP α server will start automatically.
 
 **Option 1 — Slash command (recommended):** Type `/` in the Cursor chat input to see GoDD prompts in the dropdown, then select one (e.g., `/dev`, `/review`).
 
@@ -139,10 +161,10 @@ Available GoDD prompts (MCP tools) in Cursor IDE:
 
 | Command | Description |
 |---|---|
-| `godd-a install [--license-key=KEY]` | Register MCP server with Cursor |
+| `godd-a install [--license-key=KEY] [--client=...]` | Register with Cursor, Claude Code, or Codex |
 | `godd-a init [--force] [--lang=LANG] [--auto]` | Generate project config.godd |
-| `godd-a uninstall` | Remove MCP server from Cursor |
-| `godd-a serve` | Start MCP stdio server (auto-invoked by Cursor) |
+| `godd-a uninstall [--client=...]` | Remove from the selected MCP client |
+| `godd-a serve` | Start MCP stdio server (auto-invoked by the client) |
 | `godd-a --version` / `godd-a -v` | Show installed version |
 
 ### Scratchpad (Persistent Memory)
@@ -220,7 +242,7 @@ Proprietary — A GoDD license key is required. Purchase at the [official site](
 
 ## 日本語
 
-MCP 対応クライアント（Cursor IDE / Claude Code CLI）向けの AI プロンプト配信システム。MCP (Model Context Protocol) を通じて、プロジェクトの技術スタックに最適化されたプロンプト・マインドセット・エージェント定義を提供します。サーバー本体はクライアント非依存で、同一の `serve` コマンドで任意の MCP ホストから利用できます（Cursor IDE / Claude Code CLI で動作確認済み）。
+MCP 対応クライアント（Cursor IDE / Claude Code CLI / Codex）向けの AI プロンプト配信システム。MCP (Model Context Protocol) を通じて、プロジェクトの技術スタックに最適化されたプロンプト・マインドセット・エージェント定義を提供します。サーバー本体はクライアント非依存で、Cursor、Claude Code、Codex を正式サポートします。
 
 ### インストール
 
@@ -265,7 +287,13 @@ godd-a init --auto
 
 ### Claude Code CLI でのセットアップ
 
-`godd-a install` は現状 Cursor 専用（`~/.cursor/mcp.json` のみ）です。Claude Code CLI では MCP サーバーを手動登録します。起動コマンド・引数・環境変数は Cursor と同一です。
+次のコマンドで Claude Code CLI の user scope に登録します。既存設定とのマージは `claude` CLI に委譲されます。
+
+```bash
+godd-a install --client=claude-code --license-key=YOUR_LICENSE_KEY
+```
+
+手動登録する場合:
 
 ```bash
 claude mcp add godd-a \
@@ -273,11 +301,21 @@ claude mcp add godd-a \
   -- npx -y @autodevjapan/godd-mcp-alpha@latest serve
 ```
 
-または、プロジェクトルートの `.mcp.json` に上記と同じ `mcpServers` 構造を記述します（`serve` 引数は必須）。ライセンスのデバイスバインディングは端末単位のため、同一端末であれば Cursor と Claude Code CLI で同じキーを共用できます。
+削除は `godd-a uninstall --client=claude-code` を使用します。
+
+### Codex でのセットアップ
+
+Codex 公式 CLI を通して登録します。Codex CLI、IDE extension、app はこの MCP 設定を共有します。
+
+```bash
+godd-a install --client=codex --license-key=YOUR_LICENSE_KEY
+```
+
+`codex mcp list` または `/mcp` で確認し、削除は `godd-a uninstall --client=codex` を使用します。
 
 ### 使い方
 
-インストール後、MCP クライアント（Cursor IDE または Claude Code CLI）を再起動すると GoDD MCP α サーバーが自動で起動します。
+インストール後、MCP クライアント（Cursor IDE、Claude Code CLI、Codex）を再起動すると GoDD MCP α サーバーが自動で起動します。
 
 **方法 1 — スラッシュコマンド（推奨）:** Cursor のチャット入力欄で `/` を入力するとドロップダウンに GoDD プロンプトが表示されます。選択して実行してください（例：`/dev`、`/review`）。
 
@@ -349,10 +387,10 @@ Cursor IDE 上で利用できる GoDD プロンプト（MCP ツール）の一
 
 | コマンド | 説明 |
 |---|---|
-| `godd-a install [--license-key=KEY]` | Cursor に MCP サーバーを登録 |
+| `godd-a install [--license-key=KEY] [--client=...]` | Cursor / Claude Code / Codex に登録 |
 | `godd-a init [--force] [--lang=LANG] [--auto]` | プロジェクトの config.godd を生成 |
-| `godd-a uninstall` | Cursor から MCP サーバーを削除 |
-| `godd-a serve` | MCP stdio サーバーを起動（Cursor が自動呼び出し） |
+| `godd-a uninstall [--client=...]` | 選択した MCP クライアントから削除 |
+| `godd-a serve` | MCP stdio サーバーを起動（クライアントが自動呼び出し） |
 | `godd-a --version` / `godd-a -v` | インストール済みバージョンを表示 |
 
 ### スクラッチパッド（永続メモリ）
@@ -430,7 +468,7 @@ Proprietary — GoDD ライセンスキーが必要です。[公式サイト](ht
 
 ## Русский
 
-Система доставки AI-промптов для MCP-совместимых клиентов (Cursor IDE, Claude Code CLI). Предоставляет оптимизированные под технологический стек проекта промпты, мировоззрения и определения агентов через MCP (Model Context Protocol). Сервер не зависит от клиента — одна и та же команда `serve` работает с любым MCP-хостом. Проверено в Cursor IDE и Claude Code CLI.
+Система доставки AI-промптов для MCP-совместимых клиентов (Cursor IDE, Claude Code CLI, Codex). Предоставляет оптимизированные под технологический стек проекта промпты, мировоззрения и определения агентов через MCP (Model Context Protocol). Сервер не зависит от клиента — одна и та же команда `serve` работает с любым MCP-хостом. Cursor, Claude Code и Codex официально поддерживаются.
 
 ### Установка