Woocommerce Mcp Server

mcp-server-woocommerce

Claude などの AI アシスタントから WooCommerce ストアを管理するための MCP サーバーです。商品、注文、顧客、クーポン、配送、税金、Webhook、設定、レポートなどを網羅する 101 個のツールを提供します。

クイックスタート

1. WooCommerce API キーを取得する

WordPress の管理画面で、WooCommerce > 設定 > 高度な設定 > REST API > キーを追加を選択し、読み取り／書き込み権限を設定します。

2. AI ツールに追加する

インストールは不要です。npx から直接実行できます。

{
  "mcpServers": {
    "woocommerce": {
      "command": "npx",
      "args": ["-y", "@amitgurbani/mcp-server-woocommerce"],
      "env": {
        "WORDPRESS_SITE_URL": "https://store.example.com",
        "WOOCOMMERCE_CONSUMER_KEY": "ck_your_key",
        "WOOCOMMERCE_CONSUMER_SECRET": "cs_your_secret"
      }
    }
  }
}

{
  "mcpServers": {
    "woocommerce": {
      "command": "npx",
      "args": ["-y", "@amitgurbani/mcp-server-woocommerce"],
      "env": {
        "WORDPRESS_SITE_URL": "https://store.example.com",
        "WOOCOMMERCE_CONSUMER_KEY": "ck_your_key",
        "WOOCOMMERCE_CONSUMER_SECRET": "cs_your_secret"
      }
    }
  }
}

{
  "mcpServers": {
    "woocommerce": {
      "command": "npx",
      "args": ["-y", "@amitgurbani/mcp-server-woocommerce"],
      "env": {
        "WORDPRESS_SITE_URL": "https://store.example.com",
        "WOOCOMMERCE_CONSUMER_KEY": "ck_your_key",
        "WOOCOMMERCE_CONSUMER_SECRET": "cs_your_secret"
      }
    }
  }
}

4. 使い始める — AI アシスタントに次のようなことを依頼できます。

「在庫切れの商品をすべて一覧表示して」 「50 ドルを超える注文で使える 10% オフのクーポンを作成して」 「今週の売上レポートを表示して」

機能

• ストアを総合的に管理 — 商品、カテゴリー、タグ、ブランド、注文、顧客、クーポンの CRUD 操作
• 商品分類 — 属性、属性用語、バリエーションに対応し、一括処理も可能
• 配送 — ゾーン、ゾーン方式、配送クラス
• 税金 — 税率、税クラス
• Webhook — Webhook サブスクリプションの作成、管理、監視
• 設定 — ストア設定の読み取りと更新
• レポート — 売上レポート、売れ筋商品、注文／商品／顧客の合計
• メディア管理 — WordPress REST API を使用して、孤立したメディアの一覧表示、削除、整理
• トークンの最適化 — すべてのツールで fields パラメーターを使用して特定のフィールドだけを返し、レスポンスサイズを 60～97% 削減できます
• MCP リソース — エージェントがコンテキストとして参照できる、商品、注文、クーポン、返金、決済ゲートウェイのスキーマ参照情報
• ガイド付きプロンプト — バリエーション商品の設定、注文処理、カタログ概要のための複数ステップのワークフロー
• ツールの注釈 — 101 個すべてのツールに readOnlyHint、destructiveHint、idempotentHint を付与し、安全なエージェントの動作を支援
• 問題解決に役立つエラー — エラーレスポンスに、よくある問題の修正方法を含みます

安全性

このサーバーは実稼働中の WooCommerce ストアに接続します。 作成、更新、削除の各操作はすべて実際のデータに影響します。特に本番ストアでは注意してください。

始める前に

• 破壊的なツールを使う前に、ストアをバックアップしてください。 WordPress のバックアッププラグイン、またはホスティングサービスのバックアップ機能を使用します。
• まずステージング環境でテストしてください。 本番ストアをステージング環境に複製し、このサーバーの接続先をステージング環境の URL に設定します。
• 調査時は読み取り専用モードを使用してください。 WOOCOMMERCE_MCP_READ_ONLY=true を設定すると、すべての書き込み操作がブロックされます。一覧表示、取得、レポートのツールのみ使用できます。

取り消しできない操作

ほとんどの削除操作では、アイテムはゴミ箱に移動されます（復元可能）。ただし、次の操作は完全に削除され、取り消すことができません。

連鎖的な影響

一部の操作は、変更対象のアイテムだけでなく、それ以上に影響します。

• 属性を削除すると、すべての商品からその属性が削除されます。バリエーションのある商品が壊れる可能性があります
• 属性タームを削除すると、すべての商品とバリエーションからそのオプションが削除されます
• 配送ゾーンを削除すると、そのゾーン内のすべての配送方法と地域が削除されます
• 一括操作（batch_update_attribute_terms、batch_update_variations）では、1 回の呼び出しで作成、更新、削除を行うことができます

API キーの権限

安全性を最大限に高めるには、必要な権限だけを持つ WooCommerce API キーを作成してください。

• 読み取り専用での調査：Read 権限のみを持つキーを作成します
• 完全な管理：Read/Write 権限を使用します

利用可能なツール（101）

リソース

このサーバーは、AI エージェント向けのスキーマ参照情報とガイドを提供する 7 つの MCP リソースを公開しています。

リソースは読み取り専用のコンテキストです。API 呼び出しを行う前に、エージェントが WooCommerce のデータ構造を理解するために取得できます。

プロンプト

複数ステップの操作をオーケストレーションする、ガイド付きワークフロープロンプトが5つあります。

ツールのアノテーション

すべてのツールには、AI エージェントが安全に判断できるよう、動作に関するヒントが付与されています。

すべてのツールで openWorldHint: false も設定されています。WooCommerce とのみやり取りし、外部への副作用はありません。

設定

環境変数

.env ファイルを使う

認証情報を直接記述する代わりに、.env ファイルがあるディレクトリを指定します。

{
  "mcpServers": {
    "woocommerce": {
      "command": "npx",
      "args": ["-y", "@amitgurbani/mcp-server-woocommerce"],
      "cwd": "/path/to/your/project"
    }
  }
}

複数のストア

異なるサーバー名を使うと、1つのプロジェクトから複数のストアを管理できます。

{
  "mcpServers": {
    "store-a": {
      "command": "npx",
      "args": ["-y", "@amitgurbani/mcp-server-woocommerce"],
      "env": { "WORDPRESS_SITE_URL": "https://store-a.com", "..." }
    },
    "store-b": {
      "command": "npx",
      "args": ["-y", "@amitgurbani/mcp-server-woocommerce"],
      "env": { "WORDPRESS_SITE_URL": "https://store-b.com", "..." }
    }
  }
}

トークンの最適化

すべてのツールでは、特定のフィールドのみを返すための省略可能な fields パラメーター（カンマ区切り）をサポートしています。

# Browsing products — just names and prices
fields: "id,name,price"

# Stock check
fields: "id,name,stock_status,stock_quantity"

# Order overview
fields: "id,number,status,total"

これによりレスポンスサイズが**60～97%**削減され、AI のコンテキストウィンドウを必要な情報に絞り、コストを抑えられます。

開発

git clone https://github.com/AmitGurbani/mcp-server-woocommerce.git
cd mcp-server-woocommerce
pnpm install

pnpm dev               # Watch mode
pnpm build             # Build
pnpm start             # Run directly
pnpm test              # Run unit tests
pnpm test:integration  # Run integration tests (requires Docker)
pnpm test:watch        # Run unit tests in watch mode
pnpm inspector         # Debug with MCP Inspector

統合テストは、@wordpress/env を介して、実際の WordPress 6.9.4 + WooCommerce 10.5.3 インスタンスに対して実行されます。前提条件：Docker。pnpm test:integration を実行すると、テスト環境が自動的に起動します。

Docker

docker build -t mcp-server-woocommerce .
docker run \
  -e WORDPRESS_SITE_URL=https://store.example.com \
  -e WOOCOMMERCE_CONSUMER_KEY=ck_your_key \
  -e WOOCOMMERCE_CONSUMER_SECRET=cs_your_secret \
  mcp-server-woocommerce

リモート／モバイルアクセス（HTTP トランスポート）

Claude モバイル、ChatGPT、その他のリモートクライアントから WooCommerce ツールにアクセスするには、サーバーを HTTP モードで実行します。

MCP_TRANSPORT=http MCP_AUTH_TOKEN=your-secret-token node build/index.js

または、Docker を使用します。

docker run -p 3000:3000 \
  -e MCP_TRANSPORT=http \
  -e MCP_AUTH_TOKEN=your-secret-token \
  -e WORDPRESS_SITE_URL=https://store.example.com \
  -e WOOCOMMERCE_CONSUMER_KEY=ck_your_key \
  -e WOOCOMMERCE_CONSUMER_SECRET=cs_your_secret \
  mcp-server-woocommerce

MCP_AUTH_TOKEN、または AUTH0_DOMAIN、AUTH0_AUDIENCE、MCP_SERVER_URL のすべてが必要です。

デプロイガイド：Railway（約 $0／月）、Fly.io（スケール・トゥ・ゼロで約 $0／月）、Docker へのデプロイ手順については、docs/DEPLOYMENT.md を参照してください。

Claude Desktop / Code：ベアラートークン認証を使用します。設定にサーバー URL と Authorization: Bearer <token> ヘッダーを追加してください。

Claude.ai ウェブ／モバイル：Auth0（無料プラン）を介した OAuth 2.1 が必要です。設定手順については、デプロイガイドを参照してください。

デフォルトのモードは引き続き stdio です。既存の npx ユーザーには影響しません。

ライセンス

MIT

WooCommerce は Automattic Inc. の登録商標です。このプロジェクトは Automattic Inc. と提携、推奨、または後援されていません。