{
  "markdown": "# VOC OpenAPI MCP Installer\n\n[English](README.md) | [简体中文](README.zh-CN.md)\n\nInstall the full VOC OpenAPI MCP server for Amazon review insights,\nfeedback tagging, listing optimization, and hundreds of published data tools in local AI clients.\n\nBuilt for e-commerce operators, consumer-insights teams, product researchers,\nand AI agents that need authorized review data and repeatable VOC workflows.\n\n## Usage\n\n```bash\ncurl -fsSL https://open.voc.ai/install.sh | bash\n```\n\nBy default, the installer opens your browser to sign in to VOC and approve access.\nAfter authorization, it automatically writes the MCP configuration for the supported\nclients detected on your machine, including Codex, Claude, Cursor, and others listed below.\n\nWindows PowerShell:\n\n```powershell\nirm https://open.voc.ai/install.ps1 | iex\n```\n\nAlternatively, use the npm package directly:\n\n```bash\nnpx voc-openapi-mcp@latest setup\n```\n\nCodex users can also install the general-purpose VOC OpenAPI query skill:\n\n```bash\nnpx voc-openapi-mcp@latest setup --with-skill\n```\n\nThe skill is written to `~/.agents/skills/voc-openapi/SKILL.md` only when Codex is detected. The uninstaller removes only installer-managed versions that have not been modified by the user.\n\nBy default, the installer registers the agents detected on the local machine. It currently supports:\n\n- Claude Code (CLI; writes to `~/.claude.json`)\n- Claude Desktop (desktop app; detects the macOS app or Windows `%LOCALAPPDATA%\\AnthropicClaude`, writes to `claude_desktop_config.json`, and bridges the remote MCP server through `mcp-remote`)\n- Cursor (desktop app or CLI launcher; detects the macOS app or Windows `%LOCALAPPDATA%\\Programs\\cursor`, both using `~/.cursor/mcp.json`)\n- Windsurf (desktop app or CLI launcher; detects the macOS app or Windows `%LOCALAPPDATA%\\Programs\\Windsurf`, both using `~/.codeium/windsurf/mcp_config.json`)\n- WorkBuddy (desktop app; writes user-level `~/.workbuddy/mcp.json`)\n- Gemini CLI (writes to `~/.gemini/settings.json`)\n- Codex (CLI and Desktop both use `~/.codex/config.toml`)\n\nList the agents detected on the local machine:\n\n```bash\ncurl -fsSL https://open.voc.ai/install.sh | bash -s -- --list-agents\n```\n\nWindows PowerShell:\n\n```powershell\n& ([scriptblock]::Create((irm https://open.voc.ai/install.ps1))) -ListAgents\n```\n\nRegister every supported agent (the installer detects installed clients automatically by default, so this is usually unnecessary):\n\n```bash\nnpx voc-openapi-mcp@latest setup --all-agents\n```\n\nDefault configuration:\n\n- Codex: `$CODEX_HOME/config.toml`, or `~/.codex/config.toml` when `CODEX_HOME` is not set\n- Claude Code: `~/.claude.json`\n- Claude Desktop: `~/Library/Application Support/Claude/claude_desktop_config.json` (or `%APPDATA%\\Claude\\claude_desktop_config.json` on Windows)\n- Cursor: `~/.cursor/mcp.json`\n- Windsurf: `~/.codeium/windsurf/mcp_config.json`\n- WorkBuddy: `~/.workbuddy/mcp.json`\n- Gemini CLI: `~/.gemini/settings.json`\n- MCP server name: `voc-openapi`\n- MCP URL: `https://open.voc.ai/mcp-server`\n- Authentication header: `X-API-Key`\n- Full endpoint: all published VOC OpenAPI MCP tools\n- Codex MCP startup timeout: `120` seconds\n\nThe installer updates the corresponding MCP server configuration in place and does not create `.bak` backup files.\n\n## Options\n\n```bash\nvoc-mcp setup \\\n  --api-base https://open.voc.ai \\\n  --name voc-openapi \\\n  --with-skill \\\n  --config ~/.codex/config.toml\n```\n\n## Authentication\n\nBrowser sign-in is the default and recommended flow. The installer opens the VOC\nauthorization page in your default browser, waits for you to sign in and approve access,\nthen updates the detected AI clients automatically. If the browser cannot be opened, the\ninstaller prints the same authorization URL so you can open it manually. You do not need\nto copy a credential from the browser back into the terminal.\n\n### API Key alternative\n\nYou can also skip browser authorization and provide an API key directly:\n\n```bash\nVOC_OPENAPI_API_KEY=voc_live_sk_xxx npx voc-openapi-mcp@latest setup\n```\n\nKeep the API key private: do not commit it, paste it into issues or chat, or include it in\nscreenshots and logs. Prefer the environment variable above over putting the key directly\nin a shared command or script.\n\n## Preview\n\n```bash\nnpx voc-openapi-mcp@latest setup --api-key voc_live_sk_xxx --dry-run\n```\n\n> **Note:** To support a one-command setup, the API key is currently stored as plain text in the local MCP client configuration file.\n\n## Local stdio server for catalog scanners\n\nCatalog scanners such as Glama primarily use the repository Dockerfile to build\nand start a minimal local stdio MCP server for evaluation. From a source clone\nor Docker image, the server command is:\n\n```bash\nnode bin/voc-mcp.js serve\n```\n\nAfter the npm package release, the equivalent package command is:\n\n```bash\nnpx voc-openapi-mcp@latest serve\n```\n\nThis mode exposes the same seven curated tools through `tools/list` for\ncatalog introspection and Docker-based evaluation. Real `tools/call` requests\nrequire `VOC_OPENAPI_API_KEY`, `VOC_API_KEY`, or `X_API_KEY`; without a key the\nserver returns an explicit API-key-required error instead of fake business\nresults. Production users should continue to use the hosted endpoint\n`https://open.voc.ai/mcp/catalog`.\n\n## Example result\n\n<a href=\"docs/assets/voc-mcp-product-analysis-full.png\">\n  <img src=\"docs/assets/voc-mcp-product-analysis.png\" alt=\"VOC OpenAPI MCP product analysis result covering listing data, review insights, pain points, competitive positioning, and recommended actions\" width=\"900\">\n</a>\n\nThis single agent request combines product and listing data, review insights, customer pain points, competitive positioning, and recommended actions. Click the image to view the full result.\n\n## Capabilities\n\n- Fetch current or historical Amazon reviews.\n- Analyze sentiment, pain points, and themes.\n- Generate listing improvements from customer feedback.\n- Tag feedback and product listings into structured taxonomies.\n\nSee [TOOLS.md](TOOLS.md) for all seven tools, input fields, credit costs, and\ntask-creating side effects.\n\n## Privacy, permissions, and support\n\nThe hosted server only receives the selected tool inputs and the `X-API-Key`\nrequired for the authorized VOC account. The installer writes only the selected\nAI client's MCP configuration and the optional VOC skill. Review\n[PRIVACY.md](PRIVACY.md) and [SECURITY.md](SECURITY.md) before installation.\n\n- [Product website](https://open.voc.ai)\n- [Privacy Policy](https://www.voc.ai/privacy-policy)\n- [Terms and Conditions](https://www.voc.ai/terms-and-conditions)\n- [Support](https://www.voc.ai/support)\n- [Official Registry metadata](server.json)\n\n## License\n\nThe installer source code is licensed under the [Apache License 2.0](LICENSE).\nThe hosted VOC OpenAPI service and its business capabilities remain subject to\nthe [VOC Terms and Conditions](https://www.voc.ai/terms-and-conditions).\n",
  "bytes": 6930,
  "sha": "562b7a62437e307c71ce5ccc531f74e09e7bc2513a396aedcd226ba615fa317c",
  "repo_slug": "solveacx/voc-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_solveacx_voc_mcp_3058e4d5/readme"
}