Кратко
MoySklad (МойСклад) JSON API 1.2 для управления торговлей и складом: ассортимент и продукты, отчеты по остаткам, контрагенты, заказы клиентов, отгрузки, поставки, счета, магазины и отчеты о прибыли и обороте. Токен доступа.
Пошаговая настройка
Подключи MoySklad к Claude, ChatGPT или Copilot за 2 минуты
Начни бесплатный пробный период в AnythingMCP Cloud, подключи MoySklad в пошаговой настройке и добавь свой MCP URL в своего ИИ-ассистента. Без кода и без собственного сервера.
Без банковской карты · 7 дней пробного периода · Есть вариант self-host
Попробуй спросить
Примеры промптов для MoySklad
Кликни по промпту — он скопируется. Вставь в Claude, ChatGPT, Cursor, Gemini, Copilot или OpenClaw и запусти через этот коннектор.
Claude — это AI, он может ошибаться. Проверяйте ответы.
💡 Нет установки? Используй cloud.anythingmcp.com напрямую. Войди в систему, нажми Connectors → MoySklad, вставь свои учетные данные, создай ключ API MCP и готово. Никакого Docker, никакого
git clone, никакого локального сервера.
MoySklad
MoySklad (МойСклад) JSON API 1.2 для управления торговлей и складом: ассортимент и продукты, отчеты по остаткам, контрагенты, заказы клиентов, отгрузки, поставки, счета, магазины и отчеты о прибыли и обороте. Токен доступа.
Настройка
Настройка занимает около 3 минут.
- В MoySklad открой настройки (Настройки) и раздел для токенов доступа (Токены), создай токен для пользователя, от имени которого должен действовать AI, и скопируй его. Он показывается только один раз.
- Вставь его в
MOYSKLAD_TOKEN.
Без этого раздела токен также может быть выдан с помощью логина и пароля: POST на /security/token с HTTP Basic возвращает access_token (это аннулирует ранее выданные токены пользователя). Токен действует с правами своего пользователя, поэтому пользователь с правами только для чтения создает коннектор только для чтения.
Коннектор отправляет Authorization: Bearer, Accept-Encoding: gzip и Accept: application/json;charset=utf-8 при каждом вызове. MoySklad отклоняет вызовы без gzip с кодом 415 и без тела.
С чего начать: moysklad_get_employee_context показывает пользователя и его права. moysklad_list_assortment ищет все, что можно продать, moysklad_get_current_stock быстро дает номера остатков, а moysklad_list_customer_orders перечисляет заказы.
Каталог: moysklad_list_assortment, moysklad_list_products, moysklad_get_product, moysklad_create_product, moysklad_update_product, moysklad_list_product_folders.
Остатки: moysklad_get_stock_report (все магазины, с ценой и ценой продажи), moysklad_get_stock_by_store (по магазину) и moysklad_get_current_stock (идентификаторы и одно число, без постраничной навигации, хорошо для частых проверок). Два расширенных отчета считаются за 5 запросов каждый.
Контрагенты: moysklad_list_counterparties, moysklad_get_counterparty, moysklad_create_counterparty, moysklad_update_counterparty.
Документы: moysklad_list_customer_orders, moysklad_get_customer_order, moysklad_get_customer_order_metadata (статусы), moysklad_create_customer_order, moysklad_update_customer_order; moysklad_list_demands и moysklad_get_demand (отгрузки); moysklad_list_supplies и moysklad_get_supply (полученные товары); moysklad_list_invoices_out и moysklad_get_invoice_out. Справочники: moysklad_list_stores, moysklad_list_organizations.
Отчеты: moysklad_get_profit_by_product, moysklad_get_profit_by_counterparty, moysklad_get_turnover, moysklad_get_dashboard.
Постраничная навигация: списки возвращают максимум 1000 строк за вызов (limit, по умолчанию здесь 100) с offset; meta.size — это всего, а meta.nextHref присутствует, пока есть дополнительные строки. С expand лимит составляет 100: больший лимит заставляет MoySklad игнорировать expand. Строки документа за пределами первых 1000 читаются через позиции документа.
Деньги и даты: все суммы и цены указаны в копейках (мелкие единицы): 150000 означает 1500.00. Даты имеют формат YYYY-MM-DD HH:MM:SS по московскому времени. Идентификаторы — это UUID.
Справочники (meta): другой объект ссылается как объект с meta, содержащим href, type и mediaType, никогда не по голому идентификатору. Каждая строка несет свой собственный meta: копируй его, когда инструмент запрашивает ссылку (магазин, состояние, ассортимент строки заказа). В фильтрах списка ссылка — это ее href; в коротком отчете по остаткам это голый идентификатор.
Фильтры: filter соединяет условия с ;. Операторы: =, !=, >, <, >=, <=, ~ содержит, ~= начинается с, =~ заканчивается на. search — это полнотекстовый поиск. order сортирует, например, moment,desc.
Лимиты: токен пользователя получает 45 единиц за 3 секунды, и каждый запрос стоит несколько единиц (4 с 1 декабря 2026 года, то есть около 11 запросов за 3 секунды; два расширенных отчета по остаткам стоят 5). Максимум 5 вызовов одного пользователя параллельно. Код 429 содержит X-Lognex-Retry-After в миллисекундах. MoySklad отключает доступ к API для пользователей, которые продолжают отправлять неудачные вызовы (более 200 одинаковых неудачных запросов в минуту), поэтому не повторяй ошибки в цикле. Удаление объектов и платежей не входит в этот коннектор.
Предварительные условия: MOYSKLAD_TOKEN
Установка коннектора локально
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Открой http://localhost:3000/connectors/store, выбери MoySklad и вставь переменные окружения, указанные в предварительных условиях.
Доступные инструменты
| Инструмент | Что он делает |
|---|---|
moysklad_get_employee_context | Читает информацию о сотруднике, к которому принадлежит токен: имя, email, аккаунт и права на каждую сущность. Используй его, чтобы проверить токен и что он может… |
moysklad_list_assortment | Перечисляет все, что можно продать в одном списке: продукты, варианты (модификации), услуги, комплекты и партии, каждый с id, meta… |
moysklad_list_products | Перечисляет продукты: id, название, код, артикул, описание, productFolder, uom, salePrices, buyPrice и minPrice в копейках, штрих-коды, НДС… |
moysklad_get_product | Читает один продукт с его ценами в копейках, штрих-кодами, единицами, папкой, поставщиком, пользовательскими полями (атрибутами) и настройками отслеживания. Только для чтения |
moysklad_create_product | Создает продукт с названием и, опционально, кодом, артикулом, описанием, НДС, весом и ценой покупки. Возвращает продукт с его id и… |
moysklad_update_product | Обновляет продукт: изменяются только указанные поля. Возвращает обновленный продукт. MoySklad блокирует пользователя, который отправляет более 100 обновлений… |
moysklad_list_product_folders | Перечисляет группы продуктов (папки): id, название, pathName (путь родительских групп), код, описание и архивирован. Возвращает meta (размер, лимит… |
moysklad_get_stock_report | Расширенный отчет по остаткам по каждому товару во всех магазинах: название, код, артикул, остаток, резерв, в пути и количество (доступно), цена (себестоимость) и… |
moysklad_get_stock_by_store | Отчет по остаткам по каждому товару и магазину: каждая строка имеет мета-данные товара и stockByStore с названием, остатком, резервом и в пути по магазину. Каждый вызов… |
moysklad_get_current_stock | Короткий отчет по остаткам для частых проверок: только assortmentId (и storeId с областью bystore) с одним числом, в одном ответе без… |
moysklad_list_counterparties | Перечисляет контрагентов (клиентов и поставщиков): id, название, код, companyType, inn, kpp, legalTitle, телефон, email, фактический адрес, теги… |
moysklad_get_counterparty | Читает одного контрагента с юридическими данными (inn, kpp, legalAddress), контактами, банковскими счетами, тегами, скидками, типом цены и пользовательскими полями.… |
moysklad_create_counterparty | Создает контрагента (клиента или поставщика) с названием и, опционально, типом, налоговыми номерами, адресами, телефоном, email и тегами. Возвращает… |
moysklad_update_counterparty | Обновляет контрагента: изменяются только указанные поля; данный список тегов заменяет старый. Возвращает обновленного контрагента |
moysklad_list_customer_orders | Перечисляет заказы клиентов: id, название (номер заказа), момент, сумма, payedSum, shippedSum, invoicedSum и reservedSum в копейках, применимые… |
moysklad_get_customer_order | Читает один заказ клиента: номер, момент, суммы в копейках, контрагент (агент), организация, магазин, состояние, адрес отгрузки, комментарий и… |
moysklad_get_customer_order_metadata | Читает метаданные заказов клиентов: состояния (статусы) с id, названием, stateType и meta, а также пользовательские поля (атрибуты). Эти… |
moysklad_create_customer_order | Создает заказ клиента для организации (твоей юридической сущности) и контрагента, с позициями заказа. Возвращает заказ с его id, номером… |
moysklad_update_customer_order | Обновляет заказ клиента: комментарий, планируемая дата отгрузки, статус, магазин или флаг черновика. Изменяются только указанные поля. Чтобы изменить заказ… |
moysklad_list_demands | Перечисляет требования (отгрузки клиентам): id, название, момент, сумма и payedSum в копейках, агент, организация, магазин, состояние, заказ клиента… |
moysklad_get_demand | Читает одно требование (отгрузку): номер, момент, сумма в копейках, контрагент, магазин, данные о грузополучателе и перевозчике и связанный клиент… |
moysklad_list_supplies | Перечисляет поставки (товары, полученные от поставщиков): id, название, момент, сумма и payedSum в копейках, агент (поставщик), организация, магазин… |
moysklad_get_supply | Читает одну поставку (прием товара): номер, момент, сумма в копейках, поставщик, магазин, номер входящего документа и накладные расходы. Добавь… |
moysklad_list_invoices_out | Перечисляет счета, выставленные клиентам: id, название, момент, сумма, payedSum и shippedSum в копейках, агент, организация, paymentPlannedMoment и… |
moysklad_get_invoice_out | Читает один счет, выставленный клиенту: номер, момент, сумма и payedSum в копейках, контрагент, организация с ее банковским счетом и… |
moysklad_list_stores | Перечисляет магазины (склады): id, название, код, адрес, pathName для вложенных магазинов, архивирован и meta. Meta — это то, что заказы и отчеты… |
moysklad_list_organizations | Перечисляет твои организации (юридические лица): id, название, legalTitle, inn, kpp, legalAddress, companyType и meta. Заказ всегда требует одну.… |
moysklad_get_profit_by_product | Отчет о прибыли по продукту, услуге и комплекту за период: sellQuantity, sellPrice, sellCost, sellSum, sellCostSum, returnQuantity… |
moysklad_get_profit_by_counterparty | Отчет о прибыли по клиенту за период: demandsCount, demandsSum, averageReceipt, returnsCount, returnsSum, discountsSum, balance… |
moysklad_get_turnover | Отчет об обороте по товару за период: остаток на начало (onPeriodStart), доход, расход и остаток на конец (onPeriodEnd), каждый с… |
moysklad_get_dashboard | Ключевые показатели за сегодня, последнюю неделю или последний месяц: продажи (количество, сумма, движение), заказы (количество, сумма, движение) и… |
Примеры запросов
- "Каков текущий остаток всех продуктов на основном складе?"
- "Какие заказы клиентов с этой недели еще не отгружены?"
- "Покажи прибыль по продукту за октябрь."
- "Создай заказ клиента для ООО Ромашка: 10 штук продукта Чайник 1,7 л."
- "Какие контрагенты купили больше всего в прошлом квартале?"
Следующие шаги
Это руководство помогло?