Подключить Jisr MCP к ChatGPT

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

Jisr + ChatGPT

Спрашивайте о вашей HR-организации в Jisr из любого ИИ-ассистента: сотрудники и их должностные данные, сводки посещаемости и отметки прихода и ухода, остатки ежегодного отпуска, отделы и локации. По умолчанию только чтение; отправка отметок доступна, но отключена.

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

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

JISR_SLUG, JISR_API_KEY, JISR_API_SECRET

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

Настройка занимает около 5 минут. Нужны пользователь Jisr с ролью Admin, потому что только Admin может создавать API-ключи, и slug вашей организации, то есть поддомен вашего адреса Jisr.

1. В Jisr откройте Settings → Webhook & API Keys → API Keys и нажмите Add new API key (справочная статья Jisr).
2. Назовите ключ и отметьте API, которые он может использовать: Get List Employees, Get Employee Basic Information, Get attendance summary, View attendance records, View summary of employee annual leave и нужные справочники (lookups). Отмечайте Get Employee Financial Info, только если ИИ может видеть зарплаты.
3. Нажмите Generate и скопируйте API key в JISR_API_KEY, а secret — в JISR_API_SECRET. Jisr показывает secret только один раз: если он потерян, создайте новый ключ.
4. Укажите в JISR_SLUG slug вашей организации: поддомен вашего адреса Jisr строчными буквами, acme для acme.jisr.net, а не полный адрес.
5. Установите коннектор. Проверьте подключение через jisr_list_employees.

Cloud и self-hosting работают одинаково: не нужно регистрировать приложение или указывать Redirect URL; коннектору нужны только slug, API key и secret.

Коннектор входит сам: он вызывает POST /openapi/v1/auth со slug, API key и secret, получает access token и при каждом вызове передаёт его в заголовке Access-Token вместе с slug и api-version. Ключ и secret отправляются только в этот вызов входа. Если Jisr отклоняет токен, коннектор входит заново, так что обновлять ничего не нужно.

Организации, размещённые в Саудовской Аравии: если ваш адрес Jisr заканчивается на .jisr.net.sa, ваша организация использует https://api.jisr.net.sa/api вместо https://apis.jisr.net/api. Измените base URL и login URL коннектора на этот хост (login URL https://api.jisr.net.sa/api/openapi/v1/auth).

Данные сотрудников — персональные данные: записи содержат дату рождения, личные контакты, номера документов и паспортов. Отмечайте в ключе только нужные API и передавайте только необходимое. Банковские реквизиты (IBAN) удаляются из списков сотрудников в любом случае; зарплаты скрыты, пока не отмечено Get Employee Financial Info; пользовательские поля возвращаются, только если у ключа есть это разрешение.

Два идентификатора сотрудника: у каждого сотрудника есть публичный id (UUID вида bab6cd98-7246-4cfc-a576-19bc00391792), который используют jisr_get_employee и фильтр сводки посещаемости, и числовой employee code (например, 43), который используют отметки и остатки отпуска.

Даты и страницы: даты в формате YYYY-MM-DD; время отметок — дата и время, например 2026-11-01T08:00:00. Без периода сводка посещаемости охватывает текущий месяц, а список отметок — последний час. Списки возвращают до 100 записей на страницу (page с 1, rpp или limit); ИИ читает дальше, пока в data.pagination есть next_page.

Частые ошибки: This call requires login — токен истёк, коннектор входит заново. Organization not found with given subdomain — неверный JISR_SLUG. Если вход отклонён, неверны slug, API key или secret: скопируйте их заново или создайте новый ключ, если secret потерян. 403 — у API-ключа нет разрешения на этот API: отредактируйте ключ в Settings → Webhook & API Keys и отметьте нужный API.

Не входит: создание сотрудников, транзакции по зарплате и начислениям, журналы, вебхуки и события аудита.

Что читает коннектор: сотрудников с публичным id и employee code, именем на английском и арабском, рабочей и личной почтой, телефоном, статусом, должностью, отделом, локацией, бизнес-подразделением, типом занятости, гражданством, руководителем, датой приёма, датой рождения, номерами документов и паспорта, датами увольнения и удаления, с фильтрами по статусу и по дате создания, приёма, увольнения или удаления; полный базовый профиль сотрудника с личными данными, адресом и контактами; итоги посещаемости по сотрудникам за период: отработанные часы, опоздания и ранние уходы, дополнительное время, одобренные переработки, отсутствия, дни без отметок, дни отпуска и выходные, оправдания на весь день и дни командировок; отдельные отметки со временем, серийным номером устройства и, для отклонённых, ошибкой Jisr; остатки ежегодного отпуска с начальным остатком и остатком прошлого года, ручными корректировками, использованными, ожидающими и зарезервированными днями, вычетом за неоплачиваемый отпуск и остатком на конец года; справочники отделов, локаций, типов занятости, бизнес-подразделений, гражданств и аутсорсинговых компаний с названиями на английском и арабском.

Отключено при установке: jisr_create_attendance_logs. Он отправляет в Jisr до 100 отметок, как это делает терминал учёта времени или система контроля доступа; Jisr обрабатывает их в фоне, и они меняют данные о посещаемости сотрудников. Результат проверяйте потом через jisr_list_attendance_logs (статус success или failed). Включайте его на странице коннектора, только если он нужен; перед каждым изменением ИИ спрашивает ваше подтверждение. Все остальные инструменты только читают.

Шаг 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: Jisr.
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. Установи новый плагин из своих личных плагинов, затем введи @ в чате и выбери его.

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

Примеры запросов

• «Кто пришёл в компанию за последние 30 дней, в какой отдел и в какую локацию?»
• «Покажите сводку посещаемости за этот месяц: у кого больше всего опозданий и дней отсутствия?»
• «Какие отметки Jisr отклонил вчера и с какой ошибкой каждую?»
• «Сколько дней ежегодного отпуска осталось у сотрудников с кодами 43 и 77?»
• «Перечислите сотрудников, уволившихся в этом году, с должностью и датой увольнения.»

FAQ

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

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

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