CATS MCP by usefulapi

CATS MCP サーバー

接続

• Claude（claude.ai、Desktop）：Customize → Connectors を開き、+ Add → Add custom connector をクリックして、https://cats-ats.usefulapi.io/mcp を貼り付けます。
• Claude Code： claude mcp add --transport http cats-ats https://cats-ats.usefulapi.io/mcp を実行し、続けて /mcp を実行してログインします。
• VS Code： VS Code に追加。
• Cursor およびその他のクライアント： URL をリモート MCP サーバーとして追加します。

{
  "mcpServers": {
    "cats-ats": {
      "url": "https://cats-ats.usefulapi.io/mcp"
    }
  }
}

URL のみを追加してください。クライアントの設定に Authorization ヘッダーや API キーを追加しないでください。サーバーが OAuth でログインを行い、ログインページで CATS の認証情報を求められます。

設定手順、認証情報の確認方法、FAQ：https://usefulapi.io/cats-ats/

ツール

ツール	種類	説明
cats_get_site	読み取り	CATS サイトを取得
cats_list_users	読み取り	ユーザー一覧を取得
cats_list_candidates	読み取り	候補者一覧を取得
cats_get_candidate	読み取り	候補者を取得
cats_search_candidates	読み取り	候補者を検索
cats_filter_candidates	読み取り	候補者を絞り込み
cats_list_candidate_pipelines	読み取り	候補者のパイプライン一覧を取得
cats_list_candidate_activities	読み取り	候補者のアクティビティ一覧を取得
cats_list_candidate_tasks	読み取り	候補者のタスク一覧を取得
cats_list_candidate_attachments	読み取り	候補者の添付ファイル一覧を取得（メタデータ）
cats_list_jobs	読み取り	求人一覧を取得
cats_get_job	読み取り	求人を取得
cats_search_jobs	読み取り	求人を検索
cats_list_job_pipelines	読み取り	求人のパイプライン一覧を取得
cats_list_job_statuses	読み取り	求人ステータス一覧を取得
cats_list_pipelines	読み取り	パイプライン一覧を取得
cats_get_pipeline	読み取り	パイプラインを取得
cats_filter_pipelines	読み取り	パイプラインを絞り込み
cats_get_pipeline_status_history	読み取り	パイプラインのステータス履歴を取得
cats_list_workflows	読み取り	パイプラインのワークフロー一覧を取得
cats_list_workflow_statuses	読み取り	ワークフローのステータス一覧を取得
cats_list_companies	読み取り	会社一覧を取得
cats_get_company	読み取り	会社を取得
cats_search_companies	読み取り	会社を検索
cats_list_contacts	読み取り	連絡先一覧を取得
cats_get_contact	読み取り	連絡先を取得
cats_search_contacts	読み取り	連絡先を検索
cats_list_tasks	読み取り	タスク一覧を取得
cats_get_task	読み取り	タスクを取得
cats_list_activities	読み取り	アクティビティ一覧を取得
cats_add_candidate_activity	書き込み	候補者にアクティビティ（メモ）を追加
cats_create_task	書き込み	タスクを作成
cats_change_pipeline_status	書き込み	候補者を別のパイプラインステータスに移動
cats_create_candidate	書き込み	候補者を作成
cats_usage_status	メタ	使用状況（無料プランの利用状況）
cats_request_feature	メタ	不足している機能をリクエスト
cats_upgrade	メタ	Pro または Pro+ にアップグレード
cats_cancel_subscription	メタ	Pro サブスクリプションを解約

read ツールは読み取り専用です。write ツールはデータを変更するため、クライアント側で実行前に確認してください。meta ツールは使用状況の報告、サブスクリプションの管理、機能リクエストの送信を行います。

料金

プラン	料金	上限
Free（接続した CATS サイトごと）	$0	月 50 回のツール呼び出し
Pro（接続した CATS サイトごと）	$9/mo または $90/yr（2 か月分無料）	無制限*

*Pro には、このサーバーで月 10,000 回のツール呼び出しという適正利用上限があります。それ以上の利用については、[email protected] までご連絡ください。

Pro の対象はこのサーバーのみです。cats_upgrade で申し込んでください（Stripe Checkout のリンクが返されます）。cats_cancel_subscription でいつでも解約できます。Pro は支払い済み期間の終了まで利用でき、現在の期間分の返金はありません。また、その前に cats_upgrade を実行すると解約が取り消されます。[email protected] へのご連絡でも解約できます。

ライセンス

MIT

アクセス、個人データ、制限事項

CATS の Administration → API Keys で v3 API キーを作成してください。レガシーの Transaction Codes は使用できません。キーの生成フォームには、読み取り専用スコープの選択項目がありません。UsefulAPI と選択した AI クライアントには、共有する権限のあるデータのみを処理することを許可してください。CATS アカウントの利用資格とベンダー料金は、UsefulAPI のプランとは別です。この独立したコネクターは、ベンダーによる承認や推奨を主張しません。

候補者・連絡先レコードには個人情報が含まれます。政府発行の ID、健康データ、個人の財務情報、その他の CATS 禁止データには、このワークフローを使用しないでください。既知の認証情報や機微な財務・健康情報のフィールド、および HAL リンクブロックは除外されますが、自由記述欄とカスタムフィールドは引き続きお客様が確認する必要があります。ツールの結果は、選択した AI クライアントと LLM プロバイダーに送信され、それぞれのプライバシーおよびデータ保持ポリシーも適用されます。ベンダーのアクセスを停止するには CATS で API キーを無効にし、この接続を終了するには UsefulAPI を切断してください。

CATS のドキュメントには、1 時間あたり 500 件の API リクエスト制限がローリング方式で記載されています。カウンターの適用範囲は明記されていません。コレクションページのデフォルト件数は 25 件、最大件数は 100 件です。認証の上限は 10 秒／64 KiB、操作の応答の上限は 30 秒／8 MiB です。請求は確認済みの CATS サイト ID に基づくため、同じサイト内でキーをローテーションしてもアカウント ID は変わりません。

変更と自動化

4 種類の書き込み操作（候補者の作成、候補者のアクティビティ記録、タスクの作成、パイプラインステータスの変更）には、confirm:true が必要です。割り当てられたタスクによって、ユーザーに通知が届く場合があります。アクティビティタイプが email または text_message の場合でも、アクティビティメモによってメール／SMS送信リクエストが行われることはありません。独立して設定されたアカウントの自動化やウェブフックは、引き続き変更に反応する場合があります。

パイプラインの移動では、ワークフロー／ステータスのメタデータを読み取り、返されたすべてのトリガーを fire:false で抑制するよう明示的にリクエストし、create_activity=false を送信します。すでに現在のステータスである場合、書き込みは行われません。事前確認の読み取りはアトミックなロックではないため、同時変更が発生する可能性があります。また、独立したウェブフックは抑制されません。メール送信、削除、添付ファイルのダウンロード、一括エクスポート用エンドポイント、ウェブフック管理ツールは公開されていません。

ベンダーへのリクエストが自動的に再送されることはありません。作成操作では、ドキュメントに記載された 201 と、一致する Location レコード ID が必要です。応答が一致しない場合や、結果が不確かな場合はエラーになります。書き込みを再試行する前に、CATS を確認してください。日付のみのタスク／アクティビティの日付は、UTC の午前 0 時に送信されます。

検証

34 個のベンダーツールを、現行の API リファレンスとローカルモックに照らして確認しました。実際の試用アカウントを使用した読み取りで、アカウント ID と HAL 応答構造を検証しました。これにはベンダー提供のサンプルレコードも含まれます。実際の顧客の採用レコードや業務上の書き込み操作はテストしていません。現行の利用規約では、お客様の指示によるサードパーティーソフトウェアの利用が認められており、ベンダーは外部 API キーの設定ガイドを公開しています。ただし、これは CATS が UsefulAPI を審査したことを示すものではありません。

参考資料：API v3、利用規約、外部キーの設定。