AutoID Product Catalog & Support

AutoID MCP サーバー v0.3.1

AutoID の正規 WordPress/WooCommerce API を利用する読み取り専用 MCP サーバーです。

このリリースには、AutoID 正規 API プラグイン v0.3.9 で検証された、商品、オファー、グループ化されたバリエーション、および関連商品に関する動作が含まれています。

MCP ツール

• search_products
• get_product_group
• list_product_variants
• get_product
• get_product_offer
• get_related_products
• get_related_products_summary
• search_support
• fetch_support
• autoid_support_health
• autoid_api_health

信頼できる情報源

MCP サーバーは WordPress SQL を読み取らず、商業データや互換性データを独自に計算しません。以下の正規 API を読み取ります。

https://www.autoid.ro/wp-json/autoid-ai/v1

信頼できる商業関連フィールド：

• 正確な SKU の MSRP EUR 税抜価格：pret_lista
• 正確な SKU の AutoID 価格 EUR 税抜価格：pret_autoid_euro
• グループ化されたカタログの MSRP：grp_pret_lista_mic
• グループ化されたカタログの AutoID 価格：grp_pret_autoid_mic
• AutoID 在庫：stock_autoid
• 販売代理店在庫：stock_distributie

正確な SKU の最新価格／在庫について回答する場合は、get_product_offer を使用してください。ルーマニアのお客様向けに価格を表示する場合は、正規の ron_display 投影を使用し、税込価格を優先してください。RON は WooCommerce の _regular_price / _sale_price を参照します。MCP 内で信頼できる EUR 価格を RON に換算しないでください。

RON 表示価格

正規 API v0.3.9 では、商業データの信頼性を変えることなく、コンパクトな RON 投影が追加されています。

正確な SKU カードでは pricing.ron_display、正確なライブオファーでは price.ron_display を使用します。一般的なフィールドは msrp_ex_vat、msrp_inc_vat、autoid_ex_vat、autoid_inc_vat です。グループ化された商品では、msrp_from_inc_vat や autoid_from_inc_vat などの FROM フィールドを使用します。

ルール：

• ルーマニアのお客様向けの回答：RON の inc_vat を優先してください
• B2B／税抜価格の文脈：RON の ex_vat も表示できます
• EUR の pret_lista / pret_autoid_euro が引き続き商業データの信頼できる情報源です
• RON の値は、WooCommerce ストアフロントでの表示／検証用データです
• MCP 内で EUR の信頼できる価格に為替レートを適用して RON を計算しないでください

関連商品の仕様

get_related_products は以下を読み取ります。

/wp-json/autoid-ai/v1/relations/{sku-or-model}

対応する関連タイプ：

• accessory - 在庫管理対象
• consumable - 在庫管理対象
• software - 在庫管理対象外
• service_contract - 在庫管理対象外
• all

互換性の判定には、正規 API の product_tag による根拠のみが使用されます。関連エンティティがアクセサリー、消耗品、ソフトウェア項目、サービス契約のいずれであるかは、WooCommerce の product_cat によって決まります。

アクセサリーと消耗品について、MCP はデフォルトで availability=available を使用します。

stock_autoid > 0 OR stock_distributie > 0

正規 API では、AutoID 在庫が販売代理店のみの在庫より優先されます。在庫切れの商品は追加のカタログ情報として扱われ、デフォルトでは返されません。必要な場合に限り、availability=out_of_stock または availability=all を指定してください。

消耗品のセットが大きい場合は、正確なカテゴリーのスラッグで絞り込んでください。検証済みの ZT610 の例：

• ribboane-imprimanta
• role-de-etichete
• intretinere-imprimante

get_related_products_summary は、1 アイテムのページで availability=all をクエリし、正規のサマリーをコンパクトに投影して返します。これを使用すると、カタログの商品を何百件も MCP のコンテキストに読み込まずに、互換性のある商品の合計数や在庫切れ数を取得できます。

検証済みデータセット

検証時点での MC9300 の関連グラフ全体：

• アクセサリー 85 件
• ソフトウェアエンティティ 23 件 = 正確な SKU 22 件 + グループ化された商品 1 件
• サービス契約 130 件
• 消耗品 0 件
• 関連エンティティ合計 238 件

検証時点での ZT610 の関連グラフ全体：

• アクセサリー 85 件
• 消耗品 752 件
• ソフトウェアエンティティ 29 件 = 正確な SKU 28 件 + グループ化された商品 1 件
• サービス契約 69 件
• 関連エンティティ合計 935 件

検証時点での ZT610 消耗品：

• AutoID 在庫あり 32 件
• サプライヤー在庫のみ 206 件
• 在庫切れ 514 件

これらの数値は検証時点のスナップショットであり、本番データにハードコードされているものではありません。MCP は常にライブの正規 API を読み取ります。

要件

• Node.js 20+
• 公開 HTTPS ホスト名（mcp.autoid.ro を推奨）
• www.autoid.ro への HTTPS アウトバウンドアクセス

WordPress DB へのアクセス、WooCommerce API キー、WordPress 管理者の認証情報は必要ありません。

新規インストール

unzip autoid-mcp-v0.3.1.zip
cd autoid-mcp-v0.3.1
npm install
cp .env.example .env
npm run build
npm run smoke:api
npm start

環境変数：

AUTOID_API_BASE=https://www.autoid.ro/wp-json/autoid-ai/v1
MCP_PUBLIC_HOST=mcp.autoid.ro
PORT=3000
AUTOID_API_TIMEOUT_MS=15000

公開 MCP エンドポイント：

https://mcp.autoid.ro/mcp

HTTP プロセスのヘルスチェック：

https://mcp.autoid.ro/health

正規 API の準備状況チェック：

https://mcp.autoid.ro/ready

systemd を使用した v0.1.0 からのアップグレード

稼働中のアプリケーションディレクトリが /opt/autoid-mcp であると仮定します。

sudo systemctl stop autoid-mcp
sudo cp -a /opt/autoid-mcp /opt/autoid-mcp-backup-v0.1.0
sudo rm -rf /opt/autoid-mcp
sudo mkdir -p /opt/autoid-mcp
sudo cp -a ./autoid-mcp-v0.3.1/. /opt/autoid-mcp/
sudo cp /opt/autoid-mcp-backup-v0.1.0/.env /opt/autoid-mcp/.env
cd /opt/autoid-mcp
sudo npm install
sudo npm run smoke:api
sudo npm run build
sudo chown -R www-data:www-data /opt/autoid-mcp
sudo cp deploy/autoid-mcp.service /etc/systemd/system/autoid-mcp.service
sudo systemctl daemon-reload
sudo systemctl enable autoid-mcp
sudo systemctl restart autoid-mcp
sudo systemctl status autoid-mcp

次に、以下で確認します。

curl -s https://mcp.autoid.ro/health
curl -s https://mcp.autoid.ro/ready

Docker

このリリースアーカイブには生成済みのロックファイルが含まれていないため、同梱の Dockerfile では意図的に npm install を使用しています。

docker compose -f deploy/docker-compose.yml up -d --build

コンテナは 127.0.0.1:3000 のみにバインドされます。付属の Nginx リバースプロキシ設定を通じて公開してください。

最初の MCP 検証

デプロイ後、MCP クライアントで以下のツール呼び出しを検証してください。

autoid_api_health({})
get_product_group({ model: "MC9300" })
list_product_variants({ model: "MC9300", availability: "available", limit: 20 })
get_product_offer({ sku: "MC930B-GSHDG4RW" })
get_related_products({ target: "MC9300", relation_type: "accessory", availability: "available", limit: 20 })
get_related_products({ target: "ZT610", relation_type: "consumable", category: "ribboane-imprimanta", availability: "available", limit: 20 })
get_related_products_summary({ target: "ZT610", relation_type: "consumable" })

HestiaCP のデプロイに関する注意

ホストが HestiaCP で管理されており、ドメインテンプレートがすでに mcp.autoid.ro をポート 3000 にプロキシしている場合、Hestia の Nginx または Certbot の設定を上書きしないでください。アプリケーションファイルのみを置き換える、またはビルドし、ホスト管理者が推奨するプロセスマネージャーを通じて既存の Node プロセスを再起動してください。

セキュリティ

v0.3.1 は読み取り専用です。WordPress の認証情報を公開せず、書き込み処理も実行しません。正規 API が引き続きデータとセキュリティの境界となります。

RFQ の作成などの書き込みツールを追加する前に、認証、認可、監査ログ、悪用対策を個別に追加してください。

公開ルート

ブラウザーで https://mcp.autoid.ro/ を開くと、/health、/ready、/mcp へのリンクを含む簡易ランディングページが表示されます。Node プロセスは 127.0.0.1:3000 にバインドされ、既存の HestiaCP/Nginx リバースプロキシ経由でのみ公開することを想定しています。

サポートセンターツール — v0.3.1

公開エンドポイント https://mcp.autoid.ro/mcp では、既存のカタログツールに加えて、3 つのサポートセンターツールを利用できます。

• search_support — モデル、マニュアル、ドライバー、ファームウェア、ソフトウェア、動画、トラブルシューティング用リソースを検索します。
• fetch_support — 検索結果として返された model:<id> または resource:<id> を 1 件取得します。
• autoid_support_health — 読み取り専用のサポートセンターソースを検証します。

サポートデータは、既存の AutoID ファーストパーティサポート MCP ソース（AUTOID_SUPPORT_MCP_URL、既定値は https://www.autoid.ro/mcp/）からプロキシされます。Node サービスは WordPress の SQL、ファイルシステム、管理 API を読み取りません。製品データは引き続き AUTOID_API_BASE から取得されます。

v0.3.1 の search_support は、検索意図を考慮します。元のクエリに、モデル全体および要求されたリソースタイプの検索を組み合わせ、結果の重複を除去して、要求されたタイプを一般的なリソースより上位にランク付けします。MC9300 firmware manual のような複数の意図を含むクエリでは、関連性のない一般的なリソースより先に、ファームウェア／LifeGuard の項目とドキュメント／マニュアルの項目の両方が表示されるはずです。

チャット統合では、OpenAI Responses API の推奨設定は、https://mcp.autoid.ro/mcp を参照する読み取り専用のリモート MCP ツールを 1 つ指定し、allowed_tools リストを明示して、require_approval: never とすることです。現在の価格や在庫に関する質問には get_product_offer を使用し、技術サポートのリソースには search_support の後に fetch_support を使用してください。