ASO AI Companion (MCP) - 设置指南

AI Companion 用于在 ASO.dev 中通过外部 AI 助手（如 Claude、ChatGPT、Cursor 等）自动处理 App Store Connect 与 Google Play 元数据工作流。
MCP 服务器允许 AI 通过本地安全 API 实时查看和编辑您的元数据。

MCP（AI Companion）可以让你将任何 AI 助手（如 ChatGPT、Claude、Gemini 或 Cursor）连接到 ASO.dev 工作区。MCP 帮助自动管理 App Store Connect 与 Google Play 元数据：标题、描述、关键词、截图等。所有操作都在本地完成，数据不会离开你的电脑。

• 快速填写和编辑 App Store 和 Google Play 的元数据
• 用 AI 自动化日常任务
• 批量更新所有语言和字段
• 可以通过界面或 AI 助手轻松操作

MCP 有意不作为批量关键词数据接口。它不会开放 ASO.dev 的关键词难度、热度、排名、建议、竞品关键词或大型关键词列表。这是明确的产品与基础设施决策，并不是缺少某个 prompt 或 MCP 工具。

1. 在关键词或关键词追踪列表中筛选或选择数据，然后将表格导出为 Excel。
2. 把导出的文件上传到 Codex、ChatGPT、Claude 或其他 AI 工具，让它根据关键词难度、热度、当前排名、相关性和业务限制筛选最佳机会。也可以把这套流程保存为可重复使用的 skill 或 workflow。
3. 使用 ASO.dev MCP 获取受支持的当前工作区上下文、检查元数据并执行编辑器操作。

ASO.dev 有意保留宽松的数据导出能力：根据报告类型，订阅内可以导出数千甚至数十万行用于分析，无需为每次请求消耗 API credits。对于大规模 AI 分析，ASO.dev 导出 + AI + MCP 上下文通常是最高效、成本最低的方式。

Developer API 仍然适合可控的自动化：定时任务、固定的 server-to-server 流程，以及无法通过用户主动导出完成的特殊场景。API 的访问规则、credits 和限制让机器负载保持透明且可衡量。

1. 打开 ASO.dev 设置 → AI Companion
2. 点击“启动”以运行 MCP 服务器
3. 在编辑器页面点击按钮，复制连接 AI 的配置
4. 在你的 AI 助手（ChatGPT、Claude 等）设置中添加新服务器：
   • 地址：http://localhost:42111
   • 密钥：本地连接无需
   • MCP 客户端：使用从 ASO.dev 复制的现成 MCP 配置
5. 保存设置并重启 AI 助手

• 在编辑器页面点击 机器人图标，可为当前选中的应用启动本地 MCP 服务器
• 可以复制连接配置
• 所有操作都通过简单表单和按钮完成

• 让 AI 帮你：“用 MCP 填写所有语言的描述”
• “显示当前应用元数据”
• “更新 App Store 和 Google Play 的截图”

• 检查状态： curl http://localhost:42111/status
• 获取元数据：

  curl -X POST -H "Content-Type: application/json" -d '{"action": "get_editor_data"}' http://localhost:42111/apple/metadata/editor/get

• 批量填写：

  curl -X POST -H "Content-Type: application/json" -d '{"localizations": {"en-US": {"title": "New Title"}}}' http://localhost:42111/google/metadata/editor/bulk-fill

• 默认端口：42111（可更改）
• 密钥：本地连接无需
• 所有数据都在你的电脑上
• AI 不能直接发布更改，只能建议，最终保存需人工确认
• 远程访问请用隧道（ngrok、Cloudflare Tunnel）

如何连接 AI 到 MCP？
在编辑器页面点击 机器人图标。它会为选中的应用启动本地 MCP 服务器，并打开带有现成配置的窗口。

MCP 能否返回关键词难度、热度或大型关键词列表？ 不能。批量关键词分析数据有意通过 ASO.dev 导出提供，而不是通过 MCP。请使用推荐的“导出 + AI”流程。

密钥是必需的吗？
本地连接无需，脚本和 API 请求建议使用。

如何更改端口？
在 全局设置 → AI Companion → 端口 中设置。

无法连接怎么办？
请检查服务是否已启动、端口是否空闲、密钥是否正确。

服务仅在本地运行，数据不会离开你的电脑，只对你选择的 AI 助手可见。

选项一：通过设置

1. 进入 全局设置 → AI Companion。
2. 点击 Run（如服务未启动）。
3. 此处也可复制密钥和更改端口（默认 42111）。

选项二： 通过编辑器、批量编辑器和跨语言页面的机器人图标

1. 在 编辑器、批量编辑 或 跨语言 页面，机器人图标可直接在界面中为当前选中的应用启动或停止本地 MCP 服务器。
2. 如有需要，也可通过此按钮一键复制 MCP JSON 配置。

1. 打开 Claude Desktop 应用。
2. 进入设置菜单（通常是齿轮图标或“Settings”）。

• macOS：打开 Finder，按 Cmd+Shift+G，粘贴路径：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：打开资源管理器，粘贴路径：%APPDATA%\Claude\claude_desktop_config.json

4. 用记事本、TextEdit 等文本编辑器打开该文件。
5. 在 ASO.dev 的编辑器、批量编辑器或跨语言页面点击按钮，一键复制 JSON 配置，粘贴到 mcpServers 部分。
6. 保存文件并重启 Claude Desktop。
7. 完成！Claude 现在可以连接 MCP。

1. 打开自定义 GPT 的设置（通常在界面中“Actions”或“API”）。
2. 找到添加外部 API 的部分。
3. 填写：

• API Key：（可选）在 ASO.dev 设置中复制，粘贴到“X-Client-Secret”字段。
• OpenAPI 文档：MCP 客户端应使用现成的 MCP 配置。如果工具只支持 OpenAPI/HTTP actions，请手动描述受支持的本地 endpoint。Developer API 规范属于另一个独立产品，并不是 MCP 工具 schema。

4. 保存设置。
5. 现在 ChatGPT 可以访问 MCP 并操作元数据。

1. 打开 AI 工具的设置。
2. 找到连接外部 API 或 HTTP 请求的部分。
3. 填写 MCP 地址：http://localhost:42111
4. 如有密钥字段，可在 ASO.dev 复制密钥粘贴（本地可选）。
5. 如支持 OpenAPI，请手动描述受支持的本地 endpoint。不要把 Developer API 规范当作 MCP 工具 schema。
6. 保存并根据需要重启工具。

• 如找不到相关设置，请查阅 AI 工具文档或联系 ASO.dev 支持。
• 对于云端/浏览器 AI 工具，可能需要用 ngrok、Cloudflare Tunnel 等工具让 MCP 可被访问。

1. 打开 VS Code，点击左侧的 扩展 图标。
2. 找到并打开你用的扩展（如 Cline 或 Roo Code）。
3. 在扩展侧边栏找到 MCP Servers，点击 Configure MCP Servers（按钮可能是齿轮或“Configure”字样）。

• Name: ASO Companion
• Type: command (stdio)
• Command: npx -y @modelcontextprotocol/server-http --url http://localhost:42111

1. 打开 Cursor，点击 设置 图标（通常在左下角或右上角的齿轮）。
2. 进入 Features，找到 MCP 部分。
3. 点击 Add new MCP server（加号或“Add”）。
4. 填写：
5. 密钥字段留空（本地连接）。
6. 点击 保存。
7. 确认服务器已在列表中并启用。

2. 找到 外部 MCP 服务器 或类似设置。
3. 点击 添加 或 新服务器。
4. 输入：

• URL: http://localhost:42111
• 密钥:（可选，如有需要可在 ASO.dev 复制）

5. 点击 保存 或 OK。
6. 如有需要重启 Antigravity。
7. 完成！Antigravity 现在已连接 MCP。

1. 进入 Settings → Features → MCP。
2. 点击 Add new MCP server。

• Name: ASO Companion
• Type: command (stdio)
• Command: npx -y @modelcontextprotocol/server-http --url http://localhost:42111

1. 打开 Antigravity 设置。
2. 添加新服务器：

• URL: http://localhost:42111
• （可选）密钥: ASODEV_SECRET_KEY

4. 保存并根据需要重启助手。

• 请确保 MCP 已启动（可通过 ASO.dev 设置，或编辑器、批量编辑器、跨语言页面的按钮启动）。
• 所有连接参数可在编辑器、批量编辑器或跨语言页面一键复制。
• 大多数现代编辑器只需填写启动命令和 URL，本地连接无需密钥。

如需其他开发环境的说明，请联系我们！

1. 打开编辑器设置 → MCP 部分。
2. 添加新服务器：
   • Name: ASO Companion
   • Type: command (stdio)
   • Command: npx -y @modelcontextprotocol/server-http --url http://localhost:42111
3. 本地连接时密钥不是必需的。

如需手动设置 AI 工具：

{
  "mcpServers": {
    "aso-dev": {
      "url": "http://localhost:42111",
      "env": {
        "ASODEV_SECRET_KEY": "your-secret-key"
      }
    }
  }
}

本地连接时密钥为可选项。所有参数可在 AI Companion 启动窗口复制。

• Cursor：Settings → Features → MCP
• VSCode (Cline/Roo Code)：扩展侧边栏 → MCP Servers → Configure MCP Servers
• Claude Desktop：~/Library/Application Support/Claude/claude_desktop_config.json（macOS）

如 AI 助手不直接支持 MCP，可以调用本地 MCP HTTP endpoint。这些不是 ASO.dev Developer API endpoint，也不会增加批量关键词数据访问能力：

端口：42111（可在设置中更改） 密钥：ASODEV_SECRET_KEY（本地可选）

检查状态：

curl http://localhost:42111/status
# 或带密钥：
curl -H "X-Client-Secret: YOUR_SECRET" http://localhost:42111/status

获取编辑器数据：

curl -X POST -H "Content-Type: application/json"
     -d '{"action": "get_editor_data"}' http://localhost:42111/apple/metadata/editor/get
# 或带密钥：
curl -X POST -H "X-Client-Secret: YOUR_SECRET" -H "Content-Type: application/json"
     -d '{"action": "get_editor_data"}' http://localhost:42111/apple/metadata/editor/get

批量填写：

curl -X POST -H "Content-Type: application/json"
     -d '{"localizations": {"en-US": {"title": "New Title"}}}' http://localhost:42111/apple/metadata/editor/bulk_fill
# 或带密钥：
curl -X POST -H "X-Client-Secret: YOUR_SECRET" -H "Content-Type: application/json"
     -d '{"localizations": {"en-US": {"title": "New Title"}}}' http://localhost:42111/apple/metadata/editor/bulk_fill

• 端口：42111（默认，可在设置中更改）
• ASODEV_SECRET_KEY：可选密钥，可在 AI Companion 设置中复制
• JSON 配置：可在编辑器、批量编辑器或跨语言页面一键复制

• MCP 服务器仅作用于当前 ASO.dev 工作区
• 密钥对您的安装唯一
• 批量关键词分析数据有意通过导出提供，而不是通过 MCP
• AI 不能直接发布更改 - 只能建议，最终保存需人工确认
• 远程访问请使用隧道（ngrok、Cloudflare Tunnel）

如何获取配置？
在编辑器、批量编辑器或跨语言页面点击 AI Companion 启动按钮，会弹出带有 JSON 配置的窗口。

密钥是必需的吗？
本地连接无需密钥，但脚本和 API 请求建议使用。

如何更改端口？
在 全局设置 → AI Companion → 端口 中设置。

无法连接怎么办？
请检查服务是否已启动、端口是否被占用，以及（如需）密钥是否正确。

服务仅在本地运行，您的数据不会离开您的计算机，仅对您选择的 AI 助手可见。

MCP 现已支持 Apple App Store 和 Google Play：

• 获取 Google Play 元数据：/google/metadata/editor/get-data（POST）
• Google Play 批量填写：/google/metadata/editor/bulk-fill（POST）

示例：

# 获取 Google Play 数据
curl -X POST -H "Content-Type: application/json"
  -d '{"action": "get_google_editor_data"}' http://localhost:42111/google/metadata/editor/get-data

# Google Play 批量填写
curl -X POST -H "Content-Type: application/json"
  -d '{"localizations": {"en-US": {"title": "New Title"}}}' http://localhost:42111/google/metadata/editor/bulk-fill

所有方法现在都支持以下参数：

• pageId — 页面标识（可选）
• locales — 语言列表（如 ["en-US", "zh-CN"]）
• fields — 需要获取或填写的字段列表
• data — 批量填写的数据对象

JSON-RPC 新增方法：

• get_google_editor_data — 获取 Google Play 元数据
• bulk_fill_google — Google Play 批量填写

JSON-RPC 调用示例：

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_google_editor_data",
    "arguments": {
      "locales": ["en-US", "zh-CN"],
      "fields": ["title", "description"]
    }
  }
}

ASO.dev Developer API 文档描述的是另一个受控 API 产品。它不是 MCP 工具列表，也不会通过 MCP 开放批量关键词数据。MCP 客户端应使用 AI Companion 提供的现成配置和工具发现能力。

• “通过 MCP 获取 Google Play 元数据”
• “用 MCP bulk_fill_google 批量更新 Google Play 所有语言的描述”
• “POST 到 /google/metadata/editor/get-data 并返回结果”

检查 MCP 状态：

curl http://localhost:42111/status
# 或带密钥：
curl -H "X-Client-Secret: YOUR_SECRET" http://localhost:42111/status

获取编辑器数据：

curl -X POST -H "Content-Type: application/json"
  -d '{"action": "get_editor_data"}' http://localhost:42111/apple/metadata/editor/get
# 或带密钥：
curl -X POST -H "X-Client-Secret: YOUR_SECRET" -H "Content-Type: application/json"
  -d '{"action": "get_editor_data"}' http://localhost:42111/apple/metadata/editor/get

批量填写元数据：

curl -X POST -H "Content-Type: application/json"
  -d '{"localizations": {"en-US": {"title": "New Title"}}}' http://localhost:42111/apple/metadata/editor/bulk_fill
# 或带密钥：
curl -X POST -H "X-Client-Secret: YOUR_SECRET" -H "Content-Type: application/json"
  -d '{"localizations": {"en-US": {"title": "New Title"}}}' http://localhost:42111/apple/metadata/editor/bulk_fill

你可以让 AI 助手通过如下 prompt 调用 MCP 功能：

• “通过 MCP 获取当前应用元数据”
• “用 MCP bulk_fill 批量填写所有本地化标题”
• “POST 到 /apple/metadata/editor/get 并返回结果”
• “检查 MCP 服务器状态并显示响应”
• “用 curl 请求 MCP 批量填写元数据”

支持外部 API 的 AI 助手可以自动完成这些操作，只需指定 endpoint 和参数。