Руководство по коннектору8 мин чтенияMCP-инструментов: 317 языков

Подключить MoySklad MCP к Gemini CLI

MoySklad (МойСклад) JSON API 1.2 для управления торговлей и складом: ассортимент и продукты, отчеты по остаткам, контрагенты, заказы клиентов, отгрузки, поставки, счета, магазины и отчеты о прибыли и обороте. Токен доступа.

HCАвтор: команда HelpCodeОбновлено 8 мин чтения Открытый код на GitHub

Без банковской карты · 7 дней пробного периода · Есть вариант self-host

MoySklad

MoySklad

MoySklad (МойСклад) JSON API 1.2 for trade and warehouse management: assortment and products, stock reports, counterparties, customer orders, shipments, supplies, invoices, stores and profit and turnover reports. Access token.

инструментов

31

Регион

INTL

Категория

ERP

Аутентификация

Bearer Token

Требуемые env-vars

MOYSKLAD_TOKEN
Установить в Cloud одним кликом

7 дней бесплатно · Без карты

  • 7 дней бесплатно
    Без банковской карты
  • GDPR и готовность к SOC 2
    Данные в ЕС, журналы аудита
  • Открытый код на GitHub
    Open source · AGPL-3.0
  • Работает с ChatGPT, Claude, Gemini
    Любой MCP-совместимый клиент

Кратко

MoySklad (МойСклад) JSON API 1.2 для управления торговлей и складом: ассортимент и продукты, отчеты по остаткам, контрагенты, заказы клиентов, отгрузки, поставки, счета, магазины и отчеты о прибыли и обороте. Токен доступа.

Пошаговая настройка

Подключи MoySklad к Gemini за 2 минуты

Начни бесплатный пробный период в AnythingMCP Cloud, подключи MoySklad в пошаговой настройке и добавь свой MCP URL в Gemini. Без кода и без собственного сервера.

Без банковской карты · 7 дней пробного периода · Есть вариант self-host

Попробуй спросить

Примеры промптов для MoySklad

Кликни по промпту — он скопируется. Вставь в Claude, ChatGPT, Cursor, Gemini, Copilot или OpenClaw и запусти через этот коннектор.

MoySklad · live via MCP
Поделиться
Opus 4.7

Claude — это AI, он может ошибаться. Проверяйте ответы.

💡 Нет установки? Используй cloud.anythingmcp.com напрямую. Войди в систему, нажми Connectors → MoySklad, вставь свои учетные данные, создай ключ API MCP, и все готово. Никакого Docker, никакого git clone, никакого локального сервера.

MoySklad + Gemini

MoySklad (МойСклад) JSON API 1.2 для управления торговлей и складом: ассортимент и продукты, отчеты по остаткам, контрагенты, заказы клиентов, отгрузки, поставки, счета, магазины и отчеты о прибыли и обороте. Токен доступа.

Предварительные требования

Смотри полные инструкции по настройке, встроенные в коннектор (видны в магазине приложения, когда ты выбираешь коннектор). Необходимые переменные окружения для этого коннектора:

MOYSKLAD_TOKEN

Шаг 1 — Получи учетные данные

Настройка занимает около 3 минут.

  1. В MoySklad открой настройки (Настройки) и раздел для токенов доступа (Токены), создай токен для пользователя, от имени которого должен действовать ИИ, и скопируй его. Он показывается только один раз.
  2. Вставь его в 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 одинаковых неудачных запросов в минуту), поэтому не повторяй ошибки в цикле. Удаление объектов и платежей не входит в этот коннектор.

Шаг 2 — Установи адаптер

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

Шаг 3 — Добавь коннектор в Gemini

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

Gemini CLI читает MCP-серверы из ~/.gemini/settings.json (в Windows — %USERPROFILE%\.gemini\settings.json). Добавь:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}
  1. Создай MCP API-ключ в AnythingMCP в разделе MCP Servers → твой сервер → API keys и вставь его вместо YOUR_MCP_API_KEY.
  2. Сохрани файл и перезапусти gemini.
  3. Выполни /mcp в Gemini CLI (или gemini mcp list в терминале) — anythingmcp должен отображаться как подключённый.
  4. Начинай писать промпты: Gemini CLI теперь может вызывать инструменты 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 л."
  • "Какие контрагенты купили больше всего в прошлом квартале?"

Часто задаваемые вопросы

Откуда берется токен? В MoySklad, настройки (Настройки), токены доступа (Токены): создай токен для пользователя, от имени которого должен действовать ИИ, и скопируй его, он показывается один раз. Токен имеет права этого пользователя, поэтому пользователь с правами только для чтения создает коннектор только для чтения.

Что он охватывает? Ассортимент и продукты с папками, отчеты по остаткам в целом, по магазину и быстрый текущий остаток, контрагенты, заказы клиентов с их статусами, отгрузки (требования), поставки, исходящие счета, магазины, организации и отчеты о прибыли, обороте и панели управления. Суммы указаны в копейках, а даты — по московскому времени. Удаление объектов и платежей не входит в коннектор.

Какие инструменты записывают, и что отключено? Продукты, контрагенты и заказы клиентов могут быть созданы и обновлены. Ничего не отключено; ИИ показывает каждую запись и ждет твоего подтверждения.

Где Gemini CLI ищет MCP-серверы? В ~/.gemini/settings.json для твоего пользователя или в .gemini/settings.json внутри проекта. gemini mcp list показывает каждый сервер и статус подключения.

Следующие шаги

Это руководство помогло?

Подключи MoySklad к Gemini за 2 минуты

Начни бесплатный пробный период в AnythingMCP Cloud, подключи MoySklad в пошаговой настройке и добавь свой MCP URL в Gemini. Без кода и без собственного сервера.

Похожие руководства

Коннекторы

Подключить MoySklad MCP к ChatGPT

MoySklad (МойСклад) JSON API 1.2 для управления торговлей и складом: ассортимент и продукты, отчеты по остаткам, контрагенты, заказы клиентов, отгрузки, поставки, счета, магазины и отчеты о прибыли и обороте. Токен доступа.

Коннекторы

Подключить MoySklad MCP к Claude

MoySklad (МойСклад) JSON API 1.2 для управления торговлей и складом: ассортимент и продукты, отчеты по остаткам, контрагенты, заказы клиентов, отгрузки, поставки, счета, магазины и отчеты о прибыли и обороте. Токен доступа.

Коннекторы

Подключить MoySklad MCP к Microsoft Copilot

MoySklad (МойСклад) JSON API 1.2 для управления торговлей и складом: ассортимент и продукты, отчеты по остаткам, контрагенты, заказы клиентов, отгрузки, поставки, счета, магазины и отчеты о прибыли и обороте. Токен доступа.

Коннекторы

Подключить MoySklad MCP к Cursor

MoySklad (МойСклад) JSON API 1.2 для управления торговлей и складом: ассортимент и продукты, отчеты по остаткам, контрагенты, заказы клиентов, отгрузки, поставки, счета, магазины и отчеты о прибыли и обороте. Токен доступа.

Коннекторы

Подключить MoySklad MCP к Meta Muse

MoySklad (МойСклад) JSON API 1.2 для управления торговлей и складом: ассортимент и продукты, отчеты по остаткам, контрагенты, заказы клиентов, отгрузки, поставки, счета, магазины и отчеты о прибыли и обороте. Токен доступа.

Коннекторы

MoySklad MCP-сервер: остатки, заказы и отчеты

MoySklad (МойСклад) JSON API 1.2 для управления торговлей и складом: ассортимент и продукты, отчеты по остаткам, контрагенты, заказы клиентов, отгрузки, поставки, счета, магазины и отчеты о прибыли и обороте. Токен доступа.