МойСклад MCP

МойСклад MCP подключает AI-помощника Битрикс24 к вашему аккаунту МойСклад.

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

Приложение особенно полезно для быстрых ответов клиентам прямо из диалога: помощник помогает проверить наличие товара, уточнить цену, найти похожие позиции, посмотреть заказ и понять, оплачен он, отгружен или находится в резерве.

Также помощник может показать краткую сводку настроек аккаунта: организации, склады, типы цен и валюты, если эти данные доступны пользователю в МойСклад.

Текущая версия приложения позволяет только получать информацию из МойСклад и не создает заказы, не резервирует товары, не меняет цены, не обновляет контрагентов и не удаляет данные.

Для работы используется ключ доступа МойСклад, который пользователь указывает в настройках приложения. Ключ не передается третьим лицам и используется только для запросов к МойСклад.


Ключевые возможности:

1. Проверка подключения

Помощник может проверить, что доступ к МойСклад настроен корректно, и показать краткую информацию по первой доступной организации.

Пример:

• Проверь подключение к МойСклад
  

2. Сводка настроек аккаунта

Можно получить краткий список организаций, складов, типов цен и валют. Эти данные помогают понять, какие справочники доступны в аккаунте и какие значения можно использовать в рабочих сценариях.

Пример:

• Покажи настройки МойСклад: организации, склады и типы цен
  

3. Поиск товаров

Помощник может искать товары, модификации, комплекты и услуги по названию, артикулу, коду, штрихкоду или внешнему коду.

Примеры:

• Найди товар iPhone 17
  
• Найди товар по артикулу ABC-123
  

4. Карточка товара

Можно получить подробную карточку найденной позиции: название, тип, артикул, код, цены, единицу измерения, группу, архивность и ссылку на карточку в МойСклад, если она доступна.

Пример:

• Покажи карточку этого товара
  

5. Остатки и доступность

Помощник может проверить остатки товара, резерв, ожидаемое поступление и доступность по складам.

Примеры:

• Сколько осталось iPhone 17 на складах?
  
• Проверь наличие товара ABC-123
  

6. Цены

При поиске и просмотре карточки товара помощник показывает доступные цены из МойСклад в нормальном денежном формате.

Пример:

• Какая цена у товара iPhone 17?
  

7. Поиск контрагентов

Помощник может искать контрагентов по названию, ИНН, телефону, email или внешнему коду.

Примеры:

• Найди контрагента Ромашка
  
• Найди клиента по ИНН 7700000000
  

8. Карточка контрагента

Можно открыть карточку контрагента: основные реквизиты, контакты, адреса, архивность и ссылку на карточку в МойСклад, если она доступна.

Пример:

• Покажи карточку этого контрагента
  

9. Поиск заказов покупателей

Помощник может искать заказы покупателей по номеру, внешнему коду, имени контрагента, описанию или периоду.

Примеры:

• Найди заказ покупателя 00045
  
• Покажи заказы покупателя Ромашка за май
  

10. Статус заказа покупателя

Можно получить сводку по заказу: номер, дата, статус, сумма, оплачено, отгружено, зарезервировано, контрагент, организация, склад и позиции заказа.

Примеры:

• Какой статус у этого заказа?
  
• Покажи, что в заказе покупателя 00045
  

Что MCP-сервер не делает:

• Не создает заказы покупателей
  
• Не резервирует и не снимает резерв товаров
  
• Не меняет цены
  
• Не создает и не обновляет контрагентов
  
• Не изменяет карточки товаров, модификаций, услуг или комплектов
  
• Не проводит документы
  
• Не удаляет данные из МойСклад
  
• Не выполняет массовую синхронизацию данных с Битрикс24
  
• Не заменяет полноценную учетную систему и не выполняет операции, которые должны подтверждаться пользователем в МойСклад