# Spree Commerce: open-source B2B and marketplace ecommerce

MCP-сервер Spree Commerce: open-source B2B and marketplace ecommerce для Claude Code управляет каталогом и отчётами интернет-магазина через ИИ-агентов. Эндпоинт принимает запросы с правами администратора.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 15848 у репозитория
- Автор: spree
- Лицензия: BSD-3-Clause · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/spree/spree/tree/HEAD/spree/mcp
- Обновлён: 2026-11-16
- Проверка безопасности: автоматическая, 2026-11-17 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/mcp/spree-commerce-open-source-b2b-and-marketplace-ecommerce

## Что делает

Сервер работает поверх бэк-офиса Spree и подключается к ИИ-клиентам по протоколу Model Context Protocol. Агент получает доступ к каталогу товаров, отчётам и настройкам магазина на естественном языке. Права доступа зависят от токена администратора, который выдаётся после входа в систему. Инструменты и схемы описаны в ядре платформы, а секретные ключи API для этих целей не используются.

Команда `spree add mcp` добавляет сервер в проект, либо разработчик прописывает `gem 'spree_mcp'` в файл `Gemfile`. Эндпоинт `POST /api/v3/admin/mcp` обрабатывает входящие запросы. Авторизация происходит через OAuth-токен, подтверждённый пользователем, поэтому модель получает только разрешённый набор инструментов.

## Требования
- Удалённый сервер: `https://{store_domain}/api/v3/admin/mcp`

## Установка

### Claude Code (родная платформа)

1. **Адрес-шаблон**
- Адрес сервера — шаблон: подставьте свои значения вместо {…} или […]

2. **Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http ecommerce-b2b-marketplace https://{store_domain}/api/v3/admin/mcp
```

### Codex

1. **Адрес-шаблон**
- Адрес сервера — шаблон: подставьте свои значения вместо {…} или […]

2. **Командой платформы: удалённый сервер**
```bash
codex mcp add mcp --url https://{store_domain}/api/v3/admin/mcp
```

### Cursor

1. **Адрес-шаблон**
- Адрес сервера — шаблон: подставьте свои значения вместо {…} или […]

2. **Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp": {
            "url": "https://{store_domain}/api/v3/admin/mcp"
        }
    }
}
```

### GitHub Copilot

1. **Адрес-шаблон**
- Адрес сервера — шаблон: подставьте свои значения вместо {…} или […]

2. **Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp": {
            "type": "http",
            "url": "https://{store_domain}/api/v3/admin/mcp"
        }
    }
}
```

### Gemini CLI

1. **Адрес-шаблон**
- Адрес сервера — шаблон: подставьте свои значения вместо {…} или […]

2. **Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http mcp https://{store_domain}/api/v3/admin/mcp
```

## Когда брать
- управлять каталогом товаров интернет-магазина через чат
- получать отчёты по продажам и заказам с помощью агента
- настраивать параметры магазина на естественном языке
- ограничивать права ИИ-агента через OAuth-токен администратора

## Примеры запросов агенту
- Покажи структуру каталога и последние заказы
- Добавь новый товар в категорию через MCP
- Сформируй отчёт по продажам за прошлую неделю

## Похожие
- [commerce-b2b-open-code-components-integrate](https://affpapa.org/nevibecode/skills/commerce-b2b-open-code-components-integrate.md) — скилл · 4700 установок
- [commerce-b2b-open-code-components-replace](https://affpapa.org/nevibecode/skills/commerce-b2b-open-code-components-replace.md) — скилл · 4600 установок
- [Tidewave Rails](https://affpapa.org/nevibecode/mcp/tidewave-rails.md) — MCP-сервер · ★ 476 у репозитория
- [architecture-well-architected-commerce](https://affpapa.org/nevibecode/skills/architecture-well-architected-commerce.md) — скилл · 1300 установок
- [marketplace-catalog-sync](https://affpapa.org/nevibecode/skills/marketplace-catalog-sync.md) — скилл · 1100 установок
- [rails-cursorrules-prompt-file](https://affpapa.org/nevibecode/rules/rails-cursorrules-prompt-file.md) — правило · ★ 41178 у репозитория

Из того же набора: [spree/spree](https://affpapa.org/nevibecode/by/spree/spree.md) — 2 карточки

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
