MCP の統合
OpenFactory は Model Context Protocol をサポートしているため、AI アシスタントがビルドの作成、レシピの検査、VM の管理、テスト結果のレビューを支援できます。
ツール間を行き来することなく、Claude、Cursor、Claude Code、OpenAI Codex、または別の MCP 互換クライアントから OpenFactory を操作する場合は、MCP を使用します。
要件
- リモート MCP サーバーをサポートする MCP クライアント
- アカウントに基づくアクセスの場合は、このブラウザで OpenFactory にサインインしてください
- ゲスト アクセスの場合は、以下に示す生成されたゲスト トークンを使用します。
アカウント API キーは作成時に一度表示され、コンソールから取り消すことができます。ゲスト トークンは、従量制アクセスのブラウザ識別子です。それらはアカウントの秘密ではありません。
エンドポイント
| 輸送 | URL | 使用 |
|---|---|---|
| ストリーミング可能な HTTP | https://console.openfactory.tech/mcp-stream/mcp | OpenFactory MCP エンドポイント |
サポートされているトランスポートはストリーミング可能な HTTP のみです。古い HTTP+SSE エンドポイント (/mcp/sse、/mcp/messages) は廃止され、410 Gone を返すようになりました。これらをまだ使用しているクライアントには、同じ Authorization ヘッダーを使用して、上記の Streamable HTTP URL を指定します。 Claude Code、Claude Desktop、Cursor、Codex、OpenCode はすべて、Streamable HTTP をサポートしています。
設定をコピー＆ペースト
MCP 設定を変更した後、Claude Desktop、Cursor、OpenAI Codex、またはその他の長時間実行されている MCP クライアントを再起動します。 OpenAI Codex は、~/.codex/config.toml から MCP サーバーを読み取り、Streamable HTTP に直接接続します。mcp-remote ブリッジは必要ありません。 Claude.ai カスタム コネクタは、サーバー URL とヘッダーを別個のフィールドとして要求する場合があります。
利用可能な機能
OpenFactory は、次の顧客向けツールを公開します。
| カテゴリー | 例 |
|---|---|
| ビルド | ビルドの一覧表示、レシピからビルドの作成、ビルド ステータスの確認、失敗したビルドの再試行 |
| レシピ | テンプレートの参照、レシピの検証、テンプレートのカスタマイズ |
| 画像 | 完成した成果物のダウンロード リンクを取得する |
| VM | VM の一覧表示、テスト VM の作成、VM の開始または停止、コンソール リンクのオープン |
| テスト | 検証の実行、テスト実行のリスト表示、テスト結果の検査、再利用可能なテスト スイートの管理 |
| アプリの UI テスト | テスター VM を駆動して any app URL をテストします: 再利用可能な自己強化 GUI シナリオ。デプロイは必要ありません |
| アプリの導入 | パブリック プレビュー URL を使用して Git リポジトリをライブ Web アプリにデプロイする (https://<slug>.apps.openfactory.tech) |
利用できるツールはプランや組織の権限によって異なる場合があります。
再利用可能なテスト スイート
テスト スイートは、バリアントまたは ISO が構築される前に作成できます。 1 つ定義します
1 つ以上のテスト ケース、カスタム アサーション、事前定義されたテスト、および名前付き ISO ターゲット
primary、client、server などのスロット。ビルドの準備ができたら、それぞれをバインドします
完了したビルドにスロットを追加し、スイートを実行します。
| ツール | 使用 |
|---|---|
create_test_suite | ビルドされたバリアントを必要とせずに再利用可能なスイートを作成する |
list_test_suites | 現在の MCP ユーザーが利用できるスイートをリストします。 |
get_test_suite | スイートの定義と最近の実行履歴を表示する |
update_test_suite_targets | 名前付き ISO ターゲット スロットを完了したビルドにバインドする |
run_test_suite | バインドされた ISO ターゲット スロットに対してスイートを実行する |
list_test_suite_runs | スイートから作成された実行をリストする |
get_test_suite_status | オーサリングの準備状況と最新の実行ステータスを表示する |
アプリ UI テスト: 任意の URL、デプロイなし
マネージド テスター VM を指定して user interface of any web app をテストします。 URL。 テストのために OpenFactory を使用してアプリをデプロイする必要はありません。 テスター VM ローカル開発サーバーを開き、Vercel、AWS にプレビュー/実稼働環境をデプロイします。 Netlify、任意のホスト、または VM から到達可能な任意のパブリック URL。アプリはそのまま残ります すでに実行されている場所。
シナリオは平易な言葉で書かれており、self-hardening: 最初の実行です。
各 UI 要素がどこにあるかを学習し、後でそのメモリからリプレイを実行します (スキップ
遅いビジュアルパス)。これにより、再生が高速になり、UI の小さな変更にも柔軟に対応できるようになります。シナリオのサポート
environment variables (${VAR}) および 2FA (${totp:VAR}、RFC 6238)
サインイン;シークレットは実行時に渡され、保存されることはありません。
| ツール | 使用 |
|---|---|
ensure_tester_vm | 永続デスクトップ テスター VM を取得または作成します |
create_app_scenario | アプリ URL の再利用可能な GUI シナリオを保存する |
run_app_scenario | それを実行し (ランタイム シークレットをここに渡します)、スクリーンショットと判定を記録します。 |
list_app_scenarios / get_app_scenario | シナリオとその強化されたキャッシュを参照する |
start_app_test / record_app_test_step / finish_app_test | 自分でアドホックな走行を運転して記録する |
annotate_screenshot | スクリーンショットにラベル付きのハイライト ボックスを描画します。 |
完全なワークフロー、ステップについては、App UI Testing を参照してください。 スキーマ、および 2FA の例。
アプリのデプロイメント: パブリック URL への Git リポジトリ
Web アプリを Git リポジトリから直接デプロイし、public preview URL を取得します
(https://<slug>.apps.openfactory.tech) テストを開いたり、共有したり、ポイントしたりできます
でのシナリオ。 OpenFactory はリポジトリのクローンを作成し、依存関係をインストールし、アプリを起動します。
健康状態をチェックします。接続するものは何もありません。ポート転送もありません。
トンネル、または DNS。
これはアプリ UI テストと組み合わせます。アプリをデプロイし、そのアプリに対してシナリオを実行します。 プレビュー URL を使用するか、デプロイをスキップして、すでにホストしているアプリ (Vercel、AWS など) をテストします。
| ツール | 使用 |
|---|---|
create_app | Git リポジトリをアプリとして登録 (名前、ソース、スラッグ) |
deploy_app | アプリをデプロイし、そのパブリック プレビュー URL を返します。 |
list_apps / get_app | アプリとその URL を参照し、履歴をデプロイする |
iterate_app | 自然言語の変更をアプリにディスパッチします。エージェントがそれを適用し、再デプロイします。 |
get_app_build_status | アプリのデプロイ ステータスと進行中の変更チケットをポーリングする |
完全なワークフローについては、「App Deployment」を参照してください。あなたの 自身のユーザーがマイク ボタンからアプリへの変更を発話します。を参照してください。 音声反復ウィジェット。
プロンプトの例
Show my most recent OpenFactory builds and summarize any failures.Create a Debian server image with SSH, Docker, a deploy user, and default verification tests.Validate this recipe before I start a build.Start a VM from my latest completed build and give me the console link.Create a reusable smoke test suite for example-project with primary and client ISO slots. I will bind the builds later.Create a smoke-login scenario for my app at https://my-app.vercel.app, run it in a tester VM, and verify the dashboard loads. I'll give you the password and 2FA seed at run time.セキュリティに関する注意事項
- API キーは信頼できるクライアントに対してのみ使用してください。
- マシンをローテーションするとき、またはプロジェクトを終了するときに、コンソールから古いキーを取り消します。
- ビルドの作成、VM の起動、またはインフラストラクチャの変更を行うアクションには、承認が必要なツール権限を優先します。
- OpenFactory API キーをプロンプト、チケット、パブリック リポジトリ、または共有ドキュメントに貼り付けないでください。
トラブルシューティング
ツールが表示されない
MCP クライアントを再起動し、サーバー URL が正確に次であることを確認します。
https://console.openfactory.tech/mcp-stream/mcpクライアントが廃止された /mcp/sse URL で構成されている場合、クライアントは
410 Gone: URL を上記のものに変更します。他に何も変更する必要はありません。
認証が失敗する
このページを更新し、生成された構成を再度コピーします。サインインしているユーザーは、生成された Authorization ヘッダーを使用する必要があります。ゲスト ユーザーは、上記のコピー＆ペースト設定から生成された X-Guest-Id ヘッダーを使用する必要があります。
ビルドまたは VM アクションが失敗する
OpenFactory プラン、組織の権限、ビルド ステータスを確認してください。一部のアクションには、完了したビルド、永続的な VM 資格、またはエンタープライズ権限が必要です。
トランスポートエラー
ストリーミング可能な HTTP をサポートしていない場合は、MCP クライアントを更新します。更新できない場合は、HTTP+SSE 互換エンドポイントに切り替えてください。