Curriculo ATS MCP サーバー

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

クイックスタート #

1 分以内に接続できます。このエンドポイントをどこでも使用してください:

最速のルートはClaudeのワンクリックコネクターフローです:

1. Claude → 設定 → コネクタを開きます。
2. カスタムコネクタの追加をクリックし、上記のサーバー URL を貼り付けます。
3. プロンプトに従って OAuthサインイン を完了します — Claude があなたの組織に接続します。
4. チャットを始めて、例: “私のオープンな役割のそれぞれのステージに何がある？”と聞いてください。

クライアントを接続 #

サーバーはストリーミング可能なHTTPで通信し、インタラクティブなOAuthとPersonal Access TokenをAuthorization: Bearer ヘッダー経由でサポートしています。クライアントを以下から選んでください。

# カスタムコネクタの URL
https://mcp.curriculo.me/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"

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

{
  "mcpServers": {
    "curriculo": {
  <span class="s">"command"</span>: <span class="s">"npx"</span>,
  <span class="s">"args"</span>: [<span class="s">"-y"</span>, <span class="s">"mcp-remote"</span>, <span class="s">"https://mcp.curriculo.me/mcp"</span>]
}

}
}

"args": ["-y", "mcp-remote", "https://mcp.curriculo.me/mcp",
        "--header", "Authorization: Bearer YOUR_CURRICULO_PAT"]

認証 #

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

OAuth 2.1 (推奨)

インタラクティブなクライアント（Claude、Cursor）は、動的クライアント登録を使用してOAuthを利用します。Curriculoにサインインし、接続を承認すると、クライアントは短命のトークンを保存し、自動的に更新します。手動でコピーしたり、回転させたりする秘密はありません。

個人アクセストークン (PAT)

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

1. ats.curriculo.meにサインインします。
2. 設定 → API & 統合 → 個人アクセストークンに移動します。
3. トークンを作成し、そのスコープを選択してコピーします（1回のみ表示されます）。
4. それをAuthorization: Bearer <token>として設定タブに示されたように渡します。

スコープ

トークンには1つまたは両方のスコープが含まれます。必要なものだけを付与してください:

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

ツール参照 #

6つのグループに25のツールがあります。readツールはデータを変更せず;writeツールはレコードを作成または修正し、メール、カレンダーイベント、または自動化を引き起こす可能性があります。

例のプロンプト #

接続したら、平易な言葉で聞いてください。クライアントは適切なツールを選択します。

• “私のオープンな役職の各ステージに何があるか見せて、停滞しているものをフラグ付けしてください。”
• “チームリード経験のあるシニアReactエンジニアを見つけ、上位5名を要約してください。”
• “Priyaを第二面接に進め、来週の空き状況を尋ねる返信を作成してください。”
• “この候補者と木曜日の午後2時ETに45分のビデオ面接をスケジュールし、Google Meetのリンクを追加してください。”
• “応募者のボリュームは先月と比べてどのように変化し、どの求人が最も転換率が高いですか？”

よくある質問 & トラブルシューティング #

セキュリティ #

• スコープ付きアクセス。すべてのトークンは1人のユーザーと1つの組織に結び付けられ、明示的なats:read / ats:writeスコープを持っています。
• 最小権限。仕事を行うために最も狭いスコープを付与し、分析には読み取り専用トークンを好みます。
• いつでも取り消し可能。個人アクセス トークンは設定 → API & 統合で取り消すことができ、OAuth接続はクライアントのコネクタ設定から削除できます。
• トランスポートセキュリティ。すべてのトラフィックはStreamable HTTP経由のHTTPSです。信頼できないクライアントにトークンを貼り付けたり、平文で共有しないでください。