# MCP機能リファレンス

PM on RailsのMCPでできることを、操作の目的ごとにまとめた一覧です。普段は英語のツール名を覚える必要はありません。Claude Web / Claude Code / Codexに日本語で頼めば、エージェントが必要な操作を選びます。

![PM on RailsのMCP機能リファレンス。使える操作が一覧になる。導入前は画面に戻って作成していた。導入後は会話だけで読む・作る・変えるができる。](https://pmonrails.com/docs-img/mcp-tools.png)

このページはAPIドキュメント寄りの参照用です。使い分けや活用例から読みたい場合は [Claude Web・Claude Code・MCP連携](https://pmonrails.com/docs/mcp.md) を参照してください。

## 共通の挙動

- **権限** — PATに紐づくワークスペースとスコープの範囲で実行されます。別ワークスペースのデータは読めません。
- **プロジェクト** — 多くの操作は対象プロジェクトを指定するか、先に接続中プロジェクトを選びます。
- **書き込み** — 作成・更新・削除・状態変更はPM on Rails側の業務ルールを通ります。画面からの操作と同じデータが変わります。
- **履歴** — タスク状態、コメント、判断、文書承認、上流変更など、後から追うべきものは履歴や関連として残ります。
- **一括処理** — 複数操作をまとめる場合、途中で失敗したらまとめて取り消す操作があります。

## 接続・プロジェクト

| 日本語でできること | 主なツール |
| --- | --- |
| 自分が扱えるプロジェクトを一覧する | `list_projects` |
| 作業対象プロジェクトを選ぶ | `connect_project` |
| 表示言語を切り替える | `update_language` |
| プロジェクトの概要をざっくり確認する | `get_project_overview` |
| 接続中ツールの自律実行ポリシーを確認する | `get_tool_autonomy` |
| 要件の曖昧さを確認する | `list_demands` / `list_stories` / `list_scenarios` / `list_questionnaire_questions` / `list_feedback` |

## 要求カード

| 日本語でできること | 主なツール |
| --- | --- |
| 要求カードを一覧する | `list_demands` |
| 要求カードの詳細を読む | `get_demand` |
| 要求カードを作る | `create_demand` |
| タイトル、本文、MoSCoW、スコア、根拠などを更新する | `update_demand` |
| 要求カードをアーカイブ / 復元する | `archive_demand` / `restore_demand` |
| 要求カードを完全削除する | `delete_demand` |
| 似た要求カードを探す | `search_similar_demands` |
| 要求カード起点の仕様文脈をまとめて読む | `get_demand_context` |

## 要件・制約

| 日本語でできること | 主なツール |
| --- | --- |
| 要件を一覧する | `list_requirements` |
| 要件の詳細を読む | `get_requirement` |
| 要件を作る | `create_requirement` |
| 要件の内容や関連を更新する | `update_requirement` |
| 要件をアーカイブ / 復元する | `archive_requirement` / `restore_requirement` |
| 要件を完全削除する | `delete_requirement` |
| 似た要件を探す | `search_similar_requirements` |

## ストーリー

| 日本語でできること | 主なツール |
| --- | --- |
| ユーザーストーリーを一覧する | `list_stories` |
| ユーザーストーリーを作る | `create_story` |
| 概要、アクター、価値、状態などを更新する | `update_story` |
| ストーリーと要求カードを紐付ける / 外す | `link_story_demand` / `unlink_story_demand` |
| ストーリーと要件を紐付ける / 外す | `link_story_requirement` / `unlink_story_requirement` |
| ストーリーをGitHub Issueに書き出す / 同期する | `sync_story_to_github` |
| ストーリーをアーカイブ / 復元する | `archive_story` / `restore_story` |
| ストーリーを完全削除する | `delete_story` |
| 似たストーリーを探す | `search_similar_stories` |

## 受入シナリオ

| 日本語でできること | 主なツール |
| --- | --- |
| シナリオを一覧する | `list_scenarios` |
| シナリオを読む | `read_scenario` |
| Given / When / Thenのシナリオを作る | `create_scenario` |
| シナリオ本文、種別、前提などを更新する | `update_scenario` |
| シナリオの状態を変える | `update_scenario_status` |
| シナリオを新しい版に置き換える | `supersede_scenario` |
| シナリオをアーカイブ / 復元する | `archive_scenario` / `restore_scenario` |
| シナリオを完全削除する | `delete_scenario` |
| 似たシナリオを探す | `search_similar_scenarios` |
| Figma URLから実装向けのデザイン文脈を読む | `get_figma_design_context` |

`create_scenario` は、SDLCScenario、scenario KanbanTask、シナリオテストの記録先をまとめて作ります。生成されたscenario taskは実装・PR・TestResultのアンカーで、Gherkin / scenario_typeは持ちません。実行結果の行は、テスト後に `create_test_result(task_id=<scenario task id>, status=...)` で記録します。

## タスク・開発フロー

| 日本語でできること | 主なツール |
| --- | --- |
| タスクを一覧する | `list_tasks` |
| 似たタスクを探す | `search_similar_tasks` |
| タスクの詳細を読む | `get_task` |
| タスクを作る | `create_task` |
| タスクのタイトル、説明、見積もり、担当などを更新する | `update_task` |
| タスクを着手する | `start_task` |
| タスクを着手中・レビュー中・完了などに動かす | `update_task_status` / `complete_task` |
| タスクを自分に割り当てる | `assign_task_to_me` |
| タスクとストーリーを紐付ける / 外す | `link_task_story` / `unlink_task_story` |
| タスクを完全削除する | `delete_task` |
| 接続済みリポジトリのPRを検索する | `search_github_pull_requests` |
| PRとタスクを紐付ける | `link_pr` |
| 紐付け漏れで取り残されたタスクを探して回収する | `reconcile_task_prs` |
| PRを出した後に変わったタスクの仕様を確認済みにする | `confirm_task_spec_change` |
| 所要時間の見積もりを提案する | `suggest_estimate` |

`create_task` / `update_task` は起票・内容編集・現況投入のtoolです。実装に入る場合は、必要な作成や更新を済ませた後に `start_task(task_id)` を呼びます。create/updateに `kanban_status='doing'` を渡してもstarted_atは刻まれず、DoRの着手ゲートも評価されません。着手の専用入口は `start_task` です。未担当なら呼び出し元が担当者になり、未着手ならstarted_atが刻まれ、DoRが評価され、cycle未割当でactiveな開発サイクルが一意に決まる場合はそのcycleに自動投入されます。activeな開発サイクルが無い場合は勝手に期間を決めず、開始日・終了日・運用単位 (1週間 / 2週間 / その他) を確認してから `create_cycle` で作成し、同じ `start_task` を再実行します。他人の進行中タスクを巻き取る場合は `assign_task_to_me` を明示的に使います。started_atは初回着手時刻として保持され、着手後の担当変更履歴があるタスクは個人別の所要時間補正サンプルから除外されます。状態だけを動かす場合は `update_task_status` を使います。

## バグ・不具合

| 日本語でできること | 主なツール |
| --- | --- |
| バグがどのシナリオを破っているか調べる | `resolve_bug_destination` |
| バグタスクを起票する | `create_bug_task` |
| バグの影響範囲を記録する | `update_bug_affects` |
| 指定したシナリオや要件に影響するバグを一覧する | `list_bugs_affecting` |
| バグを解決済みにする | `resolve_bug` |
| 変更リクエスト (修正提案) を起票する | `create_change_request` |
| 変更リクエストを一覧する / 1件読む | `list_change_requests` / `get_change_request` |
| 再発防止のためにバグを要件候補へ昇格する | `promote_bug_to_requirement` |

バグを「修正した」で閉じるには変更リクエストの紐付けが必要です。`create_change_request` で起票して、返ったidを `resolve_bug` に渡します。承認・適用・確定は画面で行います (仕様の新版作成やバグの自動クローズを伴うため)。

## ロードマップ・開発サイクル

| 日本語でできること | 主なツール |
| --- | --- |
| Epicを一覧する | `list_epics` |
| Epicを作る | `create_epic` |
| Epicの内容や状態を更新する | `update_epic` |
| Epicとストーリー・単独タスクを紐付ける / 外す | `link_epic_work_item` / `unlink_epic_work_item` |
| 開発サイクルを一覧する | `list_cycles` |
| 開発サイクルを作る | `create_cycle` |
| 開発サイクルの名前、期間、対象などを更新する | `update_cycle` |
| 開発サイクルの状態を変える | `update_cycle_status` |
| サイクル内の完了済みタスクを取り込む | `adopt_completed_tasks` |
| 開発サイクルの進捗 (完了・残りの件数と見積もり、見積もりカバレッジ、取り込み待ちの完了件数) を確認する | `get_cycle_progress` |

## ステークホルダー

| 日本語でできること | 主なツール |
| --- | --- |
| ステークホルダーを一覧する | `list_stakeholders` |
| ステークホルダーを作る | `create_stakeholder` |
| ステークホルダーの情報を更新する | `update_stakeholder` |

## アクター (システムを使う役割)

| 日本語でできること | 主なツール |
| --- | --- |
| プロジェクトのアクターを一覧する | `list_actors` |
| アクターを別名つきで登録する | `create_actor` |

ユーザーストーリーのアクター欄に書いた名前は、**既存のアクター名か別名と完全一致すればそこに名寄せされ、一致しなければ新しいアクターとして登録されます**。「店舗スタッフ」と「店舗の担当者」のような表記の揺れを増やさないために、ストーリーを作る前に `list_actors` で既存の語彙を確認してください。揺れが既にある場合は、残したい方に `create_actor` の別名として登録すると以後まとまります。

## メンバー・権限

| 日本語でできること | 主なツール |
| --- | --- |
| ワークスペースのメンバーを一覧する (担当者に渡すuser_idもここで引く) | `list_workspace_members` |
| プロジェクトに参加しているメンバーとロールを一覧する | `list_project_members` |
| ワークスペースのメンバーをプロジェクトに参加させる / ロールを変える | `assign_project_member` |
| プロジェクトからメンバーを外す (ワークスペースの所属は残る) | `remove_project_member` |

プロジェクトロールは管理 (`maintainer`) / 編集 (`editor`) / 閲覧 (`viewer`) の3段階です。参加させられるのは**すでにワークスペースにいる人だけ**で、まだいない人をメールで招く操作はMCPにはありません (設定 > メンバーから招待します)。割り当てと解除にはプロジェクトの管理ロールが必要です。

## 確認事項・フィードバック

| 日本語でできること | 主なツール |
| --- | --- |
| 確認事項を一覧する | `list_questionnaire_questions` |
| ステークホルダーへの確認事項を作る | `create_questionnaire_question` |
| 確認事項の文面・対象・状態を編集する | `update_questionnaire_question` |
| 確認事項に回答を記録する | `answer_questionnaire_question` |
| 確認事項を解決済みにする / 戻す | `resolve_questionnaire_question` / `reopen_questionnaire_question` |
| 解決する前に、回答がすべての影響先に反映されたかを確かめる | `resolve_questionnaire_question` (`dry_run=true`) |
| 確認事項をSlackに共有する | `share_questionnaire_question_to_slack` |
| 不要な確認事項を削除する | `delete_questionnaire_question` |
| 回答を要求・ストーリーへ反映する提案を作る | `create_question_reflection_proposal` |
| 実使用で出た違和感・要望・不具合の兆候を見る | `list_feedback` |
| フィードバックを作る | `create_feedback` |
| フィードバックを要求・ストーリーへ反映する提案を作る | `create_feedback_reflection_proposal` |
| 追加確認を依頼する | `request_clarification` |

## コメント・作業メモ

| 日本語でできること | 主なツール |
| --- | --- |
| コメントを追加する | `add_comment` |
| コメントを一覧する | `list_comments` |
| コメント本文や状態を更新する | `update_comment` |
| コメントを解決済みにする / 戻す | `resolve_comment` / `reopen_comment` |
| コメントを要求・ストーリー・タスクなどに紐付ける | `link_comment_to_sdlc_node` |
| 試して失敗した方法を作業メモとして残す | `record_failed_approach` |

## 判断・ADR

| 日本語でできること | 主なツール |
| --- | --- |
| 要求の採用 / 却下 / 保留などの判断を記録する | `create_decision` |
| 要求判断を一覧する | `list_decisions` |
| ADRを作る | `create_architecture_decision` |
| ADRを更新する | `update_architecture_decision` |
| ADRを新しい判断で置き換える | `supersede_architecture_decision` |
| ADRをプロジェクトへ割り当てる | `assign_architecture_decision_project` |
| ADRを一覧する | `list_architecture_decisions` |
| ADRを削除する | `delete_architecture_decision` |
| 似た判断を探す | `search_similar_decisions` |

## 文書・ナレッジ

| 日本語でできること | 主なツール |
| --- | --- |
| 一般ナレッジのフォルダを一覧する | `list_folders` |
| 一般ナレッジのフォルダを作る | `create_folder` |
| 一般ナレッジ文書を一覧する | `list_documents` |
| 文書を読む | `get_document` |
| 一般ナレッジ文書を作る | `create_document` |
| 文書本文を更新する | `update_document_body` |
| 文書を削除する | `delete_document` |
| AIで文書下書きを生成する | `generate_document_draft` |
| 文書レビューを依頼する | `request_document_review` |
| 文書を承認 / 差し戻しする | `approve_document` / `reject_document` |
| 文書の版を一覧する | `list_document_versions` |
| 文書の承認イベントを一覧する | `list_document_approval_events` |
| 特定の文書版を読む | `get_document_version` |
| 過去の文書版へ戻す | `revert_document_version` |
| 基本設計ドライブのフォルダを一覧する | `list_design_folders` |
| 基本設計ドライブのフォルダを作る | `create_design_folder` |
| 設計対象に紐づく既存設計書を探す | `list_design_documents` |
| DESIGNS付きで基本設計書を作る | `create_design_document` |

設計書を作る前には `list_design_documents` で既存を確認します。同じ要求・要件・ストーリーの設計書がある場合は、新規作成ではなく `get_document` と `update_document_body` で既存本文へ統合します。

## テスト結果

| 日本語でできること | 主なツール |
| --- | --- |
| テスト結果を一覧する | `list_test_results` |
| テスト結果を記録する | `create_test_result` |
| テスト結果をタスクへ紐付ける | `link_test_result_to_task` |
| シナリオ検証が最新仕様に対して新しいか確認する | `get_scenario_verification_freshness` |
| PR前にシナリオの完了証拠を確認する | `check_pr_quality_gate` |
| 紐付いていないテスト結果を洗い出す | `audit_unlinked_test_results` |

### スクリーンショットをTest Runに残す

ローカルの画像と動画は `upload_attachment(project_id, file_path)` でアップロードします。`file_path` はpm-on-rails CLIのMCP proxyを実行するホストから参照できるパスです。相対パスはproxyの作業ディレクトリを基準に解決します。proxyがファイルを読んで送るので、添付の中身がエージェントのトークンを消費しません (Base64を貼ると200KBのスクリーンショットで約19万トークンかかります)。応答の `attachment_id` を `create_test_result` の `evidence[].attachment_id` に渡すと、スクリーンショット / 動画のEvidenceとしてTest Runに残ります。画面やシナリオ本文で表示するURLは `/api/attachments/{id}` です。サーバはCLI MCP proxy側のファイルを開けないので、CLIのMCP proxyを経由しないクライアントでは `file_path` が `attachment.file_path_not_resolved` で失敗します。その場合だけ `content_base64` を渡してください。

## 変更追従・差分反映

| 日本語でできること | 主なツール |
| --- | --- |
| 上流変更を一覧する | `list_upstream_changes` |
| 上流変更を確認済みにする | `acknowledge_upstream_changes` |
| 下流への更新案を一覧する | `list_cascade_proposals` |
| 適用・反映済みなどの更新案履歴を一覧する | `list_cascade_proposal_history` |
| 更新案Inboxを現在の正本へdry-run／収束する | `reconcile_project_cascade_proposals` |
| 更新案を適用する | `apply_cascade_proposal` |
| 更新案をまとめて適用する | `apply_cascade_proposals` |
| 更新案を採用 / 却下する | `decide_cascade_proposal` |

## 探索・品質チェック・分析

| 日本語でできること | 主なツール |
| --- | --- |
| 要求から要件、ストーリー、シナリオ、タスクまで根拠を辿る | `get_traceability` |
| 根拠や下流が欠けている箇所を確認する | `check_traceability_completeness` |
| プロジェクトの統計を確認する | `get_project_stats` |
| 週次PMレビュー (期限超過・期限間近・停滞・未アサイン・WIPの偏り・ステークホルダー待ち・トレーサビリティ欠落の要約) を取得する | `generate_weekly_pm_review` |
| 手戻りの傾向を分析する | `analyze_rework` |
| イベント履歴を一覧する | `list_events` |

## 一括操作

| 日本語でできること | 主なツール |
| --- | --- |
| 複数の作成・更新・リンク操作をまとめて実行する | `execute_operations` |

一括操作は、途中で失敗したときに中途半端な変更を残さないためのものです。大量のタスク起票、ストーリー生成後のリンク、複数コメント追加などをまとめて任せるときに使います。

## 注意が必要な操作

- **削除系** — 完全削除は履歴も失うため、通常はアーカイブを優先します。
- **版の置き換え** — シナリオやADRの置き換えは、古い版を残して新しい版へ移す操作です。単なる上書きとは違います。
- **GitHub同期** — GitHubはMCP開発フローの出口連携です。普段の管理はMCPで行い、Issue / PRとつなぐ必要があるときに使います。

<!-- pm-on-rails:mcp-tools-auto -->
## 登録済み MCP ツール（自動更新）

backend に `name="..."` で登録されたツールを、ビルド / テストのたびにここへ反映します。目的別の説明は上の表を参照してください。

- `add_comment`
- `apply_cascade_proposals`
- `approve_document`
- `archive_demand`
- `assign_project_member`
- `assign_task_to_me`
- `check_pr_quality_gate`
- `complete_task`
- `confirm_task_spec_change`
- `create_actor`
- `create_architecture_decision`
- `create_bug_task`
- `create_change_request`
- `create_cycle`
- `create_decision`
- `create_demand`
- `create_design_document`
- `create_design_folder`
- `create_epic`
- `create_requirement`
- `create_scenario`
- `create_story`
- `create_task`
- `delete_questionnaire_question`
- `execute_operations`
- `generate_weekly_pm_review`
- `get_change_request`
- `get_cycle_progress`
- `get_demand`
- `get_demand_context`
- `get_embedding_coverage`
- `get_figma_design_context`
- `get_mcp_usage_guide`
- `get_project_overview`
- `get_project_stats`
- `get_story`
- `get_task`
- `get_traceability`
- `link_epic_work_item`
- `link_pr`
- `link_story_demand`
- `list_actors`
- `list_architecture_decisions`
- `list_bugs_affecting`
- `list_cascade_proposal_history`
- `list_change_requests`
- `list_comments`
- `list_cycles`
- `list_decisions`
- `list_demands`
- `list_design_documents`
- `list_design_folders`
- `list_documents`
- `list_feedback`
- `list_project_members`
- `list_requirements`
- `list_stories`
- `list_tasks`
- `list_workspace_members`
- `promote_bug_to_requirement`
- `read_scenario`
- `reconcile_project_cascade_proposals`
- `reconcile_task_prs`
- `remove_project_member`
- `reopen_comment`
- `reopen_questionnaire_question`
- `request_document_review`
- `resolve_bug`
- `resolve_bug_destination`
- `resolve_comment`
- `resolve_questionnaire_question`
- `revert_document_version`
- `search_github_pull_requests`
- `search_similar_decisions`
- `search_similar_demands`
- `search_similar_requirements`
- `search_similar_tasks`
- `share_questionnaire_question_to_slack`
- `start_task`
- `suggest_estimate`
- `supersede_architecture_decision`
- `supersede_scenario`
- `sync_story_to_github`
- `unlink_epic_work_item`
- `unlink_story_demand`
- `update_architecture_decision`
- `update_bug_affects`
- `update_comment`
- `update_cycle`
- `update_demand`
- `update_epic`
- `update_language`
- `update_questionnaire_question`
- `update_requirement`
- `update_scenario`
- `update_scenario_status`
- `update_story`
- `update_task`
- `update_task_status`
- `upload_attachment`

---

https://pmonrails.com/docs/mcp-reference