Cin7 Core MCP-сервер: запасы, продажи и закупки

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

Cin7 Core

Cin7 Core (ранее DEAR Inventory) через Внешний API v2: продукты и наличие на складе по местоположению, продажи с заказами, выполнениями, счетами и платежами (только для чтения), закупки, клиенты, поставщики, корректировки и перемещения запасов. Создавай продажи, закупки, клиентов, поставщиков и перемещения. Идентификатор аккаунта и ключ приложения.

Настройка

Настройка занимает около 2 минут. Тебе нужен аккаунт Cin7 Core (ранее DEAR Inventory; войди на inventory.dearsystems.com) с доступом к Integrations → API. Коннектору нужны Идентификатор аккаунта и ключ приложения.

Core или Omni? Cin7 продает два разных продукта. Cin7 Core (этот коннектор, ранее DEAR Systems) использует Идентификатор аккаунта и ключ приложения. Cin7 Omni (оригинальный Cin7, go.cin7.com) имеет отдельный API v1 с именем пользователя и ключом API: используй коннектор Cin7 Omni для этого. Учетные данные одного не работают на другом.

1. В Cin7 Core открой страницу настройки API, Integrations → API (inventory.dearsystems.com/ExternalAPI).
2. Нажми +, чтобы добавить API приложение, и дай ему имя.
3. Скопируй Идентификатор аккаунта (GUID) в CIN7_CORE_ACCOUNT_ID и Ключ приложения в CIN7_CORE_APPLICATION_KEY.
4. Установи коннектор. Запусти cin7_core_get_me, чтобы проверить соединение: он возвращает название компании, базовую валюту и часовой пояс аккаунта.

Облачный и саморазмещенный работают одинаково: учетные данные одинаковые, и нет URL для перенаправления. Коннектор отправляет их в заголовках api-auth-accountid и api-auth-applicationkey. Удаление API приложения в Cin7 Core аннулирует ключ.

С чего начать: cin7_core_get_me для базовой валюты, cin7_core_list_locations для названий местоположений, затем cin7_core_list_sales и cin7_core_get_product_availability, которые отвечают на большинство вопросов.

Что он читает: продукты с ценовыми категориями, наличие на складе по продукту и местоположению (в наличии, зарезервировано, доступно, в заказе); продажи с их предложением, заказом, выполнениями (сбор, упаковка и отправка, с перевозчиком и номером отслеживания), счетами и платежами; закупки с их заказом; клиенты, поставщики, налоговые правила и условия оплаты; корректировки запасов и перемещения запасов.

Создание продажи требует двух вызовов: cin7_core_create_sale создает заголовок (клиент, местоположение) и возвращает его ID, затем cin7_core_create_sale_order добавляет строки. Строки требуют Название, Количество, Цена, Налог и Налоговое правило плюс SKU или ProductID. ИИ сохраняет заказ в статусе DRAFT, если ты не хочешь его авторизовать: AUTHORISED резервирует запасы, оформляет недостачу без предупреждения и блокирует заказ от дальнейших редактирований через API. Закупки работают аналогично, с cin7_core_create_purchase и cin7_core_create_purchase_order.

Другие записи: cin7_core_create_customer, cin7_core_update_customer и cin7_core_create_supplier (им нужны названия условий оплаты и налоговых правил и коды счетов, которые перечисляют cin7_core_list_payment_terms и cin7_core_list_tax_rules), и cin7_core_create_stock_transfer (по умолчанию DRAFT). Все эти функции включены.

Выключено при установке: cin7_core_create_stock_adjustment (создание корректировки запасов). Завершенная корректировка одновременно фиксирует движения запасов и бухгалтерские записи, а ее количества являются новыми значениями на складе, а не разницей. Включи это на странице коннектора, если ИИ должен его использовать; ИИ попросит тебя подтвердить каждое изменение.

Без денег и без удаления: коннектор никогда не записывает, не изменяет и не удаляет платежи, счета или кредитные ноты, и у него нет инструментов для удаления или аннулирования.

Идентификаторы: записи используют GUID (ID, SaleID, TaskID). Местоположения, налоговые правила, условия оплаты и ценовые категории ссылаются по имени.

Пагинация: списки принимают page (с 1) и limit (по умолчанию 100, максимум 1,000); ответ содержит Total. updated_since или modified_since возвращают только то, что изменилось. Даты в UTC, yyyy-MM-ddTHH:mm:ss.

Лимит вызовов: 60 вызовов в минуту на приложение API; за пределами этого Cin7 Core отвечает 429 (старые аккаунты 503). Большие страницы и фильтры используют бюджет лучше, чем много маленьких вызовов.

Распространенные ошибки: отказанный вызов отвечает 400 с [{"ErrorCode": 400, "Exception": "..."}], указывая на проблему, такую как неизвестный клиент, местоположение или налоговое правило, или документ, который уже авторизован. 403 означает неправильный Идентификатор аккаунта или Ключ приложения.

Предварительные условия: CIN7_CORE_ACCOUNT_ID, CIN7_CORE_APPLICATION_KEY

Установи коннектор локально

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, выбери Cin7 Core и вставь переменные окружения, указанные в предварительных условиях.

Доступные инструменты

Примеры запросов

• "Сколько единиц SKU MUG-WHT-350 доступно в каждом местоположении?"
• "Перечисли продажи этого месяца, которые авторизованы, но еще не полностью выполнены."
• "Покажи выполнение заказа SO-1042 с его перевозчиком и номером отслеживания."
• "Какие закупки все еще ждут поступления запасов?"
• "Создай черновик продажи для клиента Coffee Corner на Главном складе с 24 единицами MUG-WHT-350 по цене 6.50."

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

• Подключиться к Claude
• Подключиться к ChatGPT