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

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

Cin7 Omni + Gemini

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

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

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

CIN7_OMNI_API_USERNAME, CIN7_OMNI_API_KEY

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

Настройка занимает около 3 минут. Тебе нужна учетная запись Cin7 Omni (вход по адресу go.cin7.com) и администратор, который может добавить соединение API v1. Коннектору нужны имя пользователя API и ключ API.

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

1. В Cin7 Omni открой меню пользователя, затем Настройки → Интеграции и API → API v1.
2. Скопируй Имя пользователя API, показанное в верхней части страницы, в CIN7_OMNI_API_USERNAME.
3. Нажми Добавить новое API-соединение, дай ему имя и скопируй его ключ API в CIN7_OMNI_API_KEY. Сгенерировать ключ заменяет утерянный ключ.
4. В разделе Разрешения отметь "Чтение" для каждого ресурса, который AI должен видеть, и "Создание" или "Обновление" для ресурсов, которые нужны инструментам записи, затем нажми Сохранить. Ресурс без разрешения отвечает 403.
5. Установи коннектор. Выполни cin7_omni_list_branches, чтобы проверить соединение: он перечислит твои филиалы с их идентификаторами.

Облачный и самохостинг работают одинаково: учетные данные одинаковые, и нет URL для перенаправления, который нужно устанавливать. Коннектор отправляет имя пользователя и ключ в качестве HTTP Basic аутентификации.

С чего начать: cin7_omni_list_branches для идентификаторов филиалов, cin7_omni_list_sales_orders для последних заказов, cin7_omni_list_stock для запасов по филиалам и cin7_omni_list_contacts, чтобы найти клиента или поставщика.

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

Что он записывает: cin7_omni_create_sales_order, cin7_omni_update_sales_order (только заголовочные поля, такие как этап, код отслеживания и инструкции по доставке), cin7_omni_create_purchase_order, cin7_omni_create_contact, cin7_omni_update_contact и cin7_omni_create_branch_transfer включены. Новый заказ на продажу одобряется, если AI не создает его как черновик; заказы на покупку и переводы сохраняются как черновики, если не одобрены. Отгрузка и получение переводов происходят в Cin7.

Выключено при установке: cin7_omni_create_adjustment (создание корректировки запасов в одном филиале). Одобренная корректировка изменяет запасы на складе и стоимость запасов одновременно. Включи это на странице коннектора, если AI должен использовать его; AI попросит тебя подтвердить каждое изменение.

Проверяй ответ на каждую запись: Cin7 отвечает HTTP 200 со списком {index, success, id, code, errors}, даже когда он отказал в записи. AI проверяет success и errors, прежде чем сообщить, что запись завершена.

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

Фильтрация: where принимает условия в стиле SQL по полям записи, а не по строкам. Строки и даты заключаются в одинарные кавычки, числа остаются без кавычек: modifiedDate>='2026-01-01T00:00:00Z' AND branchId=3, reference LIKE 'SO-10%', id IN (21,24). Даты в UTC, yyyy-MM-ddTHH:mm:ssZ. fields сокращает ответ (id,reference,total,lineItems(code,qty)), что помогает с заказами, так как они большие.

Пагинация: page начинается с 1, а rows максимум 250 (по умолчанию 50, 25 для списков заказов). AI запрашивает следующую страницу, пока одна не вернется пустой.

Лимиты по частоте: Cin7 Omni позволяет 3 вызова в секунду, 60 в минуту и 5,000 в день на аккаунт; за пределами этого он отвечает 429 с Retry-After. Большие rows с узкими фильтрами where используют бюджет лучше, чем много маленьких вызовов.

Значения: статус заказа — DRAFT, APPROVED или VOID, а stage — это этап рабочего процесса в свободном тексте (Новый, Ожидает платежа, Обработка, На удержании, Отгружен). Запас available — это запасы на складе минус открытые продажи. Тип контакта — Клиент, Поставщик или Внутренний. Записи принимают суммы в валюте заказа; чтения возвращают значения в базовой валюте с курсом обмена. Новые пользователи могут появляться в cin7_omni_list_users до 2 часов.

Распространенные ошибки: 403 означает, что API-соединение не имеет разрешения на этот ресурс: отметь его в разделе Разрешения и сохрани. 429 — это лимит частоты: подожди время Retry-After.

Шаг 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 Omni.

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

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

• "Какие заказы на продажу были одобрены на этой неделе и еще не отгружены?"
• "Сколько запасов SKU TSHIRT-BLK-M доступно в каждом филиале?"
• "Какие заказы на покупку должны прибыть в этом месяце и от каких поставщиков?"
• "Найди клиента с email [email protected] и покажи его задолженность."
• "Создай черновик перевода 20 единиц TSHIRT-BLK-M из главного склада в городской магазин."

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

Я использую Cin7 Core (DEAR Inventory). Это правильный коннектор? Нет. Cin7 Core имеет свой собственный API и учетные данные: используй коннектор Cin7 Core. Учетные данные одного продукта не работают на другом.

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

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

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