TalentHR MCP by usefulapi

usefulapi の TalentHR MCP

接続

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

{
  "mcpServers": {
    "talenthr": {
      "url": "https://talenthr.usefulapi.io/mcp"
    }
  }
}

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

手順を追ったセットアップ、認証情報の確認方法、よくある質問：https://usefulapi.io/talenthr/

ツール

ツール	種類	機能
talenthr_list_employees	read	従業員一覧（ディレクトリ）を取得します
talenthr_get_directory_filters	read	ディレクトリのフィルターを取得します
talenthr_get_employee	read	従業員を取得します
talenthr_get_employee_job	read	従業員の職歴を取得します
talenthr_get_organization_chart	read	組織図を取得します
talenthr_list_departments	read	部門一覧を取得します
talenthr_list_divisions	read	事業部一覧を取得します
talenthr_list_locations	read	勤務地一覧を取得します
talenthr_list_job_titles	read	職名一覧を取得します
talenthr_list_time_off_types	read	休暇の種類一覧を取得します
talenthr_list_employee_time_off_requests	read	従業員の休暇申請一覧を取得します
talenthr_get_employee_time_off_budgets	read	従業員の休暇残高を取得します
talenthr_get_calendar	read	休暇カレンダーを取得します
talenthr_list_holidays	read	祝日一覧を取得します
talenthr_list_benefits	read	福利厚生一覧を取得します
talenthr_get_employee_benefits	read	従業員の福利厚生を取得します
talenthr_list_assets	read	会社資産一覧を取得します
talenthr_get_employee_assets	read	従業員の資産を取得します
talenthr_list_job_positions	read	求人ポジション一覧を取得します
talenthr_list_job_position_applicants	read	求人ポジションの応募者一覧を取得します
talenthr_list_applicants	read	全応募者一覧を取得します
talenthr_get_applicant	read	応募者を取得します
talenthr_get_headcount_report	read	人員数レポートを取得します
talenthr_get_hires_leaves_report	read	入社・退職レポートを取得します
talenthr_get_time_off_report	read	休暇レポートを取得します
talenthr_list_time_tracking_entries	read	勤務時間記録一覧を取得します
talenthr_create_time_off_request	write	休暇申請を登録します
talenthr_reply_time_off_request	write	休暇申請を承認または却下します
talenthr_create_applicant_note	write	求人応募にメモを追加します
talenthr_usage_status	meta	使用状況（無料プランの使用量）
talenthr_request_feature	meta	不足している機能をリクエストします
talenthr_upgrade	meta	Pro または Pro+ にアップグレードします
talenthr_cancel_subscription	meta	Pro サブスクリプションを解約します

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

料金

プラン	価格	上限
Free（TalentHR テナント／キーごと）	$0	月 50 回のツール呼び出し
Pro（TalentHR テナント／キーごと）	$9/mo または $90/yr（2 か月分無料）	無制限*

*このサーバーでの Pro のフェアユース上限は、月 10,000 回のツール呼び出しです。それ以上必要な場合は、[email protected] までお問い合わせください。

Pro の対象はこのサーバーのみです。talenthr_upgrade を使って登録してください（Stripe のチェックアウトリンクが返されます）。talenthr_cancel_subscription を使えば、いつでも解約できます。Pro は支払い済み期間の終了まで利用でき、現在の期間分の返金はありません。その前に talenthr_upgrade を実行すると、解約は取り消されます。または [email protected] までお問い合わせください。

ライセンス

MIT。

HR データ、通知、アクセス

要求された従業員、候補者、報酬などの HR 記録は、選択した AI クライアントおよび LLM プロバイダーに渡されます。API キーは渡されません。この処理が許可されたデータのみ接続してください。TalentHR で専用の API キーのスコープを設定し、必要に応じて無効化することで、アクセスを管理できます。

休暇を申請すると、マネージャーにメールが送信されます。マネージャーが対応できない場合は、従業員に通知されます。許可されている場合、事前承認済みの申請はマネージャーの承認を省略します。明示的に承認された申請に限り使用してください。保留中の休暇申請を承認または却下すると、従業員にメールが送信されます。応募者のメモは社内用で、採用担当者に表示されます。採用、解雇、給与変更、添付ファイルは公開されません。

リクエストは自動的に再試行されません。書き込みが完了したか不明な場合は、繰り返す前に TalentHR を確認してください。使用量と請求の識別には、キーがドメイン設定を読み取れる場合はテナントのドメインが、それ以外の場合はキー自体が使用されます。ドメイン設定へのアクセス権がない状態でキーをローテーションすると、識別情報が変わる可能性があります。独立したインテグレーションであり、ベンダーの承認や推奨を主張するものではありません。