Как подключить Rippling к ChatGPT через MCP

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

Rippling + ChatGPT

HR-платформа Rippling через её REST API: работники и пользователи, отделы, команды, рабочие места, уровни, должности, типы занятости и пользовательские поля, компенсации, типы, остатки и заявки на отсутствие, супергруппы и записи рабочего времени. Также оформляет и согласует отсутствия, записывает время, ведёт оргструктуру и создаёт черновики найма.

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

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

RIPPLING_API_TOKEN

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

Настройка занимает около 5 минут. Нужен пользователь Rippling с правом Create and manage API Tokens и доступом к данным, которые должен читать ИИ.

1. В Rippling откройте Developer > API credentials (https://app.rippling.com/api-tokens/tokens) и нажмите New API token.
2. Назовите токен и выберите его scopes. Токен видит только те данные, которые разрешают и его scopes, и профиль прав его владельца. Выберите то, что используете:
   • companies.read (обязательно, проверка установки), а также workers.read, users.read, departments.read, teams.read, work-locations.read, levels.read, titles.read, employment-types.read, job-codes.read, custom-fields.read, supergroups.read.
   • compensations.read только если ИИ должен видеть зарплаты.
   • leave-types.read, leave-balances.read, leave-requests.read и leave-requests.read-write, чтобы оформлять или согласовывать отсутствия.
   • time-entries.read и time-entries.read-write, чтобы записывать время (нужен Rippling Time).
   • departments.read-write, teams.read-write, work-locations.read-write и draft-hires.read-write для соответствующих записей.
3. Сразу скопируйте токен (он показывается только один раз) в RIPPLING_API_TOKEN без Bearer. Установите коннектор: rippling_list_companies служит проверкой установки.

Запросы выполняются от имени владельца токена. Rippling отзывает токен, который не использовался 30 дней, а также токены уволенного владельца, поэтому выберите владельца со стабильным доступом.

Персональные данные: работники, пользователи и пакеты компенсаций содержат личные и зарплатные данные: имена, личные адреса почты, телефоны, домашние адреса, дату рождения, пол и зарплату. Запрашивайте только поля, нужные для задачи, не копируйте их в другие системы без причины и давайте токену только те scopes, которые использует команда.

Что он читает: компанию (rippling_list_companies); работников, то есть записи о трудоустройстве сотрудников и подрядчиков, со статусом, рабочей и личной почтой, датами начала и окончания работы, должностью, отделом, руководителем, уровнем, командами, местом работы, типом занятости и страной (rippling_list_workers, rippling_get_worker); пользователей, то есть учётную запись для входа за user_id работника (rippling_list_users, rippling_get_user); пакеты компенсаций с годовыми, месячными, недельными и почасовыми суммами, целевыми бонусами и комиссиями (rippling_list_compensations и rippling_get_compensation по compensation_id работника); определения пользовательских полей (rippling_list_custom_fields), значения которых приходят с expand=custom_fields у работников; оргструктуру с отделами, командами, рабочими местами, уровнями, должностями, типами занятости и job codes; супергруппы и их участников; типы отсутствий, остатки в часах и днях и заявки на отсутствие; записи времени со сменами по работам, перерывами, длительностью, статусом и расчётным периодом. expand (например, user,manager,department) встраивает связанные объекты в один вызов.

Что он записывает:

• Отсутствия: rippling_create_leave_request оформляет отсутствие для работника (PENDING проходит обычное согласование, APPROVED фиксирует уже согласованное отсутствие); rippling_update_leave_request согласует, отклоняет или отменяет его через status либо меняет даты и комментарии.
• Время: rippling_create_time_entry записывает отработанное время как смены с началом и концом или как длительность за день; он принимает idempotency_key, чтобы повторная попытка не создала дубликат. rippling_update_time_entry изменяет запись; API требует worker_id, даже если он не меняется.
• Оргструктура: rippling_create_department, rippling_update_department, rippling_create_team, rippling_update_team, rippling_create_work_location и rippling_update_work_location. Обновления меняют только переданные поля.
• Найм: rippling_create_draft_hires создаёт до пяти черновиков найма, которые проходят проверку и согласование в Rippling, прежде чем кого-либо нанимают.

Отключены при установке: rippling_delete_team (работники теряют привязку к команде) и rippling_delete_time_entry. Ни одно из этих действий нельзя отменить; администратор workspace включает их, когда они нужны команде.

Фильтры: filter принимает выражение в стиле OData по полям, которые называет каждый инструмент, например status eq 'ACTIVE', updated_at ge 2026-01-01T00:00:00 или status in ('HIRED','ACCEPTED'), с объединением через and и or. Строки берутся в одинарные кавычки, в фильтре не более 64 узлов. Остатки одного работника: worker_id eq '...'; ожидающие заявки: status eq 'PENDING'.

Форматы данных: id это шестнадцатеричные строки из 24 символов. Даты в формате YYYY-MM-DD, метки времени ISO 8601 со смещением. Деньги имеют вид { "currency_type": "USD", "value": 120000 } в основных единицах валюты. status работника: INIT, HIRED, ACCEPTED, ACTIVE или TERMINATED. Поле, которое токену видеть нельзя, возвращается как null и указывается с причиной в __meta.redacted_fields, поэтому null не доказывает, что поле пустое: сначала проверьте scopes и права владельца.

Постраничный вывод: списки возвращают results и next_link, по умолчанию 50 записей, с limit до 100. Пока next_link не равен null, ИИ вызывает инструмент снова с cursor, равным значению курсора из next_link.

Лимиты и частые ошибки: 600 запросов за 10 секунд на endpoint и токен, затем 429 (подождите несколько секунд и повторите). 400 означает неверный фильтр, поле, которое нельзя развернуть, или limit больше 100; 401 неверный или отозванный токен; 403 недостающий scope или право, которого нет у владельца; 404 неизвестный id.

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

Шаг 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: Rippling.
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 дней? Выведи имя, должность, отдел, руководителя и дату начала работы.»
• «Покажи все ожидающие заявки на отсутствие с работником, датами, часами и типом отсутствия.»
• «Сколько отпуска осталось у Maria Lopez, в днях и в часах?»
• «Согласуй ожидающую заявку Maria Lopez на отпуск с 10 по 14 ноября.»
• «Сколько активных работников у нас в каждом отделе и на каждом рабочем месте?»

FAQ

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

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

• Страница коннектора
• Подключить к Claude
• Подключить к Cursor
• Подключить к Gemini
• Подключить к Meta Muse
• Подключить к Microsoft Copilot