VOC OpenAPI MCP 安装器

English | 简体中文

将全量 VOC OpenAPI MCP Server 写入本机 AI 客户端，用于 Amazon 评论洞察、 反馈打标、Listing 优化和数百个已发布数据工具。

适合电商运营、消费者洞察团队、产品研究人员，以及需要在授权范围内读取评论数据并形成 可重复 VOC 工作流的 AI Agent。

使用

curl -fsSL https://open.voc.ai/install.sh | bash

默认情况下，安装器会打开浏览器，请你登录 VOC 并确认授权。授权完成后，安装器会自动为 本机检测到的受支持客户端写入 MCP 配置，包括 Codex、Claude、Cursor 以及下方列出的其他客户端。

Windows PowerShell：

irm https://open.voc.ai/install.ps1 | iex

或直接使用 npm 包：

npx voc-openapi-mcp@latest setup

Codex 用户可以同时安装通用 VOC OpenAPI 查询 Skill：

npx voc-openapi-mcp@latest setup --with-skill

Skill 仅在检测到 Codex 时写入 ~/.agents/skills/voc-openapi/SKILL.md。卸载器只会删除安装器管理且未被用户修改的版本。

默认会注册本机检测到的 agent，目前支持：

• Claude Code（CLI，写入 ~/.claude.json）
• Claude Desktop（桌面版，检测 macOS App / Windows %LOCALAPPDATA%\AnthropicClaude，写入 claude_desktop_config.json，通过 mcp-remote 桥接远程 MCP）
• Cursor（桌面版 / CLI launcher，检测 macOS App / Windows %LOCALAPPDATA%\Programs\cursor，共用 ~/.cursor/mcp.json）
• Windsurf（桌面版 / CLI launcher，检测 macOS App / Windows %LOCALAPPDATA%\Programs\Windsurf，共用 ~/.codeium/windsurf/mcp_config.json）
• WorkBuddy（桌面版，写入用户级 ~/.workbuddy/mcp.json）
• Gemini CLI（写入 ~/.gemini/settings.json）
• Codex（CLI / Desktop 共用 ~/.codex/config.toml）

查看本机检测结果：

curl -fsSL https://open.voc.ai/install.sh | bash -s -- --list-agents

Windows PowerShell：

& ([scriptblock]::Create((irm https://open.voc.ai/install.ps1))) -ListAgents

强制注册全部支持的 agent（默认会自动检测本机已安装的客户端，一般不需要）：

npx voc-openapi-mcp@latest setup --all-agents

默认写入：

• Codex：$CODEX_HOME/config.toml，没有设置 CODEX_HOME 时为 ~/.codex/config.toml
• Claude Code：~/.claude.json
• Claude Desktop：~/Library/Application Support/Claude/claude_desktop_config.json（Windows 为 %APPDATA%\Claude\claude_desktop_config.json）
• Cursor：~/.cursor/mcp.json
• Windsurf：~/.codeium/windsurf/mcp_config.json
• WorkBuddy：~/.workbuddy/mcp.json
• Gemini CLI：~/.gemini/settings.json
• MCP server 名称：voc-openapi
• MCP URL：https://open.voc.ai/mcp-server
• 鉴权 header：X-API-Key
• Full Endpoint：全部已发布 VOC OpenAPI MCP Tool
• Codex MCP 启动超时：120 秒

安装器会原地更新对应 MCP server 配置，不生成 .bak 备份文件。

可选参数

voc-mcp setup \
  --api-base https://open.voc.ai \
  --name voc-openapi \
  --with-skill \
  --config ~/.codex/config.toml

身份认证

浏览器登录是默认且推荐的认证流程。安装器会在默认浏览器中打开 VOC 授权页面，等待你登录并 确认授权，然后自动更新本机检测到的 AI 客户端。如果无法自动打开浏览器，安装器会输出同一个 授权链接，供你手动打开；你不需要从浏览器复制凭证再粘贴回终端。

API Key 备选方式

也可以跳过浏览器授权，直接使用 API Key：

VOC_OPENAPI_API_KEY=voc_live_sk_xxx npx voc-openapi-mcp@latest setup

请妥善保管 API Key：不要提交到代码仓库，不要粘贴到 Issue、聊天消息，也不要让它出现在截图 或日志中。相比把密钥直接写进共享命令或脚本，建议优先使用上面的环境变量方式。

预览

npx voc-openapi-mcp@latest setup --api-key voc_live_sk_xxx --dry-run

注意： 当前为了实现一条命令完成配置，API Key 会以明文写入本地 MCP 客户端配置文件。

示例结果

这个示例展示了单次 Agent 请求如何结合商品和 Listing 数据、评论洞察、客户痛点、竞争定位与建议行动。点击图片可查看完整结果。

能力

• 获取 Amazon 最新评论或历史评论。
• 分析情感、痛点和主题。
• 基于客户反馈生成 Listing 优化文案。
• 将客户反馈和商品 Listing 转换为结构化标签。

完整 7 Tool 清单、输入字段、Credits 费用和任务副作用见 TOOLS.md。

隐私、权限与支持

远程 Server 只接收用户选择的 Tool 输入，以及访问授权 VOC 账号所需的 X-API-Key。 安装器只写入所选 AI 客户端的 MCP 配置和可选 VOC Skill。安装前请阅读 PRIVACY.md 和 SECURITY.md。

• 产品官网
• 隐私政策
• 服务条款
• 支持
• Official Registry 元数据

开源许可证

本安装器源代码使用 Apache License 2.0 开源。托管的 VOC OpenAPI 服务及其 业务能力仍受 VOC 服务条款 约束。