VOC OpenAPI MCP

VOC OpenAPI MCP インストーラー

英語 | 簡体字中国語

Amazon のレビュー分析、フィードバックのタグ付け、商品リスティングの最適化、そして公開済みの数百種類のデータツールを、ローカルの AI クライアントから利用できるようにする、VOC OpenAPI MCP サーバーのフル版をインストールします。

認証済みのレビュー データと、繰り返し利用できる VOC ワークフローを必要とする、EC 運営者、消費者インサイトチーム、商品リサーチ担当者、AI エージェント向けに構築されています。

使い方

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

デフォルトでは、インストーラーがブラウザーを開き、VOC にサインインしてアクセスを承認するよう求めます。 認証後、Codex、Claude、Cursor など、以下に記載されている、お使いのマシンで検出された対応クライアントの MCP 設定を自動的に書き込みます。

Windows PowerShell：

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

または、npm パッケージを直接使用できます。

npx voc-openapi-mcp@latest setup

Codex ユーザーは、汎用の VOC OpenAPI クエリスキルもインストールできます。

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

このスキルは、Codex が検出された場合にのみ ~/.agents/skills/voc-openapi/SKILL.md に書き込まれます。アンインストーラーは、ユーザーによって変更されていない、インストーラーが管理するバージョンのみを削除します。

デフォルトでは、インストーラーはローカルマシンで検出されたエージェントを登録します。現在、以下に対応しています。

• Claude Code（CLI；~/.claude.json に書き込みます）
• Claude Desktop（デスクトップアプリ；macOS アプリまたは Windows の %LOCALAPPDATA%\AnthropicClaude を検出し、claude_desktop_config.json に書き込み、mcp-remote を介してリモート MCP サーバーに接続します）
• Cursor（デスクトップアプリまたは CLI ランチャー；macOS アプリまたは Windows の %LOCALAPPDATA%\Programs\cursor を検出し、どちらも ~/.cursor/mcp.json を使用します）
• Windsurf（デスクトップアプリまたは CLI ランチャー；macOS アプリまたは 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

対応するすべてのエージェントを登録します（デフォルトでは、インストーラーがインストール済みのクライアントを自動検出するため、通常は必要ありません）。

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 サーバー名：voc-openapi
• MCP URL：https://open.voc.ai/mcp-server
• 認証ヘッダー：X-API-Key
• エンドポイント：公開済みの VOC OpenAPI MCP ツールすべて
• Codex MCP の起動タイムアウト：120 秒

インストーラーは、対応する MCP サーバーの設定をその場で更新し、.bak バックアップファイルは作成しません。

オプション

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

認証

ブラウザーでのサインインがデフォルトであり、推奨されるフローです。インストーラーはデフォルトのブラウザーで VOC の認証ページを開き、サインインしてアクセスを承認するまで待機した後、検出された AI クライアントを自動的に更新します。ブラウザーを開けない場合、インストーラーは同じ認証 URL を表示するため、手動で開くことができます。ブラウザーから認証情報をコピーしてターミナルに戻す必要はありません。

API キーを使用する場合

ブラウザー認証を省略し、API キーを直接指定することもできます。

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

API キーは非公開にしてください。コミットしたり、イシューやチャットに貼り付けたり、スクリーンショットやログに含めたりしないでください。キーを共有コマンドやスクリプトに直接記述するのではなく、上記の環境変数を使用してください。

プレビュー

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

注記： コマンド一つでセットアップできるようにするため、API キーは現在、ローカルの MCP クライアント設定ファイルにプレーンテキストで保存されます。

カタログスキャナー用のローカル stdio サーバー

Glama などのカタログスキャナーは、主にリポジトリの Dockerfile を使用して、評価用の最小限のローカル stdio MCP サーバーをビルドして起動します。ソースをクローンした場合、または Docker イメージから起動する場合、サーバーコマンドは次のとおりです。

node bin/voc-mcp.js serve

npm パッケージのリリース後に使用する同等のパッケージコマンドは次のとおりです。

npx voc-openapi-mcp@latest serve

このモードでは、カタログの情報取得と Docker ベースの評価のために、厳選された同じ 7 つのツールを tools/list で公開します。実際の tools/call リクエストには VOC_OPENAPI_API_KEY、VOC_API_KEY、または X_API_KEY が必要です。キーがない場合、サーバーは架空のビジネス結果を返すのではなく、API キーが必要であることを明示するエラーを返します。本番環境のユーザーは、引き続きホスト型エンドポイント https://open.voc.ai/mcp/catalog を使用してください。

結果の例

この単一のエージェントリクエストで、商品と出品データ、レビュー分析、顧客の悩み、競合に対する位置づけ、推奨アクションをまとめて取得できます。画像をクリックすると、結果の全体を表示できます。

機能

• Amazon の最新または過去のレビューを取得します。
• センチメント、顧客の悩み、テーマを分析します。
• 顧客のフィードバックに基づいて出品内容の改善案を作成します。
• フィードバックと商品出品情報にタグを付け、構造化された分類体系に整理します。

7 つのツール、入力フィールド、クレジットコスト、タスクを作成する副作用については、TOOLS.md を参照してください。

プライバシー、権限、サポート

ホスト型サーバーが受け取るのは、選択したツールの入力と、認証済み VOC アカウントに必要な X-API-Key のみです。インストーラーが書き込むのは、選択した AI クライアントの MCP 設定と、任意の VOC スキルのみです。インストール前に PRIVACY.md と SECURITY.md を確認してください。

• 製品ウェブサイト
• プライバシーポリシー
• 利用規約
• サポート
• 公式レジストリのメタデータ

ライセンス

インストーラーのソースコードは、Apache License 2.0 に基づいてライセンスされています。 ホスト型 VOC OpenAPI サービスとそのビジネス機能には、引き続き VOC 利用規約が適用されます。