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

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

Cin7 Core + Gemini

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

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

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

• "Сколько единиц 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. Учетные данные одного продукта не работают на другом.

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

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

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