Uproad

Claude Code 用 Uproad プラグイン

クライアントの概要から、クライアントが実際に開けるリンクを作成できます。Claude Code を離れる必要はありません。

Uproad は、アカウントなしで閲覧できる非公開リンクを通じて HTML プロトタイプをホストします。また、レビュー担当者はページ上の任意の場所をクリックして、ピン留めコメントを残せます。このプラグインをセッションに連携すると、一連の作業を網羅する 2 つのスキルと、セットアップ済みの 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 の貼り付け、または一行のアイデアから、途中で 2 回、作業を止めて確認できます。

1. 要件が固まるまで、一度に 1 つずつ質問します。それぞれに推奨回答が示されます。また、確認できる情報については質問せずに読み取ります。
2. 日本語で仕様書（背景・目的 / 対象ユーザー / 画面と導線 / 機能要件 / 確認事項）を作成し、あなたが修正できるようにそこで停止します。
3. 自己完結型のプロトタイプを構築してローカルで配信し、あなたが確認できるようにそこで停止します。承認するまで、このループを続けます。
4. Uproad にプッシュする前に、公開（クライアントがアカウントなしで開ける共有リンク）するか、非公開のままにするかを尋ねます。 （非公開の場合、ワークスペースにサインインしたメンバーだけが閲覧できます。）

作業を止めて確認することが重要です。修正していない仕様書からは誤った前提に基づくプロトタイプができてしまいます。また、確認していないプロトタイプをクライアントに届けるべきではありません。

公開範囲を尋ねるのはプッシュの後ではなく前です。MCP ツールで公開すると取り消せず、デザインを非公開に戻すにはアプリで切り替える必要があります。

確認事項のセクションが、クライアントからの返信を引き出します。クライアントに代わって置いた前提はすべて、クライアントが回答できる質問として記載されます。

プロトタイプと仕様書は同じデザインに紐づくため、1 つのリンクから両方にアクセスできます。クライアントは画面を確認でき、後から実装する担当者は、本来どのように動作するはずだったのかを確認できます。

ファイルの保存先

デザインごとにディレクトリが作成されるため、複数のデザインを並べて保存できます。

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 では、クライアントは引き続きリンクを開けますが、ページ上にコメントすることはできません。

内部の仕組み

このプラグインは、Uproad の MCP サーバー https://uproad.design/mcp（Streamable HTTP、ステートレス）と通信します。サインインには OAuth 2.1 を使用します。Uproad は独自の認可サーバーとして機能し、Client ID Metadata Document によって Claude Code を識別して、個人用トークンをアクセストークンとして返します。そのため、権限やワークスペースに関しては、手動で貼り付けるトークンと何も変わりません。同じサーバーは claude.ai にカスタムコネクターとして追加でき、同じツールを任意の MCP クライアントから利用できます。詳しくは MCP ドキュメント、またはコマンドライン向けの npx uproad をご覧ください。

ライセンス

MIT