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

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

Jisr + Gemini

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

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

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

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

FAQ

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

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

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