メインコンテンツまでスキップ

別の MCP クライアントを接続する

以下の手順は、リモート MCP サーバーに対応していて、このサイトに専用ガイドがない AI エージェントやエディターに適用されます。まず開始前の準備に従い、OAuth または個人トークンを選びます。

サーバーを追加する​

  1. クライアントの MCP サーバー設定を開き、reconstruct という名前のサーバーを追加します。
  2. Streamable HTTP（HTTP または remote HTTP と表示される場合もあります）を選びます。
  3. サーバー URL を https://reconstruct.dev/mcp に設定します。

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

クライアントが OAuth の検出と Dynamic Client Registration（DCR）に対応する場合は、https://reconstruct.dev/mcp だけを追加し、OAuth を選んで接続します。クライアントは自身のコールバックを登録し、Reconstruct のサインイン画面を開いて、アクセス承認後にコールバックを自動受信します。Client ID やコールバックポートを手動で入力する必要はありません。

ホスト型アプリケーションは、https://app.example.com/mcp/callback のような公開ドメインの正確な HTTPS コールバックを登録できます。ネイティブアプリケーションは、ポートを明示した 127.0.0.1 または localhost 上の正確な HTTP コールバックを登録できます。コールバックを所有・処理するのはクライアントであり、MCP サーバーではありません。登録には PKCE S256、ユーザーの同意、MCP 専用スコープが必要です。ワイルドカード、ループバック以外の HTTP アドレス、フラグメント、リモートキー URL は拒否されます。

自動登録に対応しないクライアント​

アプリケーションが自動登録できない場合は、事前登録済みのパブリッククライアントを使用します。

  1. クライアント ID を reconstruct-mcp、スコープを openid aud-mcp にし、クライアントシークレットは空欄にします。
  2. ローカル OAuth コールバックのポートを 58234、パスを /callback に設定します。
  3. 保存して接続し、ブラウザーでサインインとアクセス承認を完了して、クライアントに戻ります。

カスタムクライアントのローカルコールバック​

自分のコンピューターのポート 58234 で待ち受け、次の正確なリダイレクト URI のいずれかを使うようクライアントを設定します。

  • http://127.0.0.1:58234/callback
  • http://localhost:58234/callback

クライアントは PKCE（S256）を使用する Authorization Code に対応している必要があります。クライアント ID は reconstruct-mcp、スコープは openid aud-mcp とし、クライアントシークレットは使用しません。サインイン時とトークン交換時に送信するリダイレクト URI は、設定した URI と完全に一致しなければなりません。

ポート 58234 はローカルのブラウザーコールバック専用です。リモート MCP サーバー URL は引き続き HTTPS の https://reconstruct.dev/mcp です。コールバックリスナーはループバックインターフェースにバインドし、このポートをネットワークに公開しないでください。同時にこのポートで待ち受けられるサインインフローは 1 つだけなので、別のサインインを開始する前に既存のものを完了します。

クライアントへの自動復帰​

MCP クライアントは、ブラウザーを開く前にローカルのコールバックリスナーを起動する必要があります。サインインと同意後、Keycloak はブラウザーをそのリスナーへリダイレクトします。クライアントは認可応答を受け取り、PKCE でコードを交換し、MCP 接続を再開します。ユーザーがコールバック URL や認可コードを手動でコピーする必要はありません。

Muse Code、Grok Build、Codex、Claude Code は、それぞれのガイドのとおり共有ポートを使用できます。Cursor や Claude Desktop のように固定コールバックを持つクライアントでは、対応するコールバックアドレスを維持します。

カスタムの C# アプリケーションでは、ClientOAuthOptions.RedirectUri を設定し、ブラウザーを開いて code、state、iss を取得する AuthorizationCallbackHandler を実装します。リダイレクト URI の設定だけではリスナーは作成されません。SDK の既定ハンドラーはリダイレクト URL の手動入力を求めます。公式 C# SDK の OAuth オプションを参照してください。

発行者は https://reconstruct.dev/sso/realms/reconstruct です。ルートの /authorize や /token URL を組み立てず、検出された認可・トークンエンドポイントを使用してください。

OAuth を選ぶ場合は、手動設定の Authorization ヘッダーを削除します。サインイン時にコールバックエラーが発生した場合は、クライアントに表示されたコールバック URI を添えてサポートに連絡してください。

個人アクセストークン​

OAuth に対応しないクライアントでは、Platform の設定で MCP トークンを作成し、HTTP の Authorization ヘッダーを Bearer <your MCP token> に設定します。対応していれば、クライアントのシークレットストアまたは環境変数 CR_RECONSTRUCT_MCP_TOKEN を使用してください。

接続を確認する​

クライアントを再接続または再起動します。ツール一覧に list_products があることを確認し、エージェントに呼び出しを依頼します。

全クライアント共通の JSON 形式はありません。mcpServers、servers、mcp などが使われ、type フィールドが必要な場合もあります。正確なフィールド名とトークンの補間構文は、クライアントのドキュメントに従ってください。古い SSE トランスポートだけに対応するクライアントは、Reconstruct の HTTP /mcp エンドポイントを SSE として使用できません。

接続に失敗した場合はトラブルシューティングの表を確認してください。接続後はプロンプトの例を試してください。