API и MCP — подключить учётные системы и ИИ-ассистентов

Раздел API и MCP открывает данные jeCheck другим системам и ИИ-ассистентам: учётная система может забирать проверки и ставить задачи, BI — строить отчёты, а Claude или ChatGPT — отвечать на вопросы о вашей сети и готовить разборы. Всё работает по тем же правам, что и кабинет: ключ или ассистент видит только то, что разрешено.

Раздел открывается из меню Управление → API и MCP или из меню профиля (нажмите на своё имя внизу бокового меню). API и MCP доступны на тарифе Enterprise.

Техническая документация для программистов (на английском) — на портале jecheck.io/developers: все методы, примеры запросов и ответов, ошибки.

Что можно подключить

• Учётные и кадровые системы — выгружать проверки, табель, зарплату, синхронизировать сотрудников и точки, создавать задачи.
• BI (Power BI, Looker, Metabase) — забирать аудиты, нарушения, выполнение регламентов и ХАССП для своих отчётов.
• Ботов и порталы — показывать инструкции, принимать заявки, напоминать о задачах.
• ИИ-ассистентов (Claude, ChatGPT, Cursor и другие) — через MCP ассистент сам находит нужные данные и может ставить задачи от вашего имени.

Ключи компании

Ключ компании нужен для интеграций, которые работают сами, без конкретного человека. Выдаёт сотрудник с правом Ключи API компании (у администратора оно есть).

1. Откройте API и MCP → Ключи компании и нажмите Новый ключ.
2. Назовите ключ по системе, которая будет им пользоваться, например «1С» или «Power BI».
3. Выберите Доступ: Только чтение или Чтение и запись.
4. Отметьте Роли ключа — ключ получит ровно права этих ролей. Выдать можно только роли, все права которых есть у вас самого.
5. Выберите Точки — ключ увидит данные только этих точек (или всех, включая новые).
6. При необходимости укажите срок действия и нажмите Создать.
7. Скопируйте токен — он показывается один раз. Передайте его разработчику интеграции защищённым способом.

Ключ работает от служебного пользователя «API: название». Он не может войти в кабинет или приложение, а всё, что интеграция создаёт или меняет, видно в истории под этим именем.

Полный доступ (как у администратора) может выдать только администратор. Используйте его, только если интеграции действительно нужны все разделы.

Ключ можно Изменить — поменять название, роли, точки и доступ без замены токена — или Отозвать: интеграция перестанет работать сразу.

Личные токены

Личный токен работает с вашими правами и подходит для скриптов, проверки API и ИИ-инструментов разработчика (Cursor, Claude Code, VS Code). Создать его можно на вкладке Мои токены, если у вас есть право Личные токены API и ИИ-приложения. Не передавайте личный токен другим людям.

Подключение ИИ-ассистента (MCP)

MCP — открытый протокол, по которому ИИ-ассистенты подключаются к сервисам. На вкладке ИИ-приложения (MCP) показан адрес сервера и пошаговые инструкции.

Claude и ChatGPT подключаются без токена:

1. Скопируйте Адрес сервера.
2. В Claude: Настройки → Коннекторы → Добавить свой коннектор. В ChatGPT: Настройки → Приложения и коннекторы → Создать.
3. Вставьте адрес, нажмите Подключить, войдите в jeCheck и разрешите доступ. Галочку Разрешить изменения можно снять — тогда ассистент будет только читать.

Cursor, VS Code, Claude Code подключаются с личным токеном — готовые настройки для копирования есть на той же вкладке.

Примеры вопросов ассистенту:

• «Какие пять точек хуже всего прошли аудит кухни в этом месяце и какие нарушения повторяются?»
• «Какие задачи просрочены на точке Достык? Сгруппируй по ответственным.»
• «Есть ли сегодня пропуски в журналах температуры ХАССП?»
• «Кто сейчас на смене на центральной кухне?»

Подключённые приложения видны в списке Подключённые приложения; кнопка Отключить сразу закрывает им доступ.

Журнал вызовов

На вкладке Журнал вызовов — последние 100 запросов к API и MCP: время, ключ, операция, код ответа и IP. Администратор и сотрудники с правом «Ключи API компании» видят вызовы ключей компании, каждый сотрудник — вызовы своих токенов и приложений. Журнал хранится 30 дней. Выдача и отзыв ключей записываются в журнал доступа раздела «Права и роли».

Безопасность

• Делайте отдельный ключ для каждой системы с минимальными ролями и точками — его проще ограничить и отозвать.
• Если интеграции нужно только читать данные, выдавайте Только чтение.
• Для временных подключений указывайте срок действия.
• Отзывайте ключи, которыми больше не пользуются. Если токен мог попасть к посторонним, отзовите его немедленно и создайте новый.

Частые вопросы