AppLaunchFlow

AppLaunchFlow MCP

Pro 配额与自动化

API 和 MCP 导出需要有效的 Pro 订阅。Pro 每月包含 5 个导出任务，由所有 API 密钥、项目和 MCP 客户端共享。一个任务包含所请求的语言和设备格式。年度 Pro 也可获得每月配额。编辑器导出仍沿用现有限制。

在 Pro 基础上，每月支付 €19 即可添加 Automation，享受无限 API 导出。速率限制、任务大小限制和 AI 生成额度仍然适用。

使用 await client.getApiUsage()（需要 exports:read）检查 used、remaining、unlimited 和 resetsAt。月度配额用尽时，API 返回 HTTP 402，错误代码为 api_export_quota_exhausted；未订阅 Pro 时，API 返回 HTTP 403，错误代码为 api_pro_required。使用相同的幂等键重放请求不会额外消耗导出额度。失败和取消的任务会返还额度；结果未确定的分发请求会保留额度，直到确认结果。轮询和下载均已包含在内。

用于 AppLaunchFlow 的 MCP 服务——借助 AI 创建 App Store 和 Google Play 截图。

官方 API 与 CI 发布

MCP 和 Node SDK 现在共用版本化的 /api/v1 API。导入 applaunchflow/api 中的 AppLaunchFlow，即可使用项目级 API 密钥身份验证、编辑活动变体、异步渲染和经校验和验证的下载。连接 MCP 的常规方式仍为浏览器 OAuth。

使用 CI 和 Fastlane 示例。直接在活动变体中更新截图和本地化文案，然后使用 projectId、languages 和 formats 进行渲染。CI 密钥需要资产、设计读写和导出权限范围。HTTP API 参考。

发布顺序： 发布或部署此 MCP/SDK 版本之前，必须先启用 0.7.0 所需的仪表板 v1 API 和验证型打包器。

发布顺序： 发布或部署此版本之前，必须先合并仪表板 PR #282（新增预览、导出、翻译和验证的 v1 路由），并从该提交重新部署 Remotion 网站。

连接

Cursor 市场插件

此公开仓库包含位于 .cursor-plugin/plugin.json 的 Cursor 插件清单， 以及指向托管服务的根目录 mcp.json。无需 API 密钥或本地服务。 安装后，请在 Cursor 的 MCP 设置中使用你的 AppLaunchFlow 账户 授权 AppLaunchFlow。现有套餐限制仍然适用；安装插件不会 为你开通付费的 AppLaunchFlow 订阅。

试试“列出我的 AppLaunchFlow 项目”，然后试试“使用此项目现有的截图 展示截图样式”。在交互式选择器中选择样式； 准备预览不会替你选择设计。同一流程也支持社交媒体 图片和宣传视频。可通过资产浏览器上传和管理资产。

如果你已经手动配置了 AppLaunchFlow，安装插件时请停用重复的 MCP 条目。 支持邮箱：[email protected]。

维护者：使用 npm test 进行验证，然后在 https://cursor.com/marketplace/publish 提交公开仓库。Cursor 对市场列表的审核 独立于 npm 和 MCP Registry。Cursor 插件版本对应其打包版本； 远程托管的服务可以独立更新。

AppLaunchFlow 是一个托管式 MCP 连接器，使用 OAuth 2.1 和 PKCE。无需 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。随时也可通过 npx -y applaunchflow url 获取同一 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，用于笔记本电脑盖的 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 工具。模型仍可能出错：保留无关字段，保存后读回，并在有预览时验证视觉排版。

内嵌截图选择器

在兼容 MCP Apps 的宿主中，prepare_screenshot_styles 会直接返回个性化的 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 供直接提供模板 ID 的 API 客户端或用户使用。Agent 在准备好样式后不会调用它。

截图结果包含手机、平板和桌面端。社交图形结果包含所有受支持的社交平台、商店列表和移动广告格式。新的截图和社交图形变体始终通过视觉选择器生成，以便用户明确选择模板和调色板。

范围、套餐和限额

get_capabilities 会按领域列出此服务公开的工具和编辑器 URL，以及只能在控制面板中完成的所有操作（商店发布、商店连接、自定义产品页面、A/B 测试、评论、应用图标、网站、导出历史记录、协作者、二维码、API 密钥、账单），并为每项操作提供深层链接。传入 projectId 可获取项目链接。get_plan_usage 会报告每月 API 导出额度；传入 projectId 时，还会报告关键词和竞品限额。

套餐和配额限制导致的拒绝（VARIANT_LIMIT_REACHED、PROJECT_LIMIT_REACHED、 keyword_limit、competitor_limit、翻译限制、api_export_quota_exhausted、 api_pro_required）会返回 error.recovery，其中包含 retryable: false、操作指引 和 upgradeUrl。只有 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 相同。“上传”按钮每批最多接受 10 个文件（每个文件 25 MB），并显示进度，完成后刷新列表。截图会使用所选的设备/平台文件夹；其他上传内容会使用所选的素材选项卡。上传只会存储文件：不会替换应用图标、应用设计、注册字体系列或覆盖现有素材。在 Hub 中，删除素材仍需明确确认。

仅限应用使用的 prepare_asset_upload 工具会使用已连接的账户，为一个名称唯一的存储对象授权。其签名 URL 会在组件元数据中返回（并提供下文所述的 Cursor 兼容回退机制）。浏览器会直接将文件字节发送到存储端；文件内容和账户凭据都不会经过模型。刷新会调用只读的 list_assets 工具。仅仅打开列表不会触发上传。

项目选择使用标准 MCP Apps 消息机制；如果宿主未声明支持文本消息，则使用 ChatGPT 原生的 sendFollowUpMessage 桥接机制。既不支持这两种机制的宿主仍会使用原样的复制/粘贴回退方式。发送失败或结果不明确时，绝不会自动改用另一种桥接机制重试。

Cursor 目前会在将工具结果交付给嵌入式应用前丢弃 _meta。对于带有 Cursor/ user agent 的 HTTP 请求，连接器只会将已知的七种组件负载镜像到 structuredContent.widgetDataJson 中。所有五种组件都会优先使用 _meta，并接受此结构化回退方式，包括素材文件夹和上传响应。结构化内容可能会被模型看到；切勿向此允许列表添加任意元数据或账户凭据。ChatGPT 和 Claude 保持原有的仅元数据交付方式。使用仪表板测试工具 ?picker=projects&scenario=cursor 测试元数据被剥离的路径（也支持 assets、screenshots、social 和 promo）。

维护者可运行 npm run sync:dashboard -- /absolute/path/to/dashboard，重新生成打包的列表视图和共享契约。添加 --check 可验证它们是否一致，而不更新连接器产物。npm test 会检查产物完整性和契约哈希，无需另行检出代码或访问网络。 现有截图、社交和促销选择器行为保持不变。

托管 MCP 运行时指标

设置 APPLAUNCHFLOW_MCP_POSTHOG_KEY（PostHog 项目令牌，而非个人 API 密钥）和 APPLAUNCHFLOW_MCP_POSTHOG_HOST（例如 https://eu.i.posthog.com），以启用所需的托管 $mcp_tool_call 事件。请使用接收仪表板/落地页事件的同一项目对应的采集主机。缺少任一变量或主机无效时，托管服务将拒绝启动。本地 stdio 调用不会纳入统计，因为无法验证其托管账户身份。

事件使用经过身份验证的令牌内省所返回的账户 ID，且只包含工具名称、客户端系列、耗时、结果和固定的错误类别。不会纳入参数、输出、素材 URL、提示词、Bearer 令牌和项目内容。数据采集在后台运行，范围受限；如果分析功能不可用，不会重试工具调用，也不会更改其结果。现有 Railway 日志保留不变。不会根据无状态请求推断会话或 Agent 意图分组。

如果 MCP 请求提供进度令牌，耗时较长的样式生成会发送进度信息。客户端必须请求进度并在收到进度时重置超时；固定的客户端截止时间仍可能终止调用。如果生成结果不确定，请先检查项目/目录状态，再进行重试。对于渲染，请复用原始幂等键，并轮询 get_release_render，直至任务达到终态；仅仅接受请求并不能证明软件包已成功生成。

截图上传中断

upload_screenshots 会报告每个已完成文件的零起始 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，先读取语言和变体，然后调用 transform_layout，并传入 formatId: "ios-duo-inner" 和操作（省略 layouts）。要将该尺寸恢复为主设计，请调用同一工具，传入 formatId、resetFormat: true、不传操作，并提供最新读取回执。save_layout 也接受完整的 formatLayouts 映射：省略它可保留现有覆盖项；{} 会重置所有覆盖项。list_export_formats 包含 ios.phone.duo-inner 和 ios.phone.duo-outer；预设导出使用与编辑器相同的已保存格式。经商店验证的 Fastlane 导出仍保留 iOS 的十张图片限制。

App Store 创意内容编辑

产品页面页眉（app_store_header，3840×1646）和搜索结果创意内容（app_store_search，1920×1280）使用与社交设计相同的图形工具。准备／浏览／应用样式，然后使用 get_graphics_format 读取，并通过 save_graphics_format 保存完整的已编辑布局，同时传入最新读取回执。文本、图片、徽标、设备边框、背景和位置仍可编辑；保存操作会返回现有的结果预览小组件。其他格式会保留。页眉准备接受 1–7 张截图；其他格式需要 3–7 张。这些工具会编辑 AppLaunchFlow 内的设计，而不是已发布的 App Store 列表页。