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

> Ключи API компании, личные токены, подключение Claude, ChatGPT и Cursor к jeCheck через MCP, журнал вызовов и безопасность.

Источник: https://jecheck.io/docs/account/api-mcp

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

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

Техническая документация для программистов (на английском) — на портале [jecheck.io/developers](https://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 дней. Выдача и отзыв ключей записываются в журнал доступа раздела «Права и роли».

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

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

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

### Почему запросы возвращают ошибку plan_required?

API и MCP входят в тариф Enterprise. Ключи можно создать заранее, но запросы будут отклоняться, пока компания не перейдёт на Enterprise.

### Ключ не видит часть данных

Ключ видит только данные выбранных ролей и точек — так же, как сотрудник с такими правами в кабинете. Проверьте роли и точки ключа или права ролей в разделе «Права и роли».

### Работает ли старый ключ бота инструкций?

Да. Ключи, выданные раньше для бота базы знаний, продолжают работать с инструкциями. Для остальных разделов создайте новый ключ.