AI エージェントを接続する

Reconstruct は MCP サーバーを通じて、キャプチャーしたインターフェースデータを公開します。設定手順を確認するエージェントを選んでください。

開始前の準備

Reconstruct MCP のエンドポイントは https://reconstruct.dev/mcp で、Streamable HTTP を使用します。OAuth によるブラウザーサインイン、または個人アクセストークンで接続できます。

方法	仕組み	使用する場面
OAuth ブラウザーサインイン	MCP クライアントがブラウザーで Reconstruct のサインイン画面を開きます。サインインしてアクセスを承認し、クライアントに戻ります。Platform でトークンを作成・コピーする必要はありません。	OAuth に対応する対話型エージェントやエディター。
個人アクセストークン	Platform の設定で MCP トークンを作成し、クライアントの認証情報に追加します。	OAuth 非対応のクライアントや、ブラウザーでサインインできない自動化環境。

どちらも同じ MCP サーバーに接続し、Reconstruct アカウントのサブスクリプションと使用枠を使います。

OAuth で接続する前に、Platform で個人トークンを発行する必要はありません。

クライアントに https://reconstruct.dev/mcp をリモート HTTP MCP サーバーとして追加します。
OAuth またはブラウザーサインインを選びます。接続設定を求められたら、以下の値を使用します。
Sign in、Connect、またはクライアントの MCP ログインコマンドを開始します。具体的な操作はクライアントによって異なります。
ブラウザーで Reconstruct アカウントにサインインし、要求されたアクセスを承認します。登録できない場合は、アカウントアクセスについてサポートに連絡してください。
クライアントに戻り、ツールを更新します。接続を確認するため、list_products の呼び出しを依頼します。

設定	値
サーバー URL	`https://reconstruct.dev/mcp`
トランスポート	Streamable HTTP
OAuth クライアント ID	事前設定されたクライアントでは `reconstruct-mcp`。Claude Desktop は自動登録します
スコープ	`openid aud-mcp`
クライアントシークレット	空欄にする
OAuth 発行者	`https://reconstruct.dev/sso/realms/reconstruct`
認可エンドポイント	`https://reconstruct.dev/sso/realms/reconstruct/protocol/openid-connect/auth`
トークンエンドポイント	`https://reconstruct.dev/sso/realms/reconstruct/protocol/openid-connect/token`

クライアントはサインイン後に OAuth 認証情報を取得・保存し、MCP の呼び出しに使用します。この方法では、トークンのコピーや CR_RECONSTRUCT_MCP_TOKEN の設定は不要です。既存の接続を OAuth に切り替える場合は、手動設定の Authorization ヘッダーまたはベアラートークンの設定を削除します。

Codex、Claude Code、Cursor、Cline、OpenMausBot、その他の MCP クライアントの OAuth 設定例を参照してください。各クライアントで説明されているコールバック設定を使います。再サインインを求められた場合は、そのクライアントの MCP ログインフローを繰り返します。

クライアントの互換性

ブラウザーサインインの例は、登録済みコールバックアドレスを持つ Claude、Cursor、Claude Code、Codex、Grok Build、Muse Code を対象としています。Gemini CLI、VS Code、MiMo Code、MiMo Desktop、Hermes Agent、OpenClaw のガイドは個人アクセストークンを使用します。VS Code のガイドには、自動クライアント登録を使うワンクリックインストールもあります。Claude Desktop とウェブコネクターは、承認された正確な HTTPS コールバックによるクライアントの自動登録に対応します。OAuth の検出と Dynamic Client Registration に対応するほかのクライアントも、サーバー URL だけで接続できます。それらは自身の正確な HTTPS またはループバックコールバックを登録・処理します。DCR 非対応のクライアントでは、事前設定されたパブリッククライアントの設定も引き続き利用できます。

OAuth エンドポイントは検出メタデータから取得します。SSO realm の配下にあり、サイトルートの /authorize や /token ではありません。クライアントがルートのエンドポイントを開く場合は、サーバー設定を再読み込みしてサインインをやり直し、キャッシュされた検出情報を更新します。

Claude のクラウドコネクターでは Claude Desktop ガイドに従ってください。別のクラウド連携を接続する前に、正確なコールバック URI を添えてサポートに連絡します。reconstruct-mcp のクライアントシークレットは入力しません。

公開検出の開始点は https://reconstruct.dev/mcp/server-card です。ルートの /.well-known/api-catalog は公開 API ドキュメントを、/.well-known/agent-skills/index.json は Reconstruct ワークフローとインストール可能なアーカイブを一覧表示します。9 種類のワークフロー、別途インストール不要の MCP リソースアクセス、ウェブサイトまたは GitHub CLI でのインストール、手動ダウンロード、クライアント別プラグインパッケージは Reconstruct スキルを参照してください。リモート MCP サーバーへの接続に、ユーザーのマシン上の .NET SDK は不要です。

公開ウェブページとドキュメントは Accept: text/markdown を受け付けます。ワークスペースのページには引き続きアカウントアクセスが必要です。

OAuth Device Authorization を実装するクライアントは、https://reconstruct.dev/auth.md を読み、https://reconstruct.dev/agent/register に {"type":"anonymous"} を POST できます。応答には、保留中のデバイス認可、ユーザーの確認用 URL とコード、有効期限、ポーリング間隔、非公開の PKCE code_verifier が含まれます。確認手順をユーザーに示してください。ユーザーはサインインしてアクセスを承認する必要があります。その後、エージェントはデバイスコードの grant と返された code_verifier を使い、発行者のトークンエンドポイントをポーリングします。ポーリング間隔と slow_down 応答に従ってください。登録自体はアクセストークンの発行もアカウントの作成も行いません。既存のロール、サブスクリプションの制限、同意要件は引き続き適用されます。

デバイスコード、コード検証子、トークンを非公開にしてください。ユーザーに代わってアクセスを承認してはいけません。このフローは実装しているクライアントで利用でき、エディターの既存の Authorization Code + PKCE 設定を置き換えるものではありません。

個人アクセストークン

Reconstruct Platform にサインインし、Settings → API tokens を開きます。
MCP スコープ（mcp）を持つトークンを作成し、表示されたシークレットをコピーします。
Authorization: Bearer <token> を送信するようクライアントを設定します。環境変数からトークンを読み取る場合は、CR_RECONSTRUCT_MCP_TOKEN を使います。
接続し、クライアントに list_products の呼び出しを依頼します。

トークンはローカルのシークレットストアまたはクライアントの認証情報ストアに保存します。期限切れや失効の場合は、Platform の設定で代わりのトークンを作成し、クライアントの認証情報を更新します。

キャプチャーデータを選択する

list_products、list_platforms、list_versions から開始します。list_platforms.options.platforms[] の返された ID を使い、プラットフォームの種類と環境を選びます。list_platforms.platforms[] は実際のキャプチャーデータを持つペアを含みます。ページ用ツールには list_pages.views[] の正確な保存済み view キーを使用します。バージョンに複数の環境がある場合は environment を明示的に渡します。コンテキストツールはサブスクリプションの利用枠が必要で、キャッシュ結果を含め、受け付けられた呼び出しごとにコンテキスト読み取りを 1 回消費します。受け付け後に失敗した場合も計上されます。検出、画像ツール、アセットのダウンロードはコンテキスト読み取りを消費しません。使用制限を参照してください。

トラブルシューティング

症状	確認事項
`401 Unauthorized`	OAuth のサインインを完了するか、個人トークンを確認します。期限切れや失効の場合は置き換えてください。
`/authorize` が 404 を返す	接続メタデータを更新してサインインし直します。認可エンドポイントは `https://reconstruct.dev/sso/realms/reconstruct` の配下です。
`invalid_scope`	`openid aud-mcp` を要求します。Grok Build は任意の `offline_access` スコープも要求する場合があります。
サインイン後に認証が必要と表示される	サーバーを更新して OAuth ログインをやり直します。競合する手動設定のベアラー認証情報を削除します。
OAuth のリダイレクト不一致	クライアントの説明にあるコールバックポートを使用します。エラーが続く場合は、クライアントに表示されたコールバック URI を添えてサポートに連絡してください。
動的クライアント登録が拒否される	OAuth の自動登録を選び、1 分後に再試行します。クライアントは正確な HTTPS またはループバックのコールバックを指定し、PKCE S256 に対応する必要があります。自動登録できない場合は、そのガイドの事前設定済み OAuth 設定を使用します。
サーバーに接続できない	エージェントのマシンから `https://reconstruct.dev/mcp` に到達できることを確認します。
ツールがアクセス拒否を返す	Reconstruct アカウントでサインインし、サブスクリプションを確認します。引き続きアクセスできない場合はサポートに連絡してください。
利用枠または使用量が利用できない	アカウント設定の使用量とステータスページを確認します。アクセスが利用可能になったら再試行してください。
複数の環境がキャプチャーされている	`list_versions` から取得した `environment` を指定します。
要求したプラットフォーム／ビューが利用できない	キャプチャー済みのプラットフォーム／環境ペアと、正確な `list_pages.views[]` キーを使います。対応するオプションがあっても、保存済みデータがあるとは限りません。
ツールが表示されない	エージェントを再起動するか MCP ツール一覧を更新し、サーバー状態を確認します。

接続後、プロンプトの例を試すか、MCP ツールカタログを参照してください。

新しいキャプチャーまたは更新を依頼する

MCP サーバーには get_request_options、create_product_request、get_product_request、list_product_requests、wait_product_request があります。OAuth でサインインするか MCP アクセストークンを使います。サブスクリプションがリクエスト機能に対応している必要があり、自分のアカウントから送信したリクエストだけを閲覧できます。新しい製品 URL の送信、または既知の公開済み製品キーの更新をエージェントに依頼し、requestId を保持して審査状態の変更を待つようにします。リクエストが承認されても、キャプチャーが準備できたとは限りません。パラメーターはリクエストツールを参照してください。

開始前の準備​

ブラウザーでの OAuth サインイン​

クライアントの互換性​

エージェントの検出とデバイスサインイン​

個人アクセストークン​

キャプチャーデータを選択する​

トラブルシューティング​

新しいキャプチャーまたは更新を依頼する​