# Claude Web / Claude Code / Codexで管理・開発する（UI × MCP）

PM on Railsは、PMが画面（UI）で整えた要求・ストーリー・タスクを、**Claude Web / Claude Code / Codex / CursorなどのAIエージェント**から直接読み書きできます。UI（人が見る画面）とMCP（AIがつなぐ接続口）が**同じグラフ**を共有するので、PMの管理とエンジニアの開発が分断されません。

![PM on RailsのClaude Code / Codex連携。要求・完成条件・タスクを開発AIが読む。導入前はタスク名だけを渡して推測させていた。導入後は背景と完成条件を読んでから実装に入れる。](https://pmonrails.com/docs-img/mcp-tools.png)

## つなぐ（セットアップ）

### Claude Web / リモートMCP

Claude Webのcustom connectorには、PM on RailsのMCP URLとして `https://pmonrails.com/api/mcp` を登録します。認証はOAuthで行われるため、Claude WebにPATを貼り付ける必要はありません。Client ID / Secretは空のままで構いません。

1. Claude Webの `Customize → Connectors → Add custom connector` を開きます。
2. URLに `https://pmonrails.com/api/mcp` を入力します。
3. PM on Railsの同意画面でWorkspaceと権限を承認します。

### Claude Code / CLI

1. ターミナルで `npm install -g pm-on-rails` を実行し、CLIを入れます（Node.js 20以上が必要です）。
2. `pm-on-rails login` を実行し、開いたブラウザで承認します。トークンはOSのキーチェーンに保存されます。
3. `pm-on-rails mcp install` を実行すると、Claude CodeにMCP接続が登録されます（内部で `claude mcp add` を実行。既定で全プロジェクトから使えます）。登録したらClaude Codeを再起動します。
4. Codex・Cursorなど他のMCP対応エージェントでは、「個人設定 → 連携」のトークン管理でアクセストークン（PAT）を発行し、接続先とトークンを設定します。

> トークンはワークスペース単位です。できることの一覧は [MCP機能リファレンス](https://pmonrails.com/docs/mcp-reference.md)。

## 開発の1サイクル（こう動く）

PMはClaude Webで整理・確認し、エンジニアはClaude Code / Codexで実装へ進められます。

1. **着手対象を把握** — 「今の開発サイクルの未着手タスクを見せて」→ タスク一覧と内容を取得。
2. **背景と完成基準を理解** — 「このタスクの背景と受け入れ条件を教えて」→ 要求 → 要件 → ストーリー → シナリオまで**つながりを辿って**提示します。
3. **自分に割り当てて着手** — 「これ着手するね」→ タスクを自分に割り当て、状態を「進行中」に。
4. **ブランチ・PRが自動で紐づく** — 着手時の応答に、**ブランチ名**と **PR本文に貼る1行**（`PMR-Task: <ID>` という決まった形式。日本語ではありません）が含まれます。それをそのまま使えば、**UUIDを手で書かずに**タスクとPRが紐づきます（[GitHub連携](https://pmonrails.com/docs/github.md)）。
5. **着手後の仕様変更に気づける** — 実装中にPM側で要求が変わっても、エージェントは「自分が着手したあとに上流が変わった」ことを検知できます（[変更の追従](https://pmonrails.com/docs/change-tracking.md)）。
6. **マージで自動的に完了** — PRが既定ブランチ（main）にマージされると、タスクは自動で「完了」になり、親ストーリーの状態も再計算されます（featureブランチへのマージは待ち扱い）。

## できること

会話だけで、次の操作ができます。網羅的な一覧は [MCP機能リファレンス](https://pmonrails.com/docs/mcp-reference.md) を参照してください。

- **読む** — タスク／ストーリー／要求の一覧・詳細、つながりの追跡、似た要求・過去の判断の検索、プロジェクト統計。
- **作る・変える** — 要求カード／要件／ストーリー／受入シナリオ／タスクの作成・更新、状態変更、自分への割り当て・完了。
- **バグ対応** — バグ起票、影響範囲の記録、解決の記録、再発防止の要件化。
- **持ち出し・連携** — Markdownエクスポート、ストーリーのGitHub Issue化、PRのタスク紐付け。
- **見積もり** — タスクの所要時間の見積もり提案。
- **まとめて実行** — 複数の操作を1回でまとめて実行（途中で失敗したら全部取り消し）。

## UIとClaude Web / Claude Code / Codexの使い分け

| やりたいこと | 画面（UI） | AIエージェント（MCP） |
| --- | --- | --- |
| ステークホルダーと要求・スコープを合意する | ◎ | △ |
| ロードマップ・カンバンで全体を見る | ◎ | ○（要約は得意） |
| PMが会話で整理・更新する | ○ | ◎（Claude Web） |
| 実装しながらタスク／シナリオを更新する | ○ | ◎（Claude Code / Codex） |
| 背景・受け入れ条件を読みながらコーディングする | △ | ◎（Claude Code / Codex） |
| まとめて大量に起票・更新する | △ | ◎ |
| Markdown / GitHubへ出す | ○ | ○ |

どちらで操作しても**同じグラフ**が更新され、同じ業務ルール・安全確認が効きます。

## 安全

- すべての操作は、トークンに紐づくワークスペース／プロジェクトの権限の範囲内に制限されます。
- 画面操作と同じ確認・ルールが、エージェントからの操作にも効きます。

## 次のステップ

- [ユーザーストーリー・シナリオ](https://pmonrails.com/docs/stories.md) / [変更の追従](https://pmonrails.com/docs/change-tracking.md) / [進捗を管理する](https://pmonrails.com/docs/progress.md)
- ツールの詳細 → [Claude Web・Claude Code・MCP連携](https://pmonrails.com/docs/mcp.md)

---

https://pmonrails.com/docs/ai-coding