Uproad

Claude Code 的 Uproad 插件

在 Claude Code 中，直接把客户简报转化为客户能打开的链接。

Uproad 会通过无需登录即可查看的私密链接托管 HTML 原型，并允许评审者点击页面任意位置留下固定评论。此插件将其接入你的会话：两个技能覆盖完整流程，并为你设置好 MCP 连接。

安装

/plugin marketplace add uproad-design/uproad-plugin
/plugin install uproad@uproad

无需粘贴任何内容。技能首次需要使用 Uproad 时，Claude Code 会提示你登录：运行 /mcp，选择 uproad，再选择 Authenticate，浏览器标签页便会打开 Uproad 的授权页面。登录后，选择此连接可以访问哪些工作区（默认是全部工作区——只有在工作区多于一个时，/uproad:new 才会询问新设计要放入哪个工作区），然后即可返回会话。无需执行 claude mcp add，也无需复制令牌。

此连接会显示在 uproad.design/settings/personal-tokens 中，名称为 Claude Code（claude.ai）。在此撤销即可断开连接；下次使用时，Claude Code 会再次提示你登录。

**从 0.5 或更早版本升级：**不再使用已存储的 API 令牌。更新后运行一次 /mcp → uproad → Authenticate。（令牌仍可通过 CLI 和 GitHub Action 用于 CI。）

功能

/uproad:new

根据会议记录、Slack 消息粘贴内容或一句话的想法开始——过程中有两处需要你确认：

1. 逐个问题采访你，每个问题都提供一个推荐答案，直到需求明确不再变动。它会先读取能找到的内容，而不是询问已有答案的问题。
2. 用日语撰写规格说明——背景・目的 / 対象ユーザー / 画面と導線 / 機能要件 / 確認事項——然后暂停，等你修改。
3. 构建独立原型，在本地运行，然后暂停，等你查看。持续迭代，直到你批准。
4. 询问是要公開（客户无需账号即可打开的分享链接）还是保持非公開 （仅对已登录的工作区成员可见），然后将两者推送到 Uproad。

这些暂停环节至关重要。未经你修改的规格说明会导致原型建立在错误假设之上，而未经你查看的原型不应发给客户。

可见性问题会在推送前询问，而不是推送后：通过 MCP 工具发布只能单向进行，而要撤下设计则需在应用中切换设置。

確認事項部分有助于获得回复：所有替客户做出的假设都会写成问题，供客户回答。

原型和规格说明关联到同一个设计，因此一个链接即可访问两者——客户能看到页面，实现者日后也能看到设计原本应实现的功能。

文件存放位置

每个设计单独使用一个目录，因此多个设计可以并排存放：

designs/
  acme-lp/
    index.html
    spec.md
  billing-dashboard/
    index.html
    spec.md

本地服务从 designs/ 运行，因此可以同时浏览所有设计。

/uproad:review

收到评论后：

1. 读取尚未解决的评论，包括评论固定在页面上的位置
2. 应用修改请求；如果行为发生变化，也更新规格说明
3. 在本地运行修复后的版本，并暂停，等你检查——客户已收到链接，错误的修复会立刻呈现在他们面前
4. 推送新版本——分享链接不会改变
5. 仅将实际完成的事项标记为已解决

问题和超出范围的请求会交给你处理，而不是悄悄关闭。MCP 工具无法回复评论，因此需要在应用中作答。

要求

• 支持插件的 Claude Code
• 一个 Uproad 工作区（免费套餐即可开始使用）

访客固定评论是 Team 套餐的功能；使用 Free 和 Personal 套餐时，客户仍可打开链接，只是无法在页面上评论。

底层机制

该插件通过 https://uproad.design/mcp（Streamable HTTP，无状态）与 Uproad 的 MCP 服务通信。登录使用 OAuth 2.1：Uproad 是自己的授权服务器，通过客户端 ID 元数据文档识别 Claude Code，并将个人令牌作为访问令牌返回，因此权限或工作区方面与手动粘贴令牌没有任何区别。同一服务也可以作为自定义连接器添加到 claude.ai，任何 MCP 客户端都可以使用相同的工具——请参阅 MCP 文档，或查看命令行工具 npx uproad。

许可证

MIT