Ashby Automation
Claude Code から直接 Ashby ATS の採用業務を自動化します。候補者の作成、求人の公開、応募の管理、面接スケジュールの表示、人材パイプラインの検索などを、ターミナルから離れずに行えます。
ツールキットドキュメント: composio.dev/toolkits/ashby
セットアップ
- Claude Code の設定に Rube MCP サーバーを追加します（URL:
https://rube.app/mcp） - プロンプトに従い、表示された接続リンクから Ashby アカウントを認証します
- 自然言語で採用ワークフローの自動化を開始します
コアワークフロー
1. 候補者の管理
候補者の作成、一覧表示、検索、更新、詳細情報の取得が可能です。
ツール: ASHBY_CREATE_CANDIDATE、ASHBY_LIST_CANDIDATES、ASHBY_SEARCH_CANDIDATES、ASHBY_GET_CANDIDATE_INFO、ASHBY_UPDATE_CANDIDATE
「Jane Smith」という候補者を作成します。メールは [email protected]、LinkedIn プロフィールは https://linkedin.com/in/janesmith です。
ASHBY_CREATE_CANDIDATE の主なパラメータ:
name（必須）-- 候補者のフルネームemail-- プライマリメールアドレスphoneNumber、linkedInUrl、githubUrl、websiteUrl-- 連絡先／ソーシャルプロフィール
ASHBY_SEARCH_CANDIDATES の主なパラメータ:
email-- 完全一致のメールアドレスname-- 部分一致の氏名
ASHBY_LIST_CANDIDATES の主なパラメータ:
perPage（最大 100）/cursor-- ページネーションsyncToken-- 前回の同期以降の増分更新用
2. 求人の作成と一覧表示
新しい求人を公開し、既存のポジションを閲覧します。
ツール: ASHBY_CREATE_JOB、ASHBY_LIST_JOBS、ASHBY_GET_JOB_INFO
チーム dept-123、拠点 loc-456、ブランド brand-789 で「シニアソフトウェアエンジニア」の求人を作成します。
ASHBY_CREATE_JOB の主なパラメータ:
title（必須）-- 職種名teamId（必須）-- 部署／チーム ID（部署一覧から取得）locationId（必須）-- 勤務地 ID（拠点一覧から取得）brandId（必須）-- 雇用主ブランド ID（ブランド一覧から取得）defaultInterviewPlanId-- 求人を応募受付可能にするために必要jobTemplateId-- テンプレートから事前入力する場合
ASHBY_LIST_JOBS の主なパラメータ:
perPage（最大 100）/cursor/syncToken-- ページネーションと増分同期
注意: 新しく作成された求人は「下書き」ステータスで始まります。求人を公開／応募受付可能にするには、defaultInterviewPlanId を設定する必要があります。
3. 応募の管理
候補者を求人に応募させ、進捗を追跡します。
ツール: ASHBY_CREATE_APPLICATION、ASHBY_LIST_APPLICATIONS
候補者 cand-abc123 を求人 job-xyz789 に応募します。ソースは src-referral です。
ASHBY_CREATE_APPLICATION の主なパラメータ:
candidateId（必須）-- 既存候補者の UUIDjobId（必須）-- 既存求人の UUIDsourceId-- 応募ソースの UUID（LinkedIn、紹介など）creditedToUserId-- クレジットするリクルーター／紹介者の UUIDinterviewStageId-- 特定のステージに直接配置（デフォルトは最初のステージ）
ASHBY_LIST_APPLICATIONS の主なパラメータ:
perPage（最大 100）/cursor/syncToken-- ページネーションと増分同期
4. 面接スケジュールの表示
面接の日程、面接官、候補者の詳細を一覧表示します。
ツール: ASHBY_LIST_INTERVIEW_SCHEDULES
今後の面接スケジュールをすべて表示してください。
主なパラメータ:
perPage（最大 100）/cursor-- ページネーションsyncToken-- 変更されたスケジュールの増分同期
5. 候補者メモ
候補者に対する内部メモ、観察事項、リクルーターのコメントを表示します。
ツール: ASHBY_LIST_CANDIDATE_NOTES
候補者 cand-abc123 のメモをすべて表示してください。
- リクルーターや採用チームメンバーが追加したすべてのメモを取得します
- 面接フィードバックや内部評価の確認に便利です
6. パイプライン報告
一覧表示ツールを組み合わせて、採用パイプラインのレポートを作成します。
ツール: ASHBY_LIST_CANDIDATES、ASHBY_LIST_APPLICATIONS、ASHBY_LIST_JOBS
現在の採用パイプラインの状態を確認するため、すべての応募を一覧表示します。
syncTokenを使用して増分データ取得（定期レポートに効率的）- 候補者、応募、求人データを組み合わせてパイプライン全体を可視化
cursorで全結果をページネーションし、完全なデータセットを取得
既知の注意点
- 求人は下書きから開始:
ASHBY_CREATE_JOBで新しく作成された求人は「下書き」ステータスで始まり、defaultInterviewPlanIdが設定され求人が公開されるまで応募を受け付けられません。 - 求人には4つの必須フィールド:
ASHBY_CREATE_JOBにはtitle、teamId、locationId、brandIdが必要です。有効な ID を見つけるには、部署一覧、拠点一覧、ブランド一覧のエンドポイントを使用してください。 - 応募前に候補者を作成: 応募を作成する前に、候補者が存在している必要があります。常に最初に候補者を作成または検索し、その後に応募を作成してください。
- カーソルベースのページネーション: すべての一覧エンドポイントは、
perPage（最大 100）とcursorを使用したカーソルベースのページネーションを使用します。任意のページにジャンプすることはできず、順次繰り返し処理する必要があります。 - 効率的な
syncTokenの使用: 以前のレスポンスのsyncTokenを使用して、変更されたレコードのみを取得します。これにより、繰り返しのワークフローで API 呼び出しが大幅に削減されます。 - すべての ID は UUID 形式: すべての ID（候補者、求人、応募、ステージ）は UUID です。不正な形式の ID を渡すと 400 エラーが返ります。
- 検索の制限:
ASHBY_SEARCH_CANDIDATESは、完全一致のメールアドレスまたは部分一致の氏名にのみ対応しており、複合クエリやその他のフィールドはサポートしていません。より広範囲な検索には、ページネーション付きのASHBY_LIST_CANDIDATESを使用してください。
クイックリファレンス
| ツールスラッグ | 説明 |
|---|---|
ASHBY_CREATE_CANDIDATE | 新しい候補者を作成（name 必須） |
ASHBY_LIST_CANDIDATES | すべての候補者をページネーションと同期機能付きで一覧表示 |
ASHBY_SEARCH_CANDIDATES | メールまたは氏名で候補者を検索 |
ASHBY_GET_CANDIDATE_INFO | 候補者の詳細情報を取得（candidateId 必須） |
ASHBY_UPDATE_CANDIDATE | 候補者のプロフィール情報を更新 |
ASHBY_LIST_CANDIDATE_NOTES | 候補者の内部メモを一覧表示 |
ASHBY_CREATE_JOB | 求人を作成（title、teamId、locationId、brandId 必須） |
ASHBY_LIST_JOBS | すべての求人をページネーションと同期機能付きで一覧表示 |
ASHBY_GET_JOB_INFO | ID で求人の詳細情報を取得 |
ASHBY_CREATE_APPLICATION | 候補者を求人に応募（candidateId、jobId 必須） |
ASHBY_LIST_APPLICATIONS | すべての応募をページネーションと同期機能付きで一覧表示 |
ASHBY_LIST_INTERVIEW_SCHEDULES | 予定された面接をページネーション付きで一覧表示 |
Powered by Composio