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

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

Jisr + Microsoft Copilot

Спрашивайте о вашей 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 — Добавьте коннектор в Microsoft Copilot

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

Microsoft Copilot использует MCP-серверы через агентов, созданных в Copilot Studio: ты добавляешь AnythingMCP в агента как инструмент, а затем публикуешь агента в Microsoft 365 Copilot и Teams. Copilot Studio подключается из облака Microsoft по Streamable HTTP, который AnythingMCP поддерживает.

1. В Copilot Studio открой своего агента (или создай нового), перейди в Tools и выбери Add a tool → New tool → Model Context Protocol.
2. Укажи Server name (например, AnythingMCP), Server description, которое объясняет, что делает коннектор, и Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. По описанию Copilot Studio решает, когда вызывать сервер.
3. В аутентификации выбери API key, установи Type в Header, укажи имя заголовка X-API-Key и нажми Create.
4. В окне Add tool выбери Create a new connection, вставь MCP API-ключ из AnythingMCP (MCP Servers → твой сервер → API keys) и нажми Add to agent.
5. Проверь в панели Test агента: попроси о том, для чего нужны инструменты Jisr.
6. Нажми Publish, затем Channels → Microsoft 365 and Microsoft Teams, оставь включённым Make agent available in Microsoft Copilot и нажми Add channel. See agent in Teams установит агента для тебя; в Microsoft 365 Copilot введи @ и выбери агента.

Хочешь, чтобы каждый входил под своей учётной записью? Вместо API-ключа выбери OAuth 2.0 → Dynamic discovery: каждый пользователь войдёт в AnythingMCP при первом вызове агентом.

Размещаешь сам? Используй публичный HTTPS-адрес своего экземпляра вместо https://cloud.anythingmcp.com. Copilot Studio подключается из облака Microsoft, поэтому localhost не подойдёт.

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

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

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

FAQ

Для какого Copilot это руководство? Для Microsoft 365 Copilot на работе — через агентов Copilot Studio. В приложении Microsoft Copilot для личных аккаунтов добавить свой MCP-сервер нельзя.

Что нужно? Рабочий аккаунт с доступом к Copilot Studio (лицензия или пробная версия), чтобы создать агента. Тем, кто будет пользоваться им в Microsoft 365 Copilot или Teams, нужен доступ к агенту: поделись им или попроси администратора опубликовать его для организации. Если в организации действуют политики данных для коннекторов Power Platform, они распространяются и на MCP-серверы.

Агент не вызывает инструменты. Проверь, что имя заголовка — ровно X-API-Key, а ключ относится к тому же MCP-серверу, что и URL, и сделай Server description конкретным: по нему Copilot Studio решает, когда вызывать сервер. После каждого изменения опубликуй агента заново; в открытом чате введи «start over», чтобы перейти на новую версию.

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

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