インストール不要。2分以内に動きます。
cloud.anythingmcp.com で無料トライアルを開始し、Rippling をワンクリックで追加して、AI クライアント(Claude、ChatGPT、Copilot、Cursor)を生成された MCP エンドポイントに向けるだけ。Docker も git clone も、開発経験も不要です。
AnythingMCP は Claude のコネクタディレクトリに掲載されています。ワンクリックで Claude に追加 (新しいタブで開きます)し、サインインして Claude が使える MCP サーバーを選んでください。
概要
HR プラットフォーム Rippling を REST API で:ワーカーとユーザー、部署、チーム、勤務地、レベル、役職、雇用形態、カスタムフィールド、報酬、休暇の種類、残高、申請、スーパーグループ、勤怠記録。休暇の申請と承認、勤務時間の記録、組織構造の管理、採用ドラフト(draft hire)の作成も行えます。
こう聞いてみよう
Rippling のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Rippling をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も
git cloneもローカルサーバーも不要。
Rippling + Claude
HR プラットフォーム Rippling を REST API で:ワーカーとユーザー、部署、チーム、勤務地、レベル、役職、雇用形態、カスタムフィールド、報酬、休暇の種類、残高、申請、スーパーグループ、勤怠記録。休暇の申請と承認、勤務時間の記録、組織構造の管理、採用ドラフト(draft hire)の作成も行えます。
前提条件
完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:
RIPPLING_API_TOKEN
ステップ 1 — 認証情報を取得
設定は約 5 分です。Create and manage API Tokens の権限を持ち、AI に読ませたいデータにアクセスできる Rippling ユーザーが必要です。
- Rippling で Developer > API credentials(
https://app.rippling.com/api-tokens/tokens)を開き、New API token をクリックします。 - トークンに名前を付け、スコープを選びます。トークンが届くのは、スコープとオーナーの権限プロファイルの両方が許すデータだけです。使うものを選んでください:
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は AI に給与を見せる場合だけ。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。
- トークンは一度しか表示されないので、すぐに
BearerなしでRIPPLING_API_TOKENにコピーします。コネクタをインストールすると、rippling_list_companiesでインストールが確認されます。
リクエストはトークンのオーナーとして実行されます。Rippling は 30 日間使われなかったトークンと、退職したオーナーのトークンを失効させるため、アクセスが安定しているオーナーを選んでください。
個人データ: ワーカー、ユーザー、報酬パッケージには個人データと給与データ(氏名、個人メールアドレス、電話番号、自宅住所、生年月日、性別、給与)が含まれます。タスクに必要な項目だけを求め、理由なく他のシステムにコピーせず、トークンにはチームが使うスコープだけを与えてください。
読み取る内容: 会社(rippling_list_companies)。ワーカー、つまり従業員と業務委託者の雇用レコードで、ステータス、業務用と個人のメール、入社日と退職日、役職、部署、マネージャー、レベル、チーム、勤務地、雇用形態、国を含みます(rippling_list_workers、rippling_get_worker)。ユーザー、つまりワーカーの user_id の背後にあるログイン ID(rippling_list_users、rippling_get_user)。年額、月額、週額、時給の金額、ボーナス目標、コミッションを含む報酬パッケージ(rippling_list_compensations、ワーカーの compensation_id を使う rippling_get_compensation)。カスタムフィールドの定義(rippling_list_custom_fields)で、値はワーカーに expand=custom_fields を付けると返ります。部署、チーム、勤務地、レベル、役職、雇用形態、ジョブコードからなる組織構造。スーパーグループとそのメンバー。休暇の種類、時間と日数での休暇残高、休暇申請。ジョブシフト、休憩、時間、ステータス、給与期間を含む勤怠記録。expand(例: user,manager,department)を使うと関連オブジェクトを 1 回の呼び出しに埋め込めます。
書き込む内容:
- 休暇:
rippling_create_leave_requestはワーカーの休暇を申請します(PENDINGは通常の承認フローに乗り、APPROVEDは合意済みの休暇を記録します)。rippling_update_leave_requestはstatusで承認、却下、取り消しを行い、日付やコメントも変更できます。 - 勤務時間:
rippling_create_time_entryは開始と終了時刻付きのジョブシフト、または 1 日の時間として勤務時間を記録します。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は最大 5 件の採用ドラフトを作成します。誰かが採用される前に Rippling のレビューと承認を通ります。
インストール時はオフ: rippling_delete_team(ワーカーのチーム割り当てが外れます)と rippling_delete_time_entry。どちらも元に戻せないため、チームが必要とするときにワークスペース管理者がオンにします。
フィルター: filter は各ツールが挙げるフィールドに対する OData 風の式を受け取ります。例: status eq 'ACTIVE'、updated_at ge 2026-01-01T00:00:00、status in ('HIRED','ACCEPTED')。and と or で組み合わせられます。文字列はシングルクォートで囲み、1 つのフィルターは最大 64 ノードです。1 人のワーカーの残高は worker_id eq '...'、未処理の申請は status eq 'PENDING' です。
データ形式: ID は 24 文字の 16 進数文字列です。日付は YYYY-MM-DD、タイムスタンプはオフセット付きの ISO 8601 です。金額は { "currency_type": "USD", "value": 120000 } の形で、通貨の基本単位です。ワーカーの status は INIT、HIRED、ACCEPTED、ACTIVE、TERMINATED のいずれかです。トークンが見られないフィールドは null で返り、理由とともに __meta.redacted_fields に記載されます。そのため null は項目が空である証拠にはなりません。まずスコープとオーナーの権限を確認してください。
ページング: 一覧は results と next_link を返し、既定は 50 件、limit で最大 100 件です。next_link が null でない間、AI は next_link 内のカーソル値を cursor に設定して再度呼び出します。
制限とよくあるエラー: エンドポイントとトークンごとに 10 秒あたり 600 リクエストまでで、超えると 429 になります(数秒待って再試行)。400 は不正なフィルター、展開できないフィールド、または 100 を超える limit、401 は誤ったまたは失効したトークン、403 はスコープ不足またはオーナーにない権限、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 — Claude にコネクタを追加
サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL(
https://cloud.anythingmcp.com/mcp/…)をコピーします。このガイドでYOUR_SERVER_IDと表示されている箇所に使ってください。
推奨ルート:設定ファイルを触らずに claude.ai web で動作します。
- Claude で Customize → Connectors を開きます。
- + をクリックし、Add custom connector を選びます。
- 名前(例:
Rippling)とリモート MCP サーバー URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDを入力し、Add をクリックします。 - Connect をクリックし、AnythingMCP にサインイン(OAuth)してアクセスを許可します。
下記のすべてのツールがチャットに表示されます。プロンプトを入力し始めてください。
利用可能なツール
| Tool | What it does |
|---|---|
rippling_list_companies | List the Rippling company the token belongs to (name, legal name, primary email, address, legal entities when expanded) |
rippling_list_workers | List workers (employees and contractors): status, work and personal email, start and end date, title, department, manager, level, teams… |
rippling_get_worker | Read one worker by id with the same fields as rippling_list_workers; expand user, manager or custom_fields for more |
rippling_list_users | List users (the login identity behind a worker): name, display name, emails, phone numbers, addresses, time zone, locale and whether the… |
rippling_get_user | Read one user by id: name, emails, phone numbers, addresses, locale and time zone |
rippling_list_compensations | List compensation packages the token owner may see: annual, monthly, weekly and hourly amounts with currency, bonus targets, commission and… |
rippling_get_compensation | Read one compensation package by id (the compensation_id of a worker) |
rippling_list_custom_fields | List the company's custom fields on employees: id, name, description, data type (TEXT, DATE, NUMBER, SELECT and more), whether required… |
rippling_list_departments | List departments with name, reference code, parent department and the hierarchy of department ids from the top |
rippling_get_department | Read one department by id: name, reference code, parent and the chain of parent departments |
rippling_list_teams | List teams with their name and parent team, to resolve the teams_id values on workers |
rippling_get_team | Read one team by id: name and parent team (expand parent for its details) |
rippling_list_work_locations | List work locations (offices) with name and full address, to resolve a worker's location |
rippling_get_work_location | Read one work location by id (the location.work_location_id of a worker) |
rippling_list_levels | List job levels with name, parent level, track and rank, to resolve the level_id of workers |
rippling_get_level | Read one job level by id: name, parent level and track (expand track for its name) |
rippling_list_titles | List the job titles defined in the company, with id and name, for consistent title values |
rippling_list_employment_types | List employment types: label, CONTRACTOR or EMPLOYEE, HOURLY or SALARIED, FULL-TIME, PART-TIME or TEMPORARY |
rippling_list_job_codes | List job codes (the codes workers log time against) with their job dimension, department and work location |
rippling_list_supergroups | List supergroups: the attribute-based groups Rippling uses for policies, apps and workflows (name, type, description, whether terminated… |
rippling_get_supergroup | Read one supergroup by id: name, type, description and membership settings |
rippling_list_supergroup_members | List the members of a supergroup: worker id, full name and work email |
rippling_list_leave_types | List leave types (vacation, sick and others): name, type, description, whether paid and whether managed by an external system |
rippling_list_leave_balances | List leave balances per worker and leave type: whether unlimited, balance with and without future requests, in hours and in days |
rippling_get_leave_balance | Read one leave balance by id: worker, leave type and remaining balance in hours and days |
rippling_list_leave_requests | List leave requests with worker, requester, reviewer, status (PENDING, APPROVED, REJECTED, CANCELED), dates, hours, leave type and comments |
rippling_get_leave_request | Read one leave request by id: worker, status, dates, hours, leave type, reviewer and comments |
rippling_list_time_entries | List time entries (worked shifts with job shifts, breaks, duration, status DRAFT, APPROVED, PAID or FINALIZED, pay period and tags) |
rippling_get_time_entry | Read one time entry by id: job shifts, breaks, duration, status, pay period and comments |
rippling_create_department | Create a department, optionally under a parent department and with a reference code |
rippling_update_department | Change a department's name, parent or reference code |
rippling_create_team | Create a team, optionally nested under a parent team; assign workers to it in Rippling |
rippling_update_team | Rename a team or move it under another parent team |
rippling_delete_team | Delete a team; workers lose the team assignment |
rippling_create_work_location | Create a work location (office) with its name and postal address, for assigning workers |
rippling_update_work_location | Rename a work location or change its address |
rippling_create_leave_request | File a leave request for a worker |
rippling_update_leave_request | Approve, reject or cancel a leave request (status), or change its dates and comments |
rippling_create_time_entry | Record worked time for a worker, as job shifts with start and end times or as a duration on a day |
rippling_update_time_entry | Change a time entry: shifts, breaks, duration, comments, tags or status. worker_id is required by the API even when unchanged |
rippling_delete_time_entry | Delete a time entry permanently, e.g. a duplicate |
rippling_create_draft_hires | Create draft hires that then follow Rippling's review and approval policies before anyone is hired |
プロンプトの例
- 「過去 30 日間に入社したのは誰ですか? 氏名、役職、部署、マネージャー、入社日を一覧にしてください。」
- 「承認待ちの休暇申請を、ワーカー、期間、時間数、休暇の種類付きですべて見せてください。」
- 「Maria Lopez の有給休暇はあと何日、何時間残っていますか?」
- 「Maria Lopez の 11 月 10 日から 14 日までの承認待ちの休暇申請を承認してください。」
- 「部署と勤務地ごとに、アクティブなワーカーは何人いますか?」
FAQ
Claude Code は Claude Desktop と同じように動作しますか? はい。両方を https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID に向けてください。
次のステップ
このガイドは役に立ちましたか?