AppLaunchFlow

AppLaunchFlow MCP

Pro の利用枠と Automation

API と MCP のエクスポートには、有効な Pro サブスクリプションが必要です。Pro には月 5 件のエクスポートジョブが含まれ、すべての API キー、プロジェクト、MCP クライアントで共有されます。1 件のジョブには、指定した言語とデバイス形式が含まれます。年間 Pro にも毎月の利用枠が付与されます。エディターでのエクスポートには、従来の制限が適用されます。

Pro に加えて月額 €19 で Automation を追加すると、API エクスポートが無制限になります。レート制限、ジョブサイズの制限、AI 生成クレジットは引き続き適用されます。

await client.getApiUsage()（exports:read が必要）を使用して、used、remaining、unlimited、resetsAt を確認できます。月間の利用枠を使い切ると、API はコード api_export_quota_exhausted を含む HTTP 402 を返します。Pro に加入していない場合は、api_pro_required を含む HTTP 403 を返します。同じ冪等性キーで再試行しても、エクスポートは追加で消費されません。失敗したジョブとキャンセルされたジョブではクレジットが返還されます。処理結果が不確かなディスパッチは、結果が判明するまで予約された状態になります。ポーリングとダウンロードは利用枠に含まれます。

AppLaunchFlow 用 MCP サーバー — AI で App Store と Google Play のスクリーンショットを作成します。

公式 API と CI リリース

MCP と Node SDK は、バージョン管理された /api/v1 API を共有するようになりました。プロジェクト単位の API キー認証、アクティブバリアントの編集、非同期レンダリング、チェックサム検証済みダウンロードには、applaunchflow/api から AppLaunchFlow をインポートしてください。MCP の接続には、引き続きブラウザー OAuth が標準の方法です。

CI と Fastlane の例を使用してください。キャプチャとローカライズされたコピーをアクティブバリアントで直接更新し、projectId、languages、formats を指定してレンダリングします。CI キーには、アセット、デザインの読み取り／書き込み、エクスポートのスコープが必要です。HTTP API リファレンス。

リリース順序： 0.7.0 のリリースを公開またはデプロイする前に、ダッシュボード v1 API と検証用バンドラーを有効にする必要があります。

リリース順序： 0.8.0 のリリースを公開またはデプロイする前に、ダッシュボード PR #282（プレビュー、エクスポート、翻訳、検証用の新しい v1 ルート）を適用し、そのコミットから Remotion サイトを再デプロイする必要があります。

接続

Cursor マーケットプレイスプラグイン

この公開リポジトリには、.cursor-plugin/plugin.json の Cursor プラグインマニフェストと、ホスト型サービスを対象とするルートの mcp.json が含まれています。API キーもローカルサーバーも必要ありません。インストール後、Cursor の MCP 設定で AppLaunchFlow アカウントを使用して認証してください。既存のプラン制限が適用されます。プラグインをインストールしても、有料の AppLaunchFlow サブスクリプションは付与されません。

「AppLaunchFlow のプロジェクトを一覧表示して」と入力し、続けて「このプロジェクトの既存のスクリーンショットを使って、スクリーンショットのスタイルを表示して」と試してください。インタラクティブなピッカーでスタイルを選択してください。プレビューの準備によってデザインが自動選択されることはありません。同じ手順で、ソーシャルグラフィックやプロモーション動画も作成できます。アセットのアップロードと管理は、アセットブラウザーから利用できます。

すでに AppLaunchFlow を手動で設定している場合は、プラグインのインストール時に重複する MCP エントリを無効にしてください。サポート：[email protected]。

メンテナー向け：npm test で検証してから、公開リポジトリを https://cursor.com/marketplace/publish に提出してください。Cursor は、マーケットプレイスの掲載内容を npm や MCP Registry とは別に審査します。Cursor プラグインのバージョンはパッケージのリリースに連動します。リモートでホストされるサーバーは独立して更新できます。

AppLaunchFlow は、OAuth 2.1 と PKCE を使用するホスト型 MCP コネクターです。API キー、ローカルトークン、スコープ付き npm パッケージ名は必要ありません。

Codex

最短のセットアップコマンドで、ホスト型コネクターを設定し、OAuth を開始できます。

npx -y applaunchflow connect codex

セットアップ後に便利なコマンド：

npx -y applaunchflow status
npx -y applaunchflow disconnect

同等のネイティブ Codex コマンド：

codex mcp add applaunchflow --url https://mcp.applaunchflow.com/mcp
codex mcp login applaunchflow
codex mcp get applaunchflow
codex mcp remove applaunchflow

Claude Code

Claude Code でも、同じワンコマンドセットアップを利用できます。必要に応じて従来の AppLaunchFlow エントリを置き換え、ホスト型 HTTP コネクターを追加して、OAuth サインインを開始します。

npx -y applaunchflow connect claude

同等のネイティブ Claude Code コマンド：

claude mcp add --transport http applaunchflow https://mcp.applaunchflow.com/mcp
claude mcp login applaunchflow

ChatGPT

npx -y applaunchflow connect chatgpt

ChatGPT でカスタム MCP コネクターを作成する際に、表示された URL を貼り付けてください。 同じ URL は、いつでも npx -y applaunchflow url で確認できます。

その他の MCP クライアント

この Streamable HTTP エンドポイントを使用し、プロンプトが表示されたら OAuth を有効にしてください。

https://mcp.applaunchflow.com/mcp

Claude Code プラグイン

このリポジトリは、配布可能な Claude Code プラグインでもあります。 .claude-plugin/plugin.json マニフェストには、.mcp.json のホスト型 OAuth コネクターが含まれているため、ユーザーがサーバー設定を手動でコピーする必要はありません。

クローンからプラグインを直接検証または試すには、次のコマンドを実行してください。

claude plugin validate . --strict
claude --plugin-dir .

Claude Code は、プラグインが有効になるとホスト型コネクターを起動し、認証が必要な場合は AppLaunchFlow の OAuth フローを開きます。

ホスト型サービス

エディターのナレッジと設定リファレンス

MCP コネクターは、ユーザーのモデルをトレーニングしたり置き換えたりするものではありません。サーバーの指示、読み取り／編集ツール、および必要に応じて参照できる設定リファレンスを提供します。 編集を行う前に、指示に従ってアシスタントは get_editing_reference(feature) を呼び出し、次に関連する名前付きシンボルを取得します。 これは、MCP リソースの参照機能を公開していないクライアントでも機能します。

対応する機能は screenshots、socialGraphics、promoVideo、mockups です。 インデックスには、永続化される型、API／レンダラーのバリデーター、デバイス／フォーマット／音楽／モーションのカタログ、単位、範囲、デフォルト値、および読み取り後に保存するワークフローがすべて含まれています。 例：オーバーフロー／クロップ／ステータスバー用の ScreenshotNode、ノート PC の蓋用の Model3DConfig、プロモーション動画のスロット配列用の MultiPhoneContentSchema、個別のデバイス入場／退場用の mockupDeviceSchema です。 完全なリファレンスは applaunchflow://editing/<feature> でも利用できます。既存のレイアウトおよび動画設定のリソース URL からも、これらの最新リファレンスを参照できます。

チェックイン済みのリファレンスは、ダッシュボードのコントラクトを明示的に許可リストにしたものから生成されています。プロジェクトデータやシークレットは含まれておらず、実行時にダッシュボードのチェックアウトへ依存することもありません。ダッシュボードのリリースに合わせて更新し、検証するには、次のコマンドを実行してください。

APPLAUNCHFLOW_DASHBOARD_PATH=../applaunchflow npm run sync:editor-reference
APPLAUNCHFLOW_DASHBOARD_PATH=../applaunchflow npm run check:editor-reference
npm test

エディターのコントラクトが変更されたとき、およびダッシュボードのリリースに合わせてコネクターを公開する前に、ドリフトチェックを実行してください。MCP テストに合格しても、デプロイされたダッシュボードがスナップショットと一致することの証明にはなりません。選択、取り消し、ブラウザーでのレンダリング、録画用カメラ入力などの UI のみの操作は永続化される設定ではないため、MCP ツールとして案内してはいけません。モデルは間違える可能性があるため、関係のないフィールドを保持し、保存後に読み戻し、プレビューを利用できる場合は視覚的な構成を確認してください。

インラインのスクリーンショットピッカー

prepare_screenshot_styles は、MCP Apps 対応ホストでパーソナライズされた V1/V2 ピッカーを直接返し、認証済みツールブリッジを通じてユーザーが明示的に確認した後にのみバリアントを作成します。その他のホストでは、ギャラリー全体へのリンクが引き続き表示されます。既存のウィジェットまたはそのリンクを使って、準備済みのオプションを再度表示してください。別途レンダーツールを呼び出す必要はありません。ソーシャルグラフィックとプロモーション動画も、同じ準備して表示するフローを使用します。 ローカルでのテストとデプロイに関するメモを参照してください。

公開 Streamable HTTP サービスは、AppLaunchFlow ダッシュボードを通じて PKCE を使用する OAuth 2.1 認可コードフローを利用します。

npm ci
npm run build
APPLAUNCHFLOW_BASE_URL=https://dashboard.applaunchflow.com \
APPLAUNCHFLOW_MCP_PUBLIC_URL=https://mcp.applaunchflow.com \
PORT=8787 \
npm run start:http

公開エンドポイント：

• MCP：https://mcp.applaunchflow.com/mcp
• 保護されたリソースのメタデータ：https://mcp.applaunchflow.com/.well-known/oauth-protected-resource
• ヘルスチェック：https://mcp.applaunchflow.com/healthz

公式 MCP レジストリ

AppLaunchFlow は、公式 MCP レジストリに io.github.ynnickw/applaunchflow として公開されています。チェックイン済みの server.json は正式なレジストリマニフェストであり、ホストされた OAuth コネクターをクライアントに案内します。

レジストリへの公開は、main のマニフェストが変更されると GitHub Actions によって自動的に実行されます。マニフェストのバージョンを package.json と一致させてください。公開前にテストスイートで確認されます。

APPLAUNCHFLOW_MCP_PUBLIC_URL には、オリジンまたは完全な /mcp URL のどちらも指定できます。どちらのサービスも同じ正式なリソース URL に正規化します。ダッシュボードでは、APPLAUNCHFLOW_MCP_PUBLIC_URL=https://mcp.applaunchflow.com/mcp と NEXT_PUBLIC_APP_URL=https://dashboard.applaunchflow.com を設定してください。

同梱の Dockerfile は、ホストサーバー用の非 root OCI イメージを生成します。本番環境では、MCP ホストとダッシュボードの両方をパブリックな HTTPS 経由で提供する必要があります。TLS を終端するプラットフォームまたはリバースプロキシを使わずに、Node プロセスを直接公開しないでください。

パーソナライズされたスタイルのワークフロー

選択したアプリのスクリーンショット用に、スクリーンショットとソーシャルグラフィックのスタイルを一度準備しておき、選んだスタイルをキャッシュから適用します。これにより、ユーザーはスタイルを選ぶたびに別の AI 呼び出しに費用をかけずに、スタイルを比較できます。

App Store のスクリーンショットの場合：

1. list_source_screenshots
2. 3～7 個のパスを順番に指定して prepare_screenshot_styles
3. パーソナライズされたギャラリーが自動的に開きます。各テンプレートの V1/V2 のレンダリングを比較して選択を確定すると、ギャラリーがキャッシュから新しいバリアントを作成し、エディターを開きます。

browse_templates で準備済みのカタログを再度開くことができ、API クライアントがテンプレート ID を直接指定する場合は、引き続き apply_screenshot_style を利用できます。

ソーシャルグラフィックの場合：

1. list_source_screenshots
2. 3～7 個のパスを順番に指定して prepare_social_graphics_styles
3. 結果画面にピッカーが開きます。ユーザーがそこでテンプレートとパレットを選択すると、その選択に基づいてすべてのフォーマットのバリアントが作成され、グラフィックエディターが開きます。

browse_social_templates で準備済みのカタログを再度開くことができます。apply_social_graphics_style は、API クライアントまたはユーザーがテンプレート ID を直接指定する場合に使用します。エージェントは、スタイルを準備した後にこれを呼び出しません。

スクリーンショットの結果には、スマートフォン、タブレット、デスクトップ向けが含まれます。ソーシャルの結果には、サポートされているすべてのソーシャル、ストア掲載、モバイル広告のフォーマットが含まれます。新しいスクリーンショットとソーシャルグラフィックのバリアントは、必ずビジュアルピッカーを経由し、ユーザーがテンプレートとパレットを明示的に選択します。

スコープ、プラン、上限

get_capabilities は、領域ごとにこのサーバーが公開するツールとエディターの URL を一覧表示し、ダッシュボードでのみ実行できるすべての操作（ストアへの公開、ストア接続、カスタム商品ページ、A/B テスト、レビュー、アプリアイコン、ウェブサイト、エクスポート履歴、コラボレーター、QR コード、API キー、請求）と、それぞれのディープリンクも表示します。プロジェクトへのリンクには projectId を渡します。get_plan_usage は月ごとの API エクスポート枠を報告し、projectId を指定した場合はキーワードと競合アプリの上限も報告します。

プランやクォータによる拒否（VARIANT_LIMIT_REACHED、PROJECT_LIMIT_REACHED、 keyword_limit、competitor_limit、翻訳の利用制限、api_export_quota_exhausted、 api_pro_required）では、retryable: false、ガイダンス、 upgradeUrl を含む error.recovery が返されます。再試行可能としてマークされるのは HTTP 429 のみです。

この領域のその他のツール：

• ストア掲載文：get_store_listing、generate_store_listing、 update_store_listing（渡されたフィールドのみをマージし、ストアの 文字数制限を適用します）、translate_store_listing。
• キーワード：add_keywords は、プロジェクトにリンクされた アプリからストアとアプリを特定します。その他に、remove_keywords、 suggest_keywords、add_keyword_competitors、 remove_keyword_competitors、suggest_keyword_competitors があります。
• バリアント：create_variant は空のバリアントを作成し、有効化はしません。 duplicate_variant はコンテンツを複製し、エディター URL を返します。 set_active_variant は空のバリアントを拒否します。delete_variant には confirm: true が必要です。
• create_project は appStore（Apple ID または apps.apple.com の URL）を受け取り、 名前、カテゴリ、説明、アイコンをインポートしてアプリをリンクできます。
• generationId を受け取るツールは projectId も受け取ります。どちらもプロジェクト ID です。

リリース

1. リリース対象のダッシュボードのコミットに合わせてエディターの参照情報を再同期し、 差分を確認します： APPLAUNCHFLOW_DASHBOARD_PATH=../applaunchflow npm run sync:editor-reference
2. すべてのマニフェストのバージョンを更新します（scripts/release-consistency.mjs を参照）。
3. APPLAUNCHFLOW_DASHBOARD_PATH=../applaunchflow npm run release:preflight で、そのダッシュボードに対する参照情報を確認し、新しいバージョン用の editor-reference.lock.json を作成します。参照情報が古い場合は処理を中止します。
4. npm test を実行し、ロックファイルを含めてコミットしてマージします。

CI と npm 公開ワークフローでは release-preflight.mjs --verify が実行されます。 これは、バージョンの増加に対して、そのバージョンと参照コンテンツに正確に対応する ロックファイルが作成されていない場合、処理を中止します。ダッシュボードのリポジトリでは 逆方向のチェック（そのリポジトリで npm run check:mcp-editor-reference）が実行されるため、 ダッシュボードのコントラクトに変更があると、MCP の再同期前に検出されます。

開発

npm ci
npm run dev

公開またはデプロイする前に npm test を実行してください。 最終的な OpenAI 提出チェックリストと手動テストケースについては、 docs/openai-submission.md を参照してください。

埋め込み型のプロジェクトおよびアセット一覧

list_projects では、アプリアイコン、明示的なプロジェクト選択、ダッシュボードへのリンクを含むコンパクトな一覧を表示します。list_assets では、ダッシュボードの Hub と同じブラウザーコンポーネントを使用して、アップロード済みのスクリーンショット、イラスト、アイコン、録画、背景、フォント、音楽／クリップを表示します。アップロードボタンでは、1 回のバッチにつき最大 10 ファイル（1 ファイルあたり 25 MB）を受け付け、進行状況を表示し、完了後に一覧を更新します。スクリーンショットは選択したデバイス／プラットフォームのフォルダーに保存されます。その他のアップロードは、選択したアセットタブに保存されます。アップロードされるのはファイルのみです。アプリアイコンの置き換え、デザインの適用、フォントファミリーの登録、既存アセットの上書きは行いません。アセットの削除には、引き続き Hub で明示的な確認が必要です。

アプリ専用の prepare_asset_upload ツールは、接続済みのアカウントを使用して、一意の名前を持つストレージオブジェクトへのアクセスを許可します。署名付き URL は、ウィジェットのメタデータ（以下で説明する Cursor 互換フォールバックを含む）で返されます。ブラウザーはファイルの内容をストレージに直接送信します。ファイルの内容もアカウントの認証情報も、モデルを経由しません。更新時には、読み取り専用の list_assets ツールが呼び出されます。一覧を開いただけでアップロードが実行されることはありません。

プロジェクトの選択には標準の MCP Apps メッセージングを使用します。ホストがテキストメッセージングを通知しない場合は、ChatGPT のネイティブ sendFollowUpMessage ブリッジを使用します。どちらにも対応していないホストでは、従来どおりコピー＆ペーストのフォールバックが使われます。送信に失敗した場合や結果が不明確な場合に、別のブリッジを使って自動的に再試行することはありません。

現在、Cursor はツール結果の _meta を埋め込みアプリに渡す前に削除します。Cursor/ ユーザーエージェントを含む HTTP リクエストに対して、コネクターは既知の 7 種類のウィジェットペイロードのみを structuredContent.widgetDataJson に複製します。5 つすべてのウィジェットは _meta を優先し、この構造化フォールバックも受け付けます。アセットフォルダーやアップロードのレスポンスも対象です。構造化コンテンツはモデルから見える場合があるため、任意のメタデータやアカウントの認証情報をこの許可リストに追加しないでください。ChatGPT と Claude では、従来どおりメタデータのみが配信されます。ダッシュボードのハーネスで ?picker=projects&scenario=cursor を指定して、メタデータが削除された場合の動作をテストしてください（assets、screenshots、social、promo にも対応しています）。

メンテナーは、npm run sync:dashboard -- /absolute/path/to/dashboard を実行して、パッケージ化された一覧ビューと共有コントラクトを再生成してください。--check を追加すると、コネクターのアーティファクトを更新せずに、一致しているかどうかを確認できます。npm test は、別のチェックアウトやネットワークを必要とせずに、アーティファクトの整合性とコントラクトのハッシュを確認します。既存のスクリーンショット、ソーシャル、プロモのピッカーの動作に変更はありません。

ホスト型 MCP ランタイムのメトリクス

必須のホスト型 $mcp_tool_call イベントを記録するには、APPLAUNCHFLOW_MCP_POSTHOG_KEY（個人用 API キーではなく、PostHog プロジェクトトークン）と APPLAUNCHFLOW_MCP_POSTHOG_HOST（例：https://eu.i.posthog.com）の両方を設定してください。ダッシュボード／ランディングページのイベントを受信するプロジェクトと同じプロジェクトの取り込みホストを使用してください。いずれかの変数が設定されていない場合、またはホストが無効な場合、ホスト型サーバーは起動しません。ローカルの stdio 呼び出しには、検証済みのホストアカウント ID がないため、含まれません。

イベントには、認証済みトークンのイントロスペクションで返されたアカウント ID を使用し、ツール名、クライアントの種類、所要時間、結果、固定のエラーカテゴリのみを含めます。引数、出力、アセット URL、プロンプト、ベアラートークン、プロジェクトの内容は含めません。記録はバックグラウンドで実行され、上限が設けられています。分析機能が利用できない場合も、ツールの再試行や結果の変更は行いません。既存の Railway ログは引き続き利用できます。ステートレスなリクエストからセッションやエージェントの意図によるグループ化を推測することはありません。

長時間実行されるスタイル生成では、MCP リクエストに進行状況トークンが含まれている場合、進行状況が送信されます。クライアントは進行状況をリクエストし、受信時にタイムアウトをリセットする必要があります。ただし、クライアント側で固定された期限により、呼び出しが終了する場合があります。生成が完了したかどうか不確かな場合は、再試行の前にプロジェクト／カタログの状態を確認してください。レンダリングでは、元の冪等性キーを再利用し、ジョブが終端状態になるまで get_release_render をポーリングしてください。受付が確認されたことだけでは、パッケージの生成に成功したとは限りません。

中断されたスクリーンショットのアップロード

upload_screenshots は、アップロードが完了した各ファイルについて、0 始まりの sourceIndex と fileIndex、元の sourceFilename、保存先の path、および folderAssigned を返します。フォルダーの割り当ては、ファイルごとにミューテーションを消費するのではなく、最大 50 個のパス単位でアップロード後に実行されます。

バッチが未完了の場合は、recovery.phase、失敗したソースとファイルのインデックス、および recovery.nextStep が含まれます。失敗したソースと残りのソースのみを再試行してください。フォルダーの割り当てだけが失敗した場合は、再アップロードせず、未割り当てのパスに対して move_assets を使用してください。pendingUpload または pendingOverwrite は、再試行する前に書き込み結果の確認が必要であることを示します。復旧診断では、署名付きアップロード URL やソース URL は返されません。クォータ超過（HTTP 402）は、ツールのテレメトリーでは payment_required / api_4xx に分類されます。

独立したスマートフォン形式のレイアウト

get_layout には、メインのスマートフォンレイアウトとは別に編集されたサイズの format_layouts が含まれます。mobile を編集しても、これらの独立したデザインは意図的に保持されます。Duo Open を編集するには、まず言語とバリアントを読み取り、次に formatId: "ios-duo-inner" とオペレーション（layouts は省略）を指定して transform_layout を呼び出します。そのサイズをメインデザインに戻すには、formatId、resetFormat: true、オペレーションなし、および最新の読み取りレシートを指定して同じツールを呼び出します。save_layout では、完全な formatLayouts マップも受け付けます。既存のオーバーライドを保持するには省略し、{} を指定するとすべてのオーバーライドがリセットされます。list_export_formats には ios.phone.duo-inner と ios.phone.duo-outer が含まれます。プリセットのエクスポートでは、エディターと同じ保存済み形式が使用されます。ストアの検証を通過した Fastlane エクスポートでは、引き続き iOS の画像数は 10 枚までです。

App Store のクリエイティブ編集

Product Page Header（3840×1646）と Search Results Creative（1920×1280）では、ソーシャルデザインと同じグラフィックツールを使用します。スタイルの準備、閲覧、適用を行ってから、get_graphics_format で読み取り、最新の読み取りレシートを渡して、編集済みレイアウト全体を save_graphics_format で保存します。テキスト、画像、ロゴ、デバイスフレーム、背景、位置は引き続き編集できます。保存すると、既存の結果プレビューウィジェットが返されます。他の形式は保持されます。ヘッダーの準備ではスクリーンショットが 1～7 枚、それ以外の形式では 3～7 枚必要です。これらのツールが編集するのは AppLaunchFlow 内のデザインであり、公開済みの App Store リスティングではありません。