# ووکامرس WooCommerce MCP (WooCommerce MCP)

مشتریان با استفاده از این سرور MCP می‌توانند فروشگاه‌های ووکامرس خود را به دستیار هوش مصنوعی متصل کرده و مدیریت کنند.

- نوع: سرور MCP
- دسته: فروشگاه اینترنتی
- منبع: جامعه
- سازنده: ناصر صدرمنش (https://github.com/sadrmanesh)
- مجوز: MIT
- آخرین بررسی: 2026-11-19
- صفحه: https://mcpfarsi.ir/servers/woocommerce-mcp/
- مخزن: https://github.com/sadrmanesh/woocommerce-mcp
- وب‌سایت سرویس: https://sadrmanesh.github.io/woocommerce-mcp/

## هشدارها

- نیازمند کلید API: برای کار کردن، کلید حساب خودتان در این سرویس لازم است.
- تغییر در حساب شما: بعضی ابزارهایش کاری انجام می‌دهند (مثلاً پیام می‌فرستند)، نه فقط خواندن.

## نصب

- اجرا (stdio): `npx -y @sadrmanesh/woocommerce-mcp`
- متغیر محیطی `WOOCOMMERCE_URL` (لازم): Store origin, such as https://store.example.com
- متغیر محیطی `WOOCOMMERCE_CONSUMER_KEY` (لازم، محرمانه): WooCommerce REST API consumer key (ck_...)
- متغیر محیطی `WOOCOMMERCE_CONSUMER_SECRET` (لازم، محرمانه): WooCommerce REST API consumer secret (cs_...)
- متغیر محیطی `WOOCOMMERCE_READ_ONLY` (اختیاری): Refuse every write tool. Set to false to allow writes
- متغیر محیطی `WOOCOMMERCE_REDACT_PII` (اختیاری): Mask customer names, emails, phones, and addresses in results
- متغیر محیطی `WOOCOMMERCE_TOOLS_DENY` (اختیاری): Comma-separated tool names or patterns to hide, such as delete_*

## ابزارها

- `woocommerce_list_products`: دریافت لیست محصولات فروشگاه همراه با فیلتر قیمت، موجودی و دسته‌بندی
- `woocommerce_update_product`: ویرایش مشخصات، موجودی انبار و قیمت محصولات
- `woocommerce_update_order_status`: تغییر وضعیت سفارش‌ها (مانند در حال انجام یا تکمیل‌شده)
- `woocommerce_create_refund`: ثبت بازپرداخت (Refund) برای سفارش‌ها
- `woocommerce_list_customers`: جستجو و مشاهده اطلاعات و سوابق خرید مشتریان
- `woocommerce_create_coupon`: ساخت کد تخفیف جدید با تنظیمات مبلغ و تاریخ انقضا
- `woocommerce_delete_coupon`: حذف کدهای تخفیف موجود در فروشگاه
- `woocommerce_sales_analytics`: دریافت گزارش آمار فروش و درآمد بازه‌های زمانی مختلف
- `woocommerce_list_webhooks`: مشاهده و مدیریت وب‌هوک‌های فعال فروشگاه
- `woocommerce_list_orders`: مشاهده و جستجوی سفارش‌های فروشگاه بر اساس وضعیت یا مشتری

## نمونه سؤال‌ها

- لیست ۵ سفارش اخیر فروشگاه را نشان بده.
- تعداد محصولات کم‌موجود در انبار چقدر است؟
- وضعیت سفارش شماره ۱۲۳۴ را بررسی کن.
- برای مشتریان جدید یک کد تخفیف ۱۰ درصدی بگذار.
- گزارش فروش هفته گذشته فروشگاه را بده.

## توضیحات

### سرور ووکامرس MCP (WooCommerce MCP)

سرور WooCommerce MCP یک ابزار استاندارد مبتنی بر پروتکل Model Context Protocol برای اتصال عامل‌های هوش مصنوعی به فروشگاه‌های ووکامرس است. این سرور شامل ۴۷ ابزار عملیاتی برای مدیریت محصولات، سفارش‌ها، مشتریان و تحلیل فروش است.

#### ویژگی‌های کلیدی
- مدیریت کامل محصولات، موجودی، قیمت‌ها و دسته‌بندی‌ها
- مشاهده، فیلتر و تغییر وضعیت سفارش‌ها و ثبت بازپرداخت
- معماری چندفروشگاهی و پشتیبانی از حالت امن و فقط خواندنی
- حفاظت از حریم خصوصی مشتریان و ماسک کردن داده‌های حساس

#### نحوه راه‌اندازی
پس از ایجاد کلید REST API در پنل ووکامرس، سرور را با دستور زیر اجرا کنید:

npx -y @sadrmanesh/woocommerce-mcp
