MCP：连接 AI 助手
通过 MCP，让 AI 助手使用 Fox Store 已配置的连接，查询应用、维护商店内容，以及执行已实现的上传与发布操作。MCP 调用 Engine 业务能力；CLI 则用于 CI/CD 发布自动化，两者共用内核，但工具范围不同。
启用与准备
- 安装最新版 Fox Store，完成许可证激活并添加 Provider 连接。
- 打开「设置 → MCP」，开启「启用 MCP」。总开关立即保存，重启后保留；权限和超时修改后需点击「保存」。
- 在「权限管理」确认连接范围、执行权限与可用工具。
- 在「接入方式」复制对应客户端配置，添加到 AI 客户端后重新连接 MCP。
安装包包含原生 MCP 程序，无需另装 Node.js 或 MCP 插件。客户端通过本地 stdio 启动独立进程；完成初始化后无需一直打开 Fox Store 桌面。许可证租约到期时，需要回到桌面刷新授权。
配置 AI 客户端
Codex 使用设置页生成的 TOML；Claude Code 等本地客户端可参考生成的 JSON，并按其配置格式添加。以设置页显示的程序绝对路径、启动参数和数据目录为准，不要照搬他人的电脑路径。
表单式配置中，启动命令单独填写，--data-dir 与后面的目录路径分别添加为两个参数，不要把引号、逗号或整个数组塞进一个参数。Linux AppImage 配置还可能带有 --mcp，请完整保留生成配置。无需在客户端配置中填写 Provider 密钥。
兼容性取决于客户端是否支持本地 stdio MCP。GLM、DeepSeek、Gemini 等模型需通过兼容客户端使用；仅接受远程 URL 的网页或云端产品不能直接运行本机程序。当前不提供 HTTP 服务地址。
权限与工具范围
| 权限 | 允许的操作 |
|---|---|
| 只读（默认） | 查询连接、应用、版本和状态等，不修改平台数据。 |
| 内容维护 | 包含只读；允许更新文案、素材等内容，不包含提审、发布、删除或账号权限变更。 |
| 发布管理 | 包含内容维护；允许对应工具的提审、发布、删除、价格、分发和账号权限等高风险变更。 |
默认允许所有连接（含以后新增连接）；可改为指定连接，并为连接覆盖默认权限。工具默认勾选，手动取消的选择会保留。分组数量表示「已启用 / 工具总数」，不是平台菜单数量；展开分组可查看每项工具及所需权限。
连接范围、工具开关、执行权限与平台账号权限共同生效。选中工具不等于获得写权限。提高权限也不会增加平台或 Engine 尚未实现的能力。当前不提供逐次桌面审批；AI 客户端可能另行要求确认。调用结果可能传给该客户端使用的模型服务。
可以怎样提问
- 「列出这个 App Store 连接下的应用、最新版本及中文简介；缺失的内容请明确标注。」
- 「查询 Google Play 指定应用的测试 Track 与发布状态。」
- 「把指定应用的中文商店简介更新为这段文案。」
- 「预检这个本地安装包，然后上传到指定连接的测试渠道。」
请明确连接、应用、语言和目标渠道。查询只会返回账号可见的数据；未实现的能力或不足的权限会报错。上传成功不等于审核通过或已经上线。CLI 流水线用法见 CLI / API 参考。
图片与本地文件
AI 生成图片后，先保存到运行 MCP 的电脑，再提供文件绝对路径和目标应用。云端聊天中的图片或沙箱路径不一定可从本机读取；文件不存在、不可读或格式不符时，应按错误提示修正。
可用操作取决于平台和工具：例如商店图片更新与安装包内图标修改不是同一件事。Apple 主 App 图标需要随新构建上传，不能把一张图片直接当作已发布应用的图标替换。
排查连接与调用失败
- 没有工具或只有旧工具：检查总开关、工具选择及保存状态，重新连接客户端；程序升级后退出旧 MCP 进程并重连。
- 无法启动：核对程序是否存在、参数是否分开、路径是否仍指向旧安装位置；从设置页重新复制配置。「程序已就绪」只表示程序存在，不代表客户端已经连接。
- MCP_POLICY_INVALID：更新 Fox Store，在设置中重新加载并保存策略，再重连客户端；仍失败时保留错误信息用于排查，不要删除凭据数据库。
- 连接或凭据不可用：核对数据目录和所选连接，在桌面检查连接及系统凭据库是否可访问。不同操作系统用户不能直接共用凭据。
- 授权、权限或超时错误：刷新许可证，检查所需权限和平台账号授权；长任务还需调整客户端超时。写操作结果未知时，先查平台状态，避免重复提交。
「最近调用」提供工具、结果和耗时摘要。更多说明见 Provider 连接 与 故障排查。