@ 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 密钥连接。 无论哪种方式,你得到相同的工具.
连接的两种方式
远程( 建议): OAuth 2.1
对于克劳德桌面,光标,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 键.
-
创建 API 密钥 平台.fload.com/设置/api-keys。选择它能做什么(只读、读和提议修改,或包括批准在内的全面访问,或每项许可),以及何时到期。 密钥在需要的许可下没有回答权限的工具 .
-
添加到您的 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.com | Fload 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。 。 。 .
许可证
麻省理工学院