blacksea-mcp

MCP-сервер для BlackSea (blacksea.in.ua): підключи свій магазин до Claude, Cursor чи будь-якого MCP-клієнта — і агент зможе читати каталог, збирати та публікувати кастомні лендінги продуктів і кастомну сторінку профілю без копіювання токенів у промпти.

1. Створи токен доступу

1. BlackSea → Налаштування → Додатково → Застосунки.
2. Створи застосунок і згенеруй access token зі scopes: view_public, edit_products, edit_profile (+ view_sales, якщо хочеш дати агенту статистику продажів).
3. Кастомні сторінки вмикаються фічефлагом custom_html_pages — напиши в підтримку, якщо ще не увімкнено.

2. Підключи сервер

Claude Code

claude mcp add blacksea -e BLACKSEA_ACCESS_TOKEN=<твій_токен> -- npx -y blacksea-mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "blacksea": {
      "command": "npx",
      "args": ["-y", "blacksea-mcp"],
      "env": { "BLACKSEA_ACCESS_TOKEN": "<твій_токен>" }
    }
  }
}

Cursor (.cursor/mcp.json)

{
  "mcpServers": {
    "blacksea": {
      "command": "npx",
      "args": ["-y", "blacksea-mcp"],
      "env": { "BLACKSEA_ACCESS_TOKEN": "<твій_токен>" }
    }
  }
}

Опційно: BLACKSEA_API_URL (за замовчуванням https://api.blacksea.in.ua).

Інструменти

| Tool | Що робить | | --- | --- | | get_profile | Профіль продавця (ім'я, біо, username, URL) | | list_products / get_product | Каталог і деталі продукту | | get_product_page | Поточний кастомний лендінг продукту | | preview_product_page | Прогнати HTML через санітайзер без публікації (звіт що вирізано) | | publish_product_page | Опублікувати/оновити лендінг продукту | | clear_product_page | Повернути стандартну сторінку продукту | | get_profile_page | Поточна кастомна сторінка профілю | | preview_profile_page | Санітайзер-прев'ю сторінки профілю | | publish_profile_page | Опублікувати/оновити сторінку профілю | | clear_profile_page | Повернути стандартний профіль | | get_store_analytics | Аналітика магазину: продажі/виручка/безкоштовні завантаження по продуктах, перегляди за 30 днів, відгуки, фоловери, виручка по місяцях (scope view_sales) | | list_sales | Продажі (потрібен scope view_sales) |

Типовий флоу агента: get_product → згенерувати HTML → preview_product_page (доки sanitization_report чистий) → publish_product_page.

Розробка

cd mcp
npm install
npm run build
BLACKSEA_ACCESS_TOKEN=... BLACKSEA_API_URL=http://api.localhost:3000 node dist/index.js