Plaro

Claude Code 版 Plaro

在 Claude Code 中查看项目已确认的需求及其变更，内容来自 Plaro。

• 读取工具 — get_requirements、get_changes、get_open_questions、get_verification_gaps、search_requirements 和 get_notices（变更通知）。
• 变更通知 — 发送消息时，Claude 会了解自上次通知以来需求发生了哪些变化（几行内容，也可能没有变化）。
• 命令 — plan_changes（针对变更规划工作）、plan_project（规划当前整个版本）、check_acceptance（验收检查前，将验收标准与代码进行比对）。
• Claude 可以在 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 即可。就这样——登录一次即可读取你账户能访问的所有项目。
• 受 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 提供的两行内容（项目 → Export → Developer AI connection）添加到仓库的指令文件（CLAUDE.md 或 AGENTS.md），这样每次会话都会先检查 Plaro，再开始构建。使用自己的账户时，第一行包含项目代码（plaro:7f3c9a12）：Claude 会用它识别项目，之后 Plaro 就能识别你正在处理的文件夹。其他项目的仓库使用该项目对应的两行内容——无需重新登录。如果没有添加这两行，Claude 会询问一次你要使用哪个项目。

受邀开发者的登录信息只能读取 PM 关联的那个项目；如需切换，请在 /mcp 中对 plaro 使用 Clear authentication，然后重新登录。

发送的内容

• 发送到 https://plaro.kr/mcp/v1：Claude 发起的工具调用、登录时获得的令牌，以及你批准 Claude 留下的内容。
• 每条消息都会通过同一个已登录连接调用 get_notices 钩子，并附上 Claude Code 正在使用的文件夹路径（Plaro 只保留该路径的带密钥指纹，以识别对应项目）。你输入的内容绝不会发送。 钩子最多等待 5 秒，绝不会阻碍你的工作。
• Plaro 只会返回 PM 写入需求版本或处理过的内容。不会返回会议或聊天文本、金额、客户端名称或联系方式。

Plaro 会将每个登录步骤和调用的记录（使用的连接或账户、工具、结果、耗时、来源地址）保留一年——绝不记录内容。

移除

/plugin uninstall plaro@plaro-ai

你自己账户的工具列在 Plaro 的账户设置 → 连接中，你可以逐个断开连接。PM 可以随时撤销受邀开发者的连接；如果某个连接连续 90 天无人使用，它会自动停止。

许可证和商标

此仓库中的文件采用 MIT 许可证（LICENSE）发布。该许可证仅适用于这些文件：Plaro 的使用受其服务条款约束，Plaro 的名称和徽标不在许可范围内。

Claude Code 是 Anthropic 的产品。此插件由 Plaro 制作，与 Anthropic 无关联，也未获得其认可或赞助。

Codex 和 ChatGPT

openai/plaro 是为 OpenAI 的插件目录打包的同一 Plaro MCP 服务，ChatGPT 和 Codex 共用该目录。它没有消息钩子（该目录不支持钩子），因此在 ChatGPT 和 Codex 中，AI 调用 get_notices 或 get_changes 时会收到变更通知——AGENTS.md 中的两行内容（参见“哪个项目”）会要求它在构建前执行此操作。在 Codex 中：

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

登录方式与上文相同：使用你的 Plaro 账户，或使用 PM 为你连接的地址。若要让 Codex 在每次调用会在 Plaro 中留下记录的工具前都征求同意，请将以下内容添加到 ~/.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）中，发生变更时会复制到公共仓库。