Skip to main content
Glama
README.md
# InSales MCP

MCP-сервер для работы с товарами, каталогом, контентом и темами магазина InSales из чата.

## Установка через агента

Скопируйте этот промпт в Codex, Cursor или другой агент с доступом к терминалу и файлам.

```text
Установи InSales MCP командой npm install -g insales-mcp-server. Нужен Node.js 22.13 или новее.
Определи файл настроек MCP моего клиента и добавь в него сервер insales. Если файла ещё нет, создай его в стандартном месте для этого клиента.
Используй команду insales-mcp и транспорт stdio. Если клиент не видит команду в PATH, укажи абсолютный путь к ней.
Сохрани остальные настройки и уже введённые реквизиты. Для нового подключения используй следующие заполнители в окружении сервера.
INSALES_STORE_URL=https://shop.myinsales.ru
INSALES_API_KEY_ID=<api-key-id>
INSALES_API_KEY_PASSWORD=<api-key-password>
Пришли кликабельную ссылку на локальный файл, который ты изменил, и покажи, какие поля мне заполнить.
Я добавлю реквизиты в файл сам. Не проси присылать ключ в чат.
```

Подставьте HTTPS-адрес магазина, идентификатор и пароль API-ключа. Затем перезапустите клиент. [Как создать API-ключ в InSales](https://www.insales.ru/collection/doc-rabota-s-api-i-prilozheniya/product/kak-sdelat-zapros-k-api)

Проверьте подключение запросом «Покажи первые пять товаров из моего магазина InSales с ID и названиями».

## Ручная настройка

Сервер можно запускать через `npx -y insales-mcp-server@latest`. Используйте [пример JSON](mcp.example.json) или [конфигурацию Codex](docs/configuration.md#codex).

## Режимы и доступ к темам

Укажите нужные переменные в окружении сервера MCP и перезапустите клиент.

| Переменная | По умолчанию | Что меняет |
| --- | --- | --- |
| `INSALES_MCP_MODE` | `code` | `code` позволяет выполнить несколько действий одним вызовом. `tools` предоставляет отдельные именованные инструменты. |
| `INSALES_MCP_FULL_API` | `false` | `true` открывает доступ к дополнительным операциям из каталога REST API InSales. |
| `INSALES_MCP_ACCESS` | `full` | `full` использует права API-ключа. `theme_files` оставляет запись только в темы, виджеты, блоки и раздел «Файлы». Чтение остальных данных доступно. |
| `INSALES_MCP_THEME_ID` | Не задана | Укажите положительный ID, чтобы разрешить запись только в выбранную тему. Чтение всех тем доступно, публикация и дублирование отключены. |

Оба ограничения записи можно включить вместе. Изменения общих блоков, панелей и шаблонов могут затронуть несколько тем.

[Полная настройка и диагностика](docs/configuration.md) · [Пакет npm](https://www.npmjs.com/package/insales-mcp-server) · [Лицензия MIT](LICENSE)

TDQS

A4.5/5.0

Scored across 2 tools

Disambiguation3/5

Both tools run JavaScript against the same InSales runtime, and execute_write can also perform reads, so the main boundary is write permission rather than a distinct operation type. Descriptions clarify the read/write split, but selection still requires understanding execution_id/idempotency and the permission model.

Naming Consistency5/5

Both tools follow the same execute_read / execute_write verb-permission pattern, which is predictable and consistent. There is no mixing of conventions.

Tool Count3/5

The server exposes only two meta-tools for the entire InSales API, and both carry long, nearly identical execution instructions. This may be intentional for a generic gateway, but it falls into the borderline 1-2 tool range.

Completeness5/5

Through catalog discovery and generic insales.<method> calls, the tools can cover arbitrary read and write operations. Result references, schema inspection, and idempotent writes round out the surface with no obvious lifecycle gaps for a gateway design.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues