Plaro

Claude Code 向け Plaro

プロジェクトで合意した要件と変更内容を、Plaro から Claude Code で確認できます。

• 読み取り用ツール — get_requirements、get_changes、get_open_questions、get_verification_gaps、search_requirements、get_notices（変更通知）。
• 変更通知 — メッセージを送ると、前回の通知以降に要件で変更された内容を Claude に知らせます（数行、または何もありません）。
• コマンド — plan_changes（変更内容に基づいて作業を計画します）、plan_project（現在のバージョン全体を計画します）、check_acceptance（受け入れ確認の前に、受け入れ基準とコードを照合します）。
• Plaro に反映できる内容 — 呼び出しごとに承認が必要です — ask_pm（要件に答えがない質問）、report_built（どの要件を実装したかをコミットとともに報告します）、ご自身の Plaro アカウントでの mark_checks（合格を確認した受け入れチェック）。Claude Code は、どの権限モードでも毎回確認を求め、「次回から確認しない」という選択肢はありません。確認できない実行（claude -p）では、これらの操作は拒否されます。ここから変更できるのはこれらだけです。要件、バージョン、クライアントの確認、金額、日付は Plaro に保持されます。

インストールしてサインインする

Claude Code で次を実行します。

/plugin marketplace add plaro-kr/plaro-ai
/plugin install plaro@plaro-ai

次に /mcp を開き、plaro を選んでサインインします。ブラウザーで Plaro のサインインページが開きます。

• ご自身の Plaro アカウント（ご自身でプロジェクトを構築する場合、またはチームに所属している場合）：ブラウザーで Plaro にサインイン済みであれば、Allow を押します。これだけで完了です。サインインは 1 回で、アカウントからアクセスできるすべてのプロジェクトを読み取れます。
• PM から招待された場合（Plaro アカウントをお持ちでない場合）：PM が接続したメールアドレスと、そこに送信された 6 桁のコードを入力し、プロジェクトを選びます。

コピーするキーはありません。Claude Code はサインイン情報をコンピューターの安全なストレージに保存し、自動で更新します。サインインは 30 日間有効です。その後はブラウザーで再度サインインを求められます。

サインインするまで、Claude Code ではサーバーに認証が必要と表示され、メッセージフックはメッセージごとにエラーを報告します。/mcp からサインインしてください。ブラウザーのないコンピューターでは、Claude Code に表示されるアドレスをコピーしてください。リダイレクトに失敗した場合は、ブラウザーのアドレスバーに表示された完全なアドレスを Claude Code に貼り付けてください。

プラグインか、手動で追加したサーバー（claude mcp add … plaro https://plaro.kr/mcp/v1）のどちらかを使い、両方は使わないでください。両方ある場合、Claude Code は手動で追加した方を保持し、プラグインのサーバーを非表示にするため、プラグインのメッセージフックはメッセージごとにエラーを報告します。以前に手動で追加した場合は、先に削除してください。

claude mcp remove plaro -s user

プロジェクトの選択

Plaro が表示する 2 行（プロジェクト → Export → Developer AI connection）を、リポジトリの指示ファイル（CLAUDE.md または AGENTS.md）に追加してください。そうすると、すべてのセッションで、実装前に Plaro を確認するようになります。ご自身のアカウントでは、1 行目にプロジェクトコード（plaro:7f3c9a12）が含まれます。Claude はこのコードでプロジェクトを特定し、その後、Plaro は作業するフォルダーとプロジェクトを関連付けます。別のプロジェクトのリポジトリには、そのプロジェクトの 2 行を追加します。新たにサインインする必要はありません。行を追加していない場合、Claude は一度だけプロジェクトを確認します。

招待された開発者のサインインで読み取れるのは、PM が接続した 1 つのプロジェクトです。切り替えるには、/mcp で plaro の Clear authentication を使い、もう一度サインインしてください。

送信される内容

• https://plaro.kr/mcp/v1 には、Claude が行うツール呼び出し、そのサインインのトークン、および Claude に反映を承認した内容が送信されます。
• メッセージごとに、フックは同じサインイン済み接続を通じて get_notices を呼び出し、Claude Code が作業しているフォルダーの情報を送信します（Plaro はプロジェクトを特定するため、その情報を鍵付きのフィンガープリントとしてのみ保持します）。入力した内容が送信されることはありません。 フックの待機時間は最大 5 秒で、作業を妨げることはありません。
• Plaro から返されるのは、PM が要件のバージョンに追加した内容、または処理した内容だけです。会議やチャットのテキスト、金額、クライアント名、連絡先は含まれません。

Plaro は、各サインイン手順と呼び出しについて（どの接続またはアカウントか、どのツールか、結果、所要時間、接続元アドレス）を 1 年間記録します。内容は記録しません。

削除

/plugin uninstall plaro@plaro-ai

ご自身のアカウントのツールは、Plaro のアカウント設定 → 接続に表示されており、それぞれ接続を解除できます。PM は招待した開発者の接続をいつでも取り消せます。90 日間誰も使わなかった接続は、自動的に停止します。

ライセンスと商標

このリポジトリ内のファイルは MIT License（LICENSE）の下で公開されています。これはこれらのファイルのみを対象とします。Plaro の利用には Plaro の利用規約が適用され、Plaro の名称とロゴはライセンス対象ではありません。

Claude Code は Anthropic の製品です。このプラグインは Plaro が作成したものであり、Anthropic とは提携、推奨、協賛の関係にありません。

Codex と ChatGPT

openai/plaro は、OpenAI のプラグインディレクトリ向けにパッケージ化された、同じ Plaro MCP サーバーです。このディレクトリはメッセージフックを受け付けないため、ChatGPT と Codex では、AI が get_notices または get_changes を呼び出したときに変更通知が表示されます。AGENTS.md の 2 行（「対象プロジェクト」を参照）では、ビルド前に呼び出すよう指示しています。Codex では以下のとおりです。

codex plugin marketplace add plaro-kr/plaro-ai
codex plugin add plaro@plaro-ai
codex mcp login plaro

サインイン方法は上記と同じです。ご自身の Plaro アカウント、または PM が接続したアドレスを使用します。Plaro 内の情報を外部に送信する各呼び出しの前に Codex に確認させるには、~/.codex/config.toml に以下を追加します。

[plugins."plaro@plaro-ai".mcp_servers.plaro]
default_tools_approval_mode = "writes"

構成

• .claude-plugin/marketplace.json — このリポジトリをプラグインマーケットプレイス（plaro-ai）として登録します。
• plugins/plaro/.claude-plugin/plugin.json — プラグインです。
• plugins/plaro/.mcp.json — MCP サーバーです（OAuth サインイン、キー不要）。
• plugins/plaro/hooks/hooks.json — メッセージフックです（type: "mcp_tool"、get_notices を呼び出します）。
• openai/plaro/plugin.json · openai/plaro/mcp.json · openai/plaro/assets/ — OpenAI のプラグインディレクトリ（ChatGPT と Codex）向けパッケージです。掲載情報、レビュー用ケース、フックなしのリモート MCP サーバーが含まれます。
• .agents/plugins/marketplace.json — このリポジトリを Codex プラグインマーケットプレイスとして登録します。
• LICENSE — MIT です。

このフォルダーは Plaro のメインリポジトリ（integrations/claude-plugin）に置かれており、変更時に公開リポジトリへコピーされます。