@fload-ai/mcp

中文文档
0.14.0发布于 2026/11/09MITTypeScriptES Module近 30 天下载 1987

Fload在stdio上的MCP服务器:用你的API密钥作为Fload的远程MCP服务器的一薄代用. 移动应用分析,评论,ASO,AI客户端的广告和代理.

中文使用文档
文档目录11 节
  1. 连接的两种方式
  2. 远程( 建议): OAuth 2.1
  3. 本地 stdio: API 密钥( 此套件)
  4. 你可以问你的经纪人
  5. 工具
  6. 从0.12(手写工具)移出
  7. 权限
  8. 配置( stdio)
  9. 技能
  10. 问题和反馈
  11. 许可证

@ fload-ai/ mcp (英语)

MCP 服务器 装入:将任何MCP相容的AI客户端(Claude, ChatGPT, Cursor, VS Code, Cline)连接到你的移动应用程序的App Store Connect和Google Play的数据,评论,广告活动,ASO和Fload的代理商.

有一个 Fload MCP 服务器,在 https://api.fload.com/mcp。通过此套件与 OAuth( 远程客户端) 或 API 密钥连接。 无论哪种方式,你得到相同的工具.

连接的两种方式

对于克劳德桌面,光标,ChatGPT以及任何支持远程MCP服务器的客户端. 没有 API 密钥可以管理, 范围化到一个组织, 从 Fload 设置 ~ Connected Apps 中可撤销 .

克劳德桌面 (单位:千美元)~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "fload": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.fload.com/mcp"]
    }
  }
}

重新启动克洛德桌面. 在第一次使用时, mcp-remote 打开 OAuth 同意的浏览器。 选择哪个 Fload 组织共享,批准其权限,完成.

光标 : 设置 → MCP → 添加远程服务器 → https://api.fload.com/mcp。 。 。 .

ChatGPT( 团队/ 企业): 管理门户 – 连接器 – 添加自定义连接器 – 服务器 URL https://api.fload.com/mcp。 。 。 .

本地 stdio: API 密钥( 此套件)

对于脚本,CI,无头环境,或长生机器认证. 这个软件包是一个很薄的代理: 它在stdio上讲MCP,并转发每个消息到 https://api.fload.com/mcp 用您的 API 键.

  1. 创建 API 密钥 平台.fload.com/设置/api-keys。选择它能做什么(只读、读和提议修改,或包括批准在内的全面访问,或每项许可),以及何时到期。 密钥在需要的许可下没有回答权限的工具 .

  2. 添加到您的 MCP 配置 :

    {
      "mcpServers": {
        "fload": {
          "command": "npx",
          "args": ["-y", "@fload-ai/mcp"],
          "env": {
            "FLOAD_API_KEY": "fload_sk_your_key_here"
          }
        }
      }
    }
    

    或使用 ~/.fload/config.json数字 :

    {
      "apiKey": "fload_sk_your_key_here",
      "apiUrl": "https://api.fload.com"
    }
    

API的关键行为是在自己的组织,以制作人的名义. 它从来不是那个人自己的登录,因此工作只允许一个人批准(发布截图,自定义产品页的截图并提交苹果公司审查,开启自动模式)保留他们的,在Fload App中或超过他们自己的OAuth连接.

你可以问你的经纪人

  • "iOS为什么昨天安装掉?"
  • "我最后5个一星评论的稿子"
  • "我的"苹果搜索广告"的竞选活动这周花费了多少,他们带来了什么"
  • "审计我的ASO 我的顶级Grossing app 并建议更改标题。"

工具

服务器列出其工具,每个工具都有标题,描述,输入以及MCP安全提示(readOnlyHint, (中文(简体) ), destructiveHint, (中文(简体) ), idempotentHint, (中文(简体) ), openWorldHint) (中文(简体) ). 开始 listAssets: 每个应用程序级工具将应用程序的id作为 assetId。 。 。 .

更改从不在一步内发布:改变上市的工具,苹果Ads活动,审查回复或实验阶段Fload收件箱中的项目. 读出来 getActionItem,并核准 approvePendingAction 或者说 commandActionItems 只有一个人问.

从0.12(手写工具)移出

0.13 将软件包自己的工具替换为服务器的工具. 你的经纪人一直在工作:

  • 旧名list_apps, (中文(简体) ), get_metrics, (中文(简体) ), get_reviews, (中文(简体) ), approve_action,.)仍然在API密钥连接上回答,作为服务器工具的别名. 每个都说它代表哪个工具;使用这个名字. 旧名再留两个小版本.
  • send_review_reply 现在在收件箱中分级回复并返回其 actionItemId在答复得到批准之前,不发送任何信息(approve_action 或者说 approvePendingAction) (中文(简体) ).
  • send_chat_message 已消失: 它运行了整个 Fio 聊天回合, 您的代理已经拥有 Fload 的工具 . list_conversations 财务报告和审定财务报表 get_conversation 仍然读你的聊天历史.
  • trigger_aso_analysis 重新读取应用程序的 App Store 列表; 它从未运行过 ASO 分析 . list_agents, (中文(简体) ), list_pending_actions 财务报告和审定财务报表 get_ads_performance 拿着应用程序 assetId。 。 。 .
  • 套件不再出口 FloadApiClient, (中文(简体) ), registerTools 或 ./tools 财务报告和审定财务报表 ./api-client 进入点.

权限

API 密钥和 OAuth 连接共享一组权限 。 OAuth 同意屏幕询问它们; 与它们一起创建了 API 密钥 .

  • 读取: read:apps, (中文(简体) ), read:org, (中文(简体) ), read:reviews, (中文(简体) ), read:analytics, (中文(简体) ), read:ads, (中文(简体) ), read:aso, (中文(简体) ), read:agents
  • 写作: write:reviews, (中文(简体) ), write:ads, (中文(简体) ), write:aso, (中文(简体) ), write:agents, (中文(简体) ), write:chat, (中文(简体) ), write:org
  • 仅 OAuth 身份 : openid, (中文(简体) ), email, (中文(简体) ), profile, (中文(简体) ), offline_access

read:org 覆盖该组织的成员,其待发邀请书及其应用的共享链接(每个共享链接都会打开一个应用的共享页面给持有该链接的任何人). read:apps 没有找到他们.

read:org oAuth 客户端在注册时不要求任何信息, 故意不在范围之内: 它显示人们的电子邮件地址, 所以客户端必须要求, 并且当事人在允许之前会在同意屏幕上看到它。 键或之前的连接 read:org 存在(2026年10月16日,丹麦时间20:15),持有当时的每个读取许可(read:apps, (中文(简体) ), read:reviews, (中文(简体) ), read:analytics, (中文(简体) ), read:ads, (中文(简体) ), read:aso, (中文(简体) ), read:agents),正如每一个全取或只读的密钥一样,算作拥有. 狭义的,或者说因为没有 read:org还要用它再做一次.

write:org 更改组织设置: 添加应用程序( 添加的应用程序可以更改您的帐单) , 共享链接, 您自己的通知设置, 由 Slack 和 Discord 通道获得 Fload 的更新, 数据同步和反馈到 Fload 。 添加应用和共享链接(每个都打开一个应用的共享页面给任何持有它的人)只能由一个人自己的OAuth登录完成,从不使用API密钥. 与 read:org,它永远不会被算作持有:一个在存在之前制造的钥匙或连接,即使完全可以使用,也必须用它再次制造.

删除一个应用程序( E)asset_delete(b) 邀请或罢免成员(member_invite, (中文(简体) ), member_remove)的工作如"Fload Web App"的对话框. 只有所有者或管理员才能做出这些修改,并且只能通过自己的OAuth登录,从不使用API密钥. 每个人先问:它改变不了什么,答案也改变不了 NEEDS_CONFIRMATION 接下来会发生什么 confirmId你的经纪人会告诉你的 只有在你答应后它才会叫 asset_delete_confirm, (中文(简体) ), member_invite_confirm 或者说 member_remove_confirm15分钟之内,在组织里,只有你才有一次确认 让你的客户尽快批准确认工具.

批准Apple Ads,在收件箱中上市或审查更改,则取取该区的写出权限(write:ads, (中文(简体) ), write:aso 或者说 write:reviews和 write:agents (证出并出.

配置( stdio)

变量需求默认说明
FLOAD_API_KEY对—— 说API 密钥,格式 fload_sk_...
FLOAD_API_URL没有https://api.fload.comFload API (其名称: /mcp 用于)

在您的 MCP 客户端中设置 env 用于服务器,或将密钥放入 ~/.fload/config.json从0.132起,服务器不再读取 .env 从目录开始的文件.

FLOAD_API_URL 位于何处 FLOAD_API_KEY 继续 键入 ~/.fload/config.json 转到 apiUrl 用它来保存,或者 https://api.fload.com 当没有的时候,永远不要 FLOAD_API_URL (出自0.13.3),因此指向本地或预览服务器的外壳不能发送到那里.

技能

skill/SKILL.md (在包中) 教一个代理如何结合了Fload的工具. 把它复制到您的代理技能文件夹中.

问题和反馈

文件错误或特性请求 github.com/fload-ai/mcp/问题在融合支助方面: 支持@ fload.com。 。 。 .

许可证

麻省理工学院

版本与发布记录

@fload-ai/mcp 共发布 24 个版本,首次发布于 2026/03/18;过去 12 个月发布了 24 个版本。

版本发布日期距今
0.14.0latest2026/11/096 天前
0.13.52026/11/069 天前
0.13.42026/11/069 天前
0.13.32026/10/3017 天前
0.13.22026/10/2224 天前
0.13.12026/10/2026 天前

关于 @fload-ai/mcp 的常见问题

@fload-ai/mcp 是什么?

Fload在stdio上的MCP服务器:用你的API密钥作为Fload的远程MCP服务器的一薄代用. 移动应用分析,评论,ASO,AI客户端的广告和代理.

如何安装 @fload-ai/mcp?

在项目目录运行 npm install @fload-ai/mcp,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 fload-mcp,可以用 npx fload-mcp 直接运行。

@fload-ai/mcp 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@fload-ai/mcp 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@fload-ai/mcp 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=18.0.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@fload-ai/mcp 可以商用吗?

@fload-ai/mcp 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@fload-ai/mcp 的下载量有多少?

根据 npm 官方下载统计,@fload-ai/mcp 在 2026/10/15 – 2026/11/13 这 30 天内被下载 1,987 次,日均约 66 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@fload-ai/mcp 还在维护吗?

最新版本 0.14.0 发布于 2026/11/09(6 天前);至今共发布 24 个版本,其中过去 12 个月发布了 24 个;首次发布于 2026/03/18。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。