Curriculo ATS MCPサーバーのドキュメント

Curriculo ATSをClaude、Cursor、その他のMCP互換AIクライアントに接続します。Curriculo ATS MCPサーバーは、https://mcp.curriculo.me/mcp にあるリモートのホストサーバーで、インストールは不要です。OAuth 2.1または個人用アクセストークンで一度認証すると、クライアントはリアルタイムであなたの採用データを読み取り、操作する25のツールを取得します。

ソース: https://curriculo.me/docs/mcp/ (Curriculo ATS)

プロパティ	値
エンドポイント	https://mcp.curriculo.me/mcp
トランスポート	ストリーミングHTTP
認証	OAuth 2.1 + 個人用アクセストークン (PAT)
スコープ	ats:read, ats:write
ツール	25

Curriculo ATS MCPサーバーは、リモートのホストサーバーで、ローカルにインストールまたは実行する必要はありません。任意のMCPクライアントをエンドポイントに向け、一度認証を行うと、クライアントはリアルタイムであなたの採用データを読み取り、操作するツールのセットを取得します。

クイックスタート

このエンドポイントを至る所で使用します: https://mcp.curriculo.me/mcp

最も速い方法は、Claudeのワンクリックコネクターフローです:

Claudeを開き、設定 > コネクタの順に進みます。
カスタムコネクタの追加をクリックし、上記のサーバーURLを貼り付けます。
プロンプトが表示されたらOAuthサインインを完了します。Claudeがあなたの組織に接続します。
チャットを始めて、たとえば「私のオープンな役割の各ステージに何があるか？」と尋ねます。

初めてですか？ステップバイステップのチュートリアル: ClaudeでATSを実行するをご覧ください。

クライアントを接続する

サーバーはストリーミングHTTPを使用し、インタラクティブなOAuthとパーソナルアクセストークンをAuthorization: Bearerヘッダーを介してサポートします。

Claude

Claude（Webまたはデスクトップ）で、設定 > コネクタ > カスタムコネクタの追加に進み、次を入力します:

https://mcp.curriculo.me/mcp

追加をクリックし、OAuthサインインを完了し、使用したい特定のツールを有効にするためにコネクタを開きます。

Claude Code

1つのコマンドでサーバーを追加します（OAuthはブラウザで/mcpを介して開きます）:

claude mcp add --transport http curriculo https://mcp.curriculo.me/mcp

または、ヘッダーで直接パーソナルアクセストークンを送信します:

claude mcp add --transport http curriculo https://mcp.curriculo.me/mcp \
  --header "Authorization: Bearer YOUR_CURRICULO_PAT"

Cursor

Cursor設定を開き、ツール & MCP > 新しいMCPサーバーに進み、mcp.jsonにこれを追加します:

{
  "mcpServers": {
    "curriculo": {
      "url": "https://mcp.curriculo.me/mcp"
    }
  }
}

VS Code / その他

ネイティブのリモートMCPサポートのないクライアントは、mcp-remoteブリッジを使用できます:

{
  "mcpServers": {
    "curriculo": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.curriculo.me/mcp"]
    }
  }
}

認証

認証方法は2つあります。どちらも、スコープ付きの権限を持つ1つの組織内のユーザーを解決します。

OAuth 2.1（推奨）

インタラクティブクライアント（Claude、Cursor）は、動的クライアント登録でOAuthを使用します。Curriculoにサインインし、接続を承認し、クライアントは短期間有効なトークンを保存し、自動的に更新します。

パーソナルアクセストークン（PAT）

CLIまたはヘッドレスセットアップの場合、ATSでトークンを生成し、Bearerヘッダーとして送信します:

ats.curriculo.meにサインインします。
設定 > API & 統合 > パーソナルアクセストークンに進みます。
トークンを作成し、そのスコープを選択してコピーします（1回のみ表示されます）。
Authorization: Bearer <token>として渡します。

スコープ

ats:read: ジョブ、応募者、受信箱、面接、分析をリストおよび読み取ります。
ats:write: データを作成および変更します: ステージを移動し、メールを送信し、面接をスケジュールし、ジョブを更新します。

whoamiツールを呼び出して、認証されたユーザー、組織、認証方法、および付与されたスコープを確認します。

ツールリファレンス（25のツール）

読み取りツールはデータを変更することは決してありません。書き込みツールは記録を作成または変更し、メールやカレンダーイベント、または自動化をトリガーすることがあります。

ジョブ（4）

list_jobs（読み取り）: あなたの組織内のジョブを新しい更新順にリストします。パラメーター: 状態、ページ、制限。
get_job（読み取り）: UUIDで1つのジョブの詳細を取得します。パラメーター: jobId（必須）。
create_job（書き込み）: デフォルトのファネルステージでジョブの投稿を作成します。タイトルのみが必須で、ドラフトで開きます。パラメーター: title（必須）、description、location、type、headcount、must_have_skills、preferred_skills、salary_min/max、salary_currency。
update_job_status（書き込み）: ジョブの状態を変更します（DRAFT / OPEN / PAUSED / CLOSED / ARCHIVED）。パラメーター: jobId、status（両方必須）。

応募者（8）

list_applicants（読み取り）: 応募者をリストします。オプションでジョブにスコープを設定し、スター付き/拒否/アーカイブフィルターがあります。パラメーター: jobId、starred、rejected、archived、page、limit。
get_applicant（読み取り）: 応募者の詳細情報: ファネルステージ、ジョブリンク、ノート、活動履歴。パラメーター: applicantId（必須）。
search_candidates（読み取り）: すべての候補者に対するセマンティック検索。パラメーター: query（必須）、jobId、timestamp、page、limit。
move_applicant_stage（書き込み）: 応募者を他のファネルステージに移動させます。ファネル自動化が作動します。パラメーター: applicantId、funnelId（必須）、reason。
add_applicant_note（書き込み）: 応募者にノートを追加します。パラメーター: applicantId、content（必須）、noteType、decisionFlag、roundName。
get_applicant_resume_text（読み取り）: 解析された履歴書のテキストおよび構造化データ。パラメーター: applicantId（必須）。
get_applicant_evaluation（読み取り）: AIエージェントグラフ評価: 適合スコア、AIタグ、要約、ギャップ状況。パラメーター: applicantId（必須）。
reprocess_resume（書き込み）: 履歴書パイプラインを再実行します（解析 + 評価 + グラフ取り込み）。パラメーター: applicantId（必須）。

受信箱とメール（5）

get_applicant_email_thread（読み取り）: 応募者の全メールスレッド。パラメーター: applicantId（必須）。
list_inbox_emails（読み取り）: 組織の受信箱の受信メールをリストします。パラメーター: jobId、status、search、page、limit。
get_inbox_stats（読み取り）: 未読カウントと合計の受信箱の概要統計。パラメーター: なし。
reply_to_applicant_email（書き込み）: 応募者に返信します。最新の受信メールにスレッドを追加します。接続されたGmailが必要です。パラメーター: applicantId、body（必須）、subject。
send_bulk_email（書き込み）: 1人以上の応募者にメールを送信します（IDで）。接続されたGmailが必要です。パラメーター: applicantIds、subject、messageBody（すべて必須）。

面接（2）

list_interviews（読み取り）: 面接をリストします。パラメーター: jobId、applicantId、status、type、dateFrom、dateTo、page、limit。
schedule_interview（書き込み）: 面接をスケジュールし、フィードバックリンクを生成し、（Gmailを使って）カレンダーイベントを同期し、全員にメールを送信します。パラメーター: applicantId、jobId、title、scheduledStart、scheduledEnd（必須）、さらにtype、location、meetingProvider、participantIds、externalInterviewers、timezone、instructions。

分析（2）

get_analytics（読み取り）: 組織の分析概要: 総応募者数、期間変化、ステージ別のパイプライン、トップジョブ、ソースミックス。デフォルトで過去30日間。パラメーター: dateFrom、dateTo。
get_dashboard（読み取り）: 受信箱とアクティブ応募者の職業ごとのファネル内訳。パラメーター: なし。

自動化とインポート（3）

list_job_automations（読み取り）: ジョブのために設定されたファネル自動化をリストします。パラメーター: jobId（必須）。
get_automation_executions（読み取り）: 単一自動化の実行履歴、ページネート済み。パラメーター: automationId（必須）、page、limit。
get_import_batch（読み取り）: 候補者インポートバッチのステータス: 進行状況、ファイルごとのステータス、エラー。パラメーター: batchId（必須）。

アカウント（1）

whoami（読み取り）: 認証されたユーザー、組織、認証方法、および付与されたスコープを返します。パラメーター: なし。

例のプロンプト

「私のオープンな役割の各ステージに何があるか見せてください、そして停滞しているものにフラグを立ててください。」
「チームリード経験を持つシニアReactエンジニアを見つけて、トップ5を要約してください。」
「Priyaをセカンドインタビューに移動し、来週の空き時間を尋ねる返信をドラフトしてください。」
「この候補者との45分のビデオ面接を木曜日の午後2時ETにスケジュールし、Google Meetのリンクを追加してください。」
「応募者のボリュームが先月とどう変わったか、そしてどのジョブが最も良くコンバージョンしていますか？」

書き込みツールには実際の副作用があります（メールの送信、パイプラインの変更、ジョブのクローズ）。信頼するワークフローまで書き込みアクションの承認を維持し、分析のみが必要な場合はats:readのみを付与してください。

FAQ & トラブルシューティング

何かをインストールまたはホストする必要がありますか？

いいえ。サーバーは完全にhttps://mcp.curriculo.me/mcpにホストされています。クライアントをURLに向け、認証します。

どのクライアントがサポートされていますか？

ストリーミングHTTP経由でリモートサーバーをサポートする任意のMCPクライアント: Claude（Web/デスクトップ）、Claude Code、Cursor、VS Codeなど。ネイティブのリモートサポートのないクライアントは、mcp-remoteブリッジを使用できます。

ツールに「ログインが必要」と表示されるか、接続できません。

OAuthフローを再実行します（Claude Codeでは/mcpと入力; Cursorでは「ログインが必要」をクリック）。PATを使用する場合、ヘッダーが正確にAuthorization: Bearer <token>であり、そのトークンが取り消されていないか期限切れでないことを確認してください。

メールまたは面接ツールがエラーを返します。

メールおよびカレンダーのツール（reply_to_applicant_email、send_bulk_email、schedule_interviewのメール部分）には、組織にアクティブなGmail接続が必要です。ATSでGmailを接続し、再試行してください。

AIができることを制限するには？

分析専用のats:readのみのトークンを発行し、クライアントのツール別の権限設定を使用して特定の書き込みツールを無効にします。

どの組織に対して操作しますか？

あなたのトークンに関連付けられた組織です。whoamiを呼び出して、いつでもユーザー、組織、およびスコープを確認できます。

セキュリティ

スコープ付きアクセス。 すべてのトークンは1人のユーザーと1つの組織にバインドされ、明示的にats:read / ats:writeのスコープを持ちます。
最小権限。 仕事を果たすために必要な狭いスコープを付与し、分析には読み取り専用トークンを優先します。
いつでも取り消し可。 個人用アクセストークンは設定、API & 統合で取り消すことができ、OAuth接続はクライアントのコネクタ設定から削除できます。
トランスポートセキュリティ。 すべてのトラフィックはストリーミングHTTPを介してHTTPSです。信頼できないクライアントにトークンを貼り付けたり、プレーンテキストで共有したりしないでください。

Canonical HTMLバージョン: https://curriculo.me/docs/mcp/