ASO AI Companion (MCP)：ASO.dev 的 AI 连接与配置

开发中  即将上线

AI Companion 是一款用于在 ASO.dev 中通过外部 AI 助手（如 Claude、ChatGPT 等）自动管理应用元数据的工具。
MCP 服务器允许 AI 通过本地安全 API 实时查看和编辑您的元数据。

MCP（AI Companion）是一个工具，可以让你将任何 AI 助手（如 ChatGPT、Claude、Gemini）连接到你的 ASO.dev 项目。MCP 帮助你自动管理应用元数据：标题、描述、关键词、截图等。所有操作都在本地完成，数据不会离开你的电脑。

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

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

• 编辑器页面有 AI Companion 启动按钮
• 可以复制连接配置
• 所有操作都通过简单表单和按钮完成

• 让 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？
编辑器页面有 AI Companion 启动按钮，会弹出配置窗口。

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

如何更改端口？
在 Global Settings → AI Companion → Port 设置。

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

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

选项一：通过设置

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

选项二： 通过 Editor/Bulk Editor/Cross-Locales 页面的按钮

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 的 Editor/Bulk Editor/Cross-Locales 页面点击按钮，一键复制 JSON 配置，粘贴到 mcpServers 部分。
6. 保存文件并重启 Claude Desktop。
7. 完成！Claude 现在可以连接 MCP。

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

• API Key：（可选）在 ASO.dev 设置中复制，粘贴到“X-Client-Secret”字段。
• OpenAPI 规范：导入 http://localhost:42111/openapi.json（或手动添加 /apple/metadata/editor/get 和 /apple/metadata/editor/bulk_fill 接口）。

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

1. 打开 AI 工具的设置。
2. 找到连接外部 API 或 HTTP 请求的部分。
3. 填写 MCP 地址：http://localhost:42111
4. 如有密钥字段，可在 ASO.dev 复制密钥粘贴（本地可选）。
5. 如支持 OpenAPI，导入 http://localhost:42111/openapi.json。
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 设置或 Editor/Bulk Editor/Cross-Locales 页面的按钮）。
• 所有连接参数可在 Editor/Bulk Editor/Cross-Locales 页面一键复制。
• 大多数现代编辑器只需填写启动命令和 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，可用 HTTP 请求：

端口：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

OpenAPI 规范： http://localhost:42111/openapi.json

• 端口：42111（默认，可在设置中更改）
• ASODEV_SECRET_KEY：可选密钥，可在 AI Companion 设置中复制
• JSON 配置：可在 Editor/BulkEditor/Cross-Locales 页面一键复制

• MCP 服务器仅作用于当前 ASO.dev 项目
• 密钥对您的安装唯一
• AI 不能直接发布更改 - 只能建议，最终保存需人工确认
• 远程访问请使用隧道（ngrok、Cloudflare Tunnel）

如何获取配置？
在 Editor/BulkEditor/Cross-Locales 页面点击 AI Companion 启动按钮，会弹出带有 JSON 配置的窗口。

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

如何更改端口？
在 Global Settings → AI Companion → Port 设置。

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

服务仅在本地运行，您的数据不会离开您的计算机，仅对您选择的 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"]
    }
  }
}

OpenAPI 规范现已包含 Apple 和 Google 的所有新接口，可用于自动生成客户端代码。

• “通过 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

OpenAPI 规范： http://localhost:42111/openapi.json

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

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

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