Раздел 2: MCP Integration

AI Client (Claude)
    ↓ (MCP protocol over stdio/JSON-RPC)
Local MCP Proxy (mcp-wordpress-remote)
    ↓ (HTTP/HTTPS requests with authentication)
Remote WordPress MCP Server (mcp-adapter)
    ↓ (WordPress Abilities API)
WooCommerce Abilities
    ↓ (REST API calls or direct operations)
WooCommerce Core

// В файле functions.php или плагине
add_filter( 'woocommerce_features', function( $features ) {
    $features['mcp_integration'] = true;
    return $features;
});

wp option update woocommerce_feature_mcp_integration_enabled yes

https://ohana.market/wp-json/woocommerce/mcp

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

# WooCommerce MCP Configuration
WOOCOMMERCE_MCP_URL=https://ohana.market/wp-json/woocommerce/mcp
WOOCOMMERCE_CONSUMER_KEY=ck_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
WOOCOMMERCE_CONSUMER_SECRET=cs_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

# Polling Configuration
SHOP_POLLING_INTERVAL=60
SHOP_PENDING_PAYMENT_THRESHOLD=48

X-MCP-API-Key: consumer_key:consumer_secret

X-MCP-API-Key: ck_abc123def456:cs_xyz789ghi012

// НЕ ИСПОЛЬЗОВАТЬ В ПРОДАКШЕНЕ
add_filter( 'woocommerce_mcp_allow_insecure_transport', '__return_true' );

woocommerce/orders-list
{
  "status": "processing",
  "per_page": 20,
  "orderby": "date",
  "order": "desc"
}

[
  {
    "id": 12345,
    "status": "processing",
    "date_created": "2026-01-25T10:30:00",
    "total": "5990.00",
    "currency": "RUB",
    "billing": {
      "first_name": "Иван",
      "last_name": "Петров",
      "email": "ivan@example.com",
      "phone": "+7999123456"
    },
    "line_items": [
      {
        "id": 1,
        "name": "Платье летнее",
        "product_id": 567,
        "quantity": 1,
        "total": "5990.00"
      }
    ]
  }
]

woocommerce/orders-get
{
  "id": 12345
}

woocommerce/products-list
{
  "search": "платье",
  "status": "publish",
  "per_page": 10
}

[
  {
    "id": 567,
    "name": "Платье летнее",
    "slug": "plate-letnee",
    "status": "publish",
    "price": "5990",
    "regular_price": "7990",
    "sale_price": "5990",
    "sku": "DR-2026-001",
    "stock_quantity": 15,
    "stock_status": "instock",
    "categories": [
      {"id": 10, "name": "Платья"}
    ],
    "brands": [
      {"id": 5, "name": "Охана Style"}
    ],
    "images": [
      {"src": "https://ohana.market/wp-content/uploads/..."}
    ]
  }
]

woocommerce/products-list
{
  "brand": 5,
  "status": "publish"
}

1. woocommerce/orders-list (status=completed, after=start_date, before=end_date)
2. Claude агрегирует поле "total" из всех заказов

1. Получить все completed заказы за период
2. Сумма total / количество заказов

1. Получить все completed заказы за период
2. Извлечь line_items из каждого заказа
3. Агрегировать по product_id: сумма quantity, сумма total
4. Сортировать по total desc

1. Получить топ товаров
2. Для каждого товара получить бренд через products-get
3. Агрегировать по brand_id

1. woocommerce/orders-list (status=pending, before=NOW-48h)
2. Вернуть список заказов

User: "Аналитика продаж за последнюю неделю"

Claude:
1. Вызывает woocommerce/orders-list с:
   - status: completed
   - after: 2026-01-18T00:00:00
   - before: 2026-01-25T23:59:59
   - per_page: 100
2. Агрегирует данные
3. Формирует отчёт:
   - Выручка: 450,000 ₽
   - Заказов: 75
   - Средний чек: 6,000 ₽
   - Топ-5 товаров
   - Распределение по брендам

# Redis keys
SHOP_LAST_ORDER_ID = "shop:polling:last_order_id"
SHOP_LAST_POLL_TIME = "shop:polling:last_poll_time"

woocommerce/orders-list
{
  "after": "2026-01-25T10:00:00",
  "per_page": 50,
  "orderby": "date",
  "order": "asc"
}

RETRY_CONFIG = {
    "max_retries": 3,
    "initial_delay": 5,  # секунды
    "backoff_factor": 2,  # 5s -> 10s -> 20s
    "max_delay": 60
}

CIRCUIT_BREAKER_CONFIG = {
    "failure_threshold": 5,      # открытие после 5 ошибок
    "recovery_timeout": 60,      # секунды до half-open
    "half_open_requests": 1      # тестовых запросов
}

add_action( 'abilities_api_init', function() {
    wp_register_ability(
        'adolf-shop/analytics-by-brand',
        array(
            'label'       => 'Аналитика по брендам',
            'description' => 'Получение статистики продаж по брендам за период',
            'execute_callback' => 'adolf_shop_analytics_by_brand',
            'permission_callback' => function () {
                return current_user_can( 'manage_woocommerce' );
            },
            'input_schema' => array(
                'type' => 'object',
                'properties' => array(
                    'start_date' => array(
                        'type' => 'string',
                        'format' => 'date',
                        'description' => 'Начало периода'
                    ),
                    'end_date' => array(
                        'type' => 'string',
                        'format' => 'date',
                        'description' => 'Конец периода'
                    )
                ),
                'required' => array( 'start_date', 'end_date' )
            ),
            'output_schema' => array(
                'type' => 'array',
                'items' => array(
                    'type' => 'object',
                    'properties' => array(
                        'brand_id' => array( 'type' => 'integer' ),
                        'brand_name' => array( 'type' => 'string' ),
                        'total_sales' => array( 'type' => 'number' ),
                        'orders_count' => array( 'type' => 'integer' )
                    )
                )
            )
        )
    );
});

// Включение в WooCommerce MCP
add_filter( 'woocommerce_mcp_include_ability', function( $include, $ability_id ) {
    if ( str_starts_with( $ability_id, 'adolf-shop/' ) ) {
        return true;
    }
    return $include;
}, 10, 2 );

# Проверить feature flag
wp option get woocommerce_feature_mcp_integration_enabled

# Проверить endpoint
curl -I https://ohana.market/wp-json/woocommerce/mcp

# Проверить формат ключа
echo "ck_xxx:cs_xxx" | base64

# Тест аутентификации
curl -H "X-MCP-API-Key: ck_xxx:cs_xxx" \
     https://ohana.market/wp-json/woocommerce/mcp