# @fload-ai/mcp 中文文档

规范地址：https://npmcn.com/package/%40fload-ai/mcp/

版本：0\.14\.0
npm 元数据更新时间：2026-11-09T13:47:16.915Z
中文译文更新时间：2026-11-15T23:47:50.588Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40fload-ai/mcp
原文对照：https://npmcn.com/package/%40fload-ai/mcp/?lang=original

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：132 kB，18 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=18\.0\.0
- 运行依赖：2 个
- 首次发布：2026-03-18T00:43:06.240Z
- 最新版本发布：2026-11-09T13:47:16.707Z
- 近 30 天下载量：1987（2026-10-15 至 2026-11-13，npm 官方下载统计）
- 已发布版本数：24（近 12 个月 24 个）

## 中文简介

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

## 安装

```sh
npm install @fload-ai/mcp
```

也可以使用：`pnpm add @fload-ai/mcp`、`yarn add @fload-ai/mcp`、`bun add @fload-ai/mcp`

## README

# @ fload-ai/ mcp (英语)

MCP 服务器 [装入](https://fload.com/):将任何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`:

```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](https://platform.fload.com/settings/api-keys)。选择它能做什么(只读、读和提议修改,或包括批准在内的全面访问,或每项许可),以及何时到期。 密钥在需要的许可下没有回答权限的工具 .
    
2.  添加到您的 MCP 配置 :
    
    ```json
    {
      "mcpServers": {
        "fload": {
          "command": "npx",
          "args": ["-y", "@fload-ai/mcp"],
          "env": {
            "FLOAD_API_KEY": "fload_sk_your_key_here"
          }
        }
      }
    }
    ```
    
    或使用 `~/.fload/config.json`数字 :
    
    ```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_confirm`15分钟之内,在组织里,只有你才有一次确认 让你的客户尽快批准确认工具.

批准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/问题](https://github.com/fload-ai/mcp/issues)在融合支助方面: [支持@ fload.com](mailto:support@fload.com)。 。 。 .

## 许可证

麻省理工学院

## 常见问题

### @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 和提交记录判断。

