WooCommerce MCP – как AI асистент управлява онлайн магазина ти

Какво представлява WooCommerce MCP

Model Context Protocol (MCP) е отворен стандарт за свързване на AI приложения с външни инструменти и данни. WooCommerce включва нативна MCP интеграция от версия 10.3 (октомври 2025), която излага операции с продукти и поръчки като discoverable tools за AI клиенти.

Интеграцията работи върху две технологии от WordPress екосистемата – WordPress Abilities API за регистрация на функционалности и WordPress MCP Adapter за самия протокол. AI клиент като Claude Code или Cursor изпраща заявка, локално proxy я превежда в HTTP, а WooCommerce MCP сървърът я обработва през Abilities системата. Цялата комуникация минава през стандартните WooCommerce REST API ключове за автентикация.

Функцията е в developer preview статус – API-тата може да се променят в бъдещи версии.

Архитектура и поток на данните

Пътят на една MCP заявка минава през четири слоя:

AI Client (Claude Code, Cursor)
    -> MCP протокол (stdio/JSON-RPC)
Local Proxy (@automattic/mcp-wordpress-remote)
    -> HTTP/HTTPS с API ключ
WordPress MCP Server (mcp-adapter)
    -> Abilities API
WooCommerce Core

Локалното proxy е Node.js процес, който върви на машината на разработчика. То приема stdio-базирана MCP комуникация от AI клиента и я конвертира в HTTP заявки с инжектиран X-MCP-API-Key header. WordPress MCP Server-ът приема тези заявки на endpoint /wp-json/woocommerce/mcp и ги рутира през Abilities Registry-то до съответния WooCommerce REST controller.

Текущата имплементация използва REST bridge подход – abilities се map-ват към съществуващи REST endpoints. Abilities API обаче е проектирано за гъвкавост и позволява директни DB операции, custom бизнес логика или интеграции с външни сървиси. Proxy моделът добавя около 50-100ms латентност спрямо директна REST заявка, но за batch операции през AI клиент това е незабележимо.

Операции с продукти и поръчки

MCP интеграцията покрива базови CRUD операции за два ресурса.

За продукти: list с филтриране и пагинация, четене на детайлна информация, създаване, редактиране и изтриване. За поръчки: list с филтриране и пагинация, четене на детайли, създаване и обновяване. Правата се определят от scope-а на API ключа – read ключ позволява само GET заявки, write – POST/PUT/PATCH/DELETE, а read_write – всичко.

Ако управляваш WooCommerce магазин с над 500 продукта, възможността да bulk-обновиш цени или статуси чрез AI клиент пести часове ръчна работа в админ панела. Всяка ability включва JSON Schema за входните и изходните данни, което означава, че AI клиентът разбира какви параметри приема всяка операция и какъв отговор да очаква.

Активиране на MCP в WooCommerce

Има два начина за включване на функцията. През кода:

add_filter( 'woocommerce_features', function( $features ) {
    $features['mcp_integration'] = true;
    return $features;
} );

Или чрез WP-CLI:

wp option update woocommerce_feature_mcp_integration_enabled yes

От WooCommerce 10.3 опцията е достъпна и от интерфейса – WooCommerce > Settings > Advanced > Features > Enable MCP Beta. След активиране endpoint-ът /wp-json/woocommerce/mcp става достъпен.

Генерирай REST API ключ от WooCommerce > Settings > Advanced > REST API. Избери Read/Write permissions за пълен достъп или Read за ограничен. Съхрани consumer key и consumer secret – те се показват еднократно.

Свързване на Claude Code с магазина

Конфигурацията за Claude Code е еднолинейна команда:

claude mcp add woocommerce_mcp 
  --env WP_API_URL=https://example.com/wp-json/woocommerce/mcp 
  --env CUSTOM_HEADERS='{"X-MCP-API-Key": "ck_xxx:cs_xxx"}' 
  -- npx -y @automattic/mcp-wordpress-remote@latest

За Cursor, VS Code или Claude Desktop добави JSON конфигурация в MCP settings файла:

{
  "mcpServers": {
    "woocommerce_mcp": {
      "command": "npx",
      "args": ["-y", "@automattic/mcp-wordpress-remote@latest"],
      "env": {
        "WP_API_URL": "https://example.com/wp-json/woocommerce/mcp",
        "CUSTOM_HEADERS": "{"X-MCP-API-Key": "ck_xxx:cs_xxx"}"
      }
    }
  }
}

HTTPS е задължителен по подразбиране. За локална разработка без SSL, добави филтъра:

add_filter( 'woocommerce_mcp_allow_insecure_transport', '__return_true' );

Тази настройка е изключително за development среди – никога на production. След свързване AI клиентът автоматично открива наличните tools и може да изпълнява операции с продукти и поръчки чрез естествен език.

Сигурност и защита на данните

Поръчките съдържат имена, имейли, адреси и платежни детайли. Защитата на WordPress инсталацията е задължителна преди свързване на AI клиент.

Следвай принципа least-privilege – ако AI-ят само чете продуктови данни, създай ключ с read-only scope. Ротирай ключовете на редовни интервали. Логвай MCP заявките – WooCommerce записва entries с source woocommerce-mcp в Status > Logs. При работа с клиентски данни гарантирай съответствие с GDPR – AI клиентът обработва PII, което има регулаторни последици.

Transport слоят валидира всяка заявка спрямо scope-а на ключа преди изпълнение. Невалидни permissions водят до HTTP 401/403 без изпълнение на операцията. Всеки API ключ се свързва с конкретен WordPress потребител, така че действията на AI-а се логват под неговите credentials.

WordPress Abilities API и custom abilities

WordPress 6.9 въведе Abilities API – централен регистър, в който core, плъгини и теми декларират какво могат да правят. WooCommerce регистрира продуктовите и order abilities автоматично, но ти можеш да добавиш собствени.

add_action( 'wp_abilities_api_init', function() {
    wp_register_ability( 'myshop/stock-report', [
        'label'       => 'Generate Stock Report',
        'description' => 'Returns low-stock products below threshold',
        'category'    => 'myshop',
        'input_schema' => [
            'type'       => 'object',
            'properties' => [
                'threshold' => [
                    'type'    => 'integer',
                    'default' => 5,
                ],
            ],
        ],
        'execute_callback'    => 'myshop_stock_report',
        'permission_callback' => fn() => current_user_can( 'manage_woocommerce' ),
        'meta' => [
            'show_in_rest' => true,
            'annotations'  => [
                'readonly'    => true,
                'destructive' => false,
            ],
        ],
    ] );
} );

function myshop_stock_report( $input ) {
    $threshold = $input['threshold'] ?? 5;
    $products  = wc_get_products( [
        'stock_quantity' => ' 'instock',
        'limit'          => 50,
    ] );
    return array_map( fn( $p ) => [
        'id'    => $p->get_id(),
        'name'  => $p->get_name(),
        'stock' => $p->get_stock_quantity(),
    ], $products );
}

MCP адаптерът автоматично превръща регистрираната ability в tool, достъпен за AI клиента. Не е нужен допълнителен код за MCP интеграцията – Abilities API се грижи за discoverability, schema валидация и permission проверки. Abilities от различни плъгини се натрупват в общ регистър, който AI клиентът вижда като единен набор от tools при свързване.

Community MCP сървъри за WooCommerce

Извън официалната интеграция съществуват и няколко community проекта. Чат плъгините за WordPress вече могат да се захранват с данни от MCP, което отваря нови сценарии за автоматизация.

Плъгинът MCP for WooCommerce (woo-mcp.com) е community fork на Automattic-овия wordpress-mcp, оптимизиран за read-only достъп до публични данни – продукти, категории, тагове, ревюта и методи за доставка. Не излага клиентски данни и поддържа JWT автентикация вместо REST API ключове. Подходящ е за AI chatbot-ове на фронтенда, които отговарят на въпроси за каталога без риск от exposure на PII.

techspawn/woocommerce-mcp-server предлага пълен CRUD достъп включително клиенти, данъци, купони и shipping зони. Работи с JSON-RPC 2.0 и поддържа Windows, macOS и Linux.

Практически workflow-и с WooCommerce MCP

Ето конкретни задачи, за които MCP се оказва полезен в ежедневието на WooCommerce администратор.

Масово обновяване на цени – AI клиентът чете текущите цени, прилага процент или фиксирана стойност и update-ва продуктите. При 2000 продукта това отнема секунди вместо часове в WooCommerce админа. Claude Code може да изпълни заявка от типа „увеличи цените на всички продукти в категория Обувки с 10%“ без нито един ред допълнителен код – MCP сървърът предоставя нужните tools за list и update.

Генериране на daily отчет за поръчки е друг типичен сценарий. Custom ability чете поръчките от последните 24 часа, групира ги по статус и връща summary с обща стойност. Интегрирано с AI клиент, този отчет може да се генерира всяка сутрин с текстов prompt. Автоматична проверка за ниски наличности работи по аналогичен начин – AI клиентът query-ва продукти под зададен threshold и генерира списък за дозареждане.

SEO оптимизация на каталога е по-напреднал use case. AI клиентът чете product descriptions, анализира ги за keyword density и генерира подобрени мета описания. Комбинацията с правилна SEO стратегия и MCP достъп до продуктови данни прави процеса полуавтоматичен.

Какво предстои

MCP интеграцията в WooCommerce е beta и се развива активно. WooCommerce 10.3.6 обнови MCP adapter-а до версия 0.3.0 с подобрена инициализация и съвместимост с WordPress 6.9+. WordPress Abilities API вече има JavaScript клиент в разработка, който може да влезе в WordPress 7.0 – това ще даде достъп до abilities директно от Gutenberg editor-а.

Proxy моделът (@automattic/mcp-wordpress-remote) работи надеждно, но бъдещи версии може да предложат директна MCP поддръжка вътре в WordPress без нужда от локален Node.js процес. За production среди – тествай на staging, използвай read-only ключове за начало и мониторирай WooCommerce логовете. MCP е стъпка към AI-assisted e-commerce, но стабилност и контрол остават приоритет.

Често задавани въпроси