Cin7 Core MCP для ChatGPT: подключение

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

Cin7 Core + ChatGPT

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

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

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

CIN7_CORE_ACCOUNT_ID, CIN7_CORE_APPLICATION_KEY

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

Настройка занимает около 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 означает неправильный Идентификатор аккаунта или Ключ приложения.

Шаг 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 — Добавь коннектор в ChatGPT

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

ChatGPT добавляет MCP-серверы как плагины на странице Plugins, в веб-версии и в платных планах. Режим разработчика для этого больше не нужен. В рабочем пространстве Business это могут только администраторы и владельцы; в Enterprise и Edu администратор может выдать право Create plugins with MCPs.

1. Перейди на chatgpt.com/plugins, нажми Add, затем Add custom MCP server.
2. Введи название, например Name: Cin7 Core.
3. В разделе Connection укажи в поле Server URL адрес https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID и оставь Authentication на OAuth.
4. Выбери I understand and want to continue, затем Create as a plugin. Когда ChatGPT попросит, войди в AnythingMCP и разреши доступ.
5. Установи новый плагин из своих личных плагинов, затем введи @ в чате и выбери его.

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

Примеры подсказок

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

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

Я использую Cin7 Omni (go.cin7.com). Это правильный коннектор? Нет. Cin7 Omni имеет отдельный API v1 с именем пользователя и ключом API: используй коннектор Cin7 Omni. Учетные данные одного продукта не работают на другом.

Работает ли бесплатный план ChatGPT со своими MCP-серверами? OpenAI описывает свои MCP-серверы только для платных планов; план Free в этом списке не указан.

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

• Страница коннектора
• Подключение к Claude