Recruitee MCP

Claude の中から Recruitee / Tellent パイプラインを操作できます。会話から離れることなく、求人を調べたり、候補者とその候補者について記録されたすべてを読んだり、ソーシングした人を追加したり、面接評価を書いたりできます。

これは、あなた自身のマシン上で、あなた自身の Recruitee API トークンを使って動作します。そのため、書き込まれるすべての情報は、あなたが自分でクリックしたのとまったく同じように、あなたの名前で記録されます。

できること

14 個のツールがあります。9 個が読み取り、5 個が書き込みです。書き込みはすべて、実行前に何を行おうとしているかを正確に表示します。

読み取り

応募時の回答について一言: 給与希望などは 求人ごとに 返されます。3 つの仕事に応募した人は同じ質問に 3 回答えているため、フラットなリストではそれらの回答を区別できないからです。

書き込み

書き込みの動作

名前を受け取り、ID は受け取りません。 「Dana Whitfield」「Regional Sales Manager」のように。名前が 2 人に一致した場合は、1 人を選ぶのではなく停止して一覧表示します — 間違った人物に評価を記録することが、ここで実際に重要な失敗だからです。

すべての書き込みは最初にプレビューを表示します。 最初の呼び出しは、書き込まれる内容を正確に返し、何も書き込みません。あなたが承認した後にのみ、実際に書き込まれます。新しい候補者の場合、プレビューは重複チェックも実行し、どの詳細が欠けているかを教えてくれるので、レコードが存在する前に、後ではなく事前にわかります。

評価は、候補者の実際の現在のステージに対して記録されます — それが評価の意味です。意図的に上書きすることはできますが、自分で調べる必要はありません。

段落はそのまま保たれます。 Recruitee のメモ欄はプレーンテキストを受け取りますが、そのインターフェースはテキストを HTML としてレンダリングします。そのため、段落で書かれたメモは、そのままだと 1 つの長いブロックとして届きます。改行は変換され、テキストは最初にエスケープされるため、文章に含まれる意図しない < が飲み込まれたりレンダリングされたりすることはありません。

評価はチェックされ、丸められません。 有効な値は設定されたスケールに依存します — 4 段階のサムズスケールには「中立」がなく、5 段階にはあります。スケールにない値は、隣の値に静かに変換されるのではなく、拒否されます。

Related MCP server: Recruitee MCP Server

自社データベースからのソーシング

rt_source_candidates は、Candidates 画面が実行するのと同じ検索を実行します。これは rt_search_candidates とは異なるものです。前者は名前を一致させ、後者は CV テキストを含むすべて をブール演算子で一致させます。

query: "renewals AND churn"
query: "(SaaS OR B2B) AND \"net revenue retention\" NOT \"vice president\""

これが重要なのは、職種名は企業によって一貫性がなく、実際に何をしたかは CV に書かれているからです。証拠を検索することは、職種名を検索することよりも優れています。

フィルターは組み合わせられます: offer、excludeOffer、jobStatus、stage、status、tags、sources。excludeOffer は、これを検索ボックスではなくソーシングツールにするものです — 求人を補充するときに、すでにその求人にいる人を結果から除外します。

すべての結果には、一致した理由 — HTML を取り除いた実際の文 — と、その人物がすでに参加しているすべての求人 が、ステージと、不合格になった場合はその理由とともに含まれます。最後の部分は飾りではありません: 実績のある ATS の候補者のほとんどは一度は不合格になっています。2 年前の「勤務地が違う」は今日には当てはまらないかもしれませんが、「評価に不合格」は今でも当てはまります。それをなしに、新しい発見として提示されるべきではありません。

フィルター構築が疑い深く見える理由

/search/new/candidates は、認識できないものを静かに無視し、エラーではなくフィルタリングされていない結果を返します。もっともらしく、しかも大きく間違った答えを得る方法は 4 つあり、すべて実在のアカウントで確認されています:

最後のものが最も厄介です: 求人と勤務ステータスを 2 つのオブジェクトとして送信すると、その勤務ステータスを持つ全員が返され、求人フィルターが破棄されたことを示すものはどこにもありません。そのため、エンティティに対するすべての制約は 1 つのオブジェクトに統合され、呼び出し元が指定したキーが API に届くことはありません — 名前は実在の API に対して検証された語彙にマッピングされ、その範囲外のものは例外をスローします。

対照的に、間違った 値 は安全です: ゼロが返されるため、読む人にとって明らかに間違っているとわかります。ゼロの結果には実際のステージ名も付いてくるので、タイプミスのステージは空のステージと区別できます。

node sourcing-test.js は、上記の 4 つの間違いのそれぞれをクライアントが拒否することも含め、すべてをチェックします。

セットアップ

一度だけ、5 分で完了します。Node 18 以降 (node -v で確認) と Claude Code または Claude デスクトップアプリ が必要です。

1. インストール

npm install

2. 独自の API トークンを作成する

Recruitee で: 設定 → アプリとプラグイン → API トークン に移動し、個人用 API トークン タブのままにして、+ トークンを追加 をクリックします。パスワードを求められ、その後一度だけ値が表示されます。

その画面で、上部の 現在の会社詳細 パネルから会社を確認します。数値の ID または サブドメイン のどちらでも機能します。

これは あなた自身の トークンでなければならず、共有トークンではいけません。Recruitee のトークンは作成者として動作するため、あなたのトークンで書かれた評価はあなたのものとして表示されます — それがポイントです。チャット、メール、チケットに貼り付けないでください。

3. 保存する

npm run set-token -- <paste-your-token-here> <your-company>

後でトークンをローテーションするには、npm run set-token -- <new-token> を実行するだけです — 会社は記憶されています。

これは session/token.json に書き込まれ、あなただけが読み取れ、gitignore されています。パスワードマネージャーに保存したい場合は、環境変数 RECRUITEE_API_TOKEN がファイルを上書きします。

4. 動作を確認する

npm run check

確認したいのは authenticated: true と、自分の求人がいくつか表示されることです。

5. Claude に接続する

このフォルダ内でこれを実行し、その後 Claude を再起動します:

claude mcp add recruitee -- node "$PWD/server.js"

代わりに Claude デスクトップアプリを使っていますか? 設定 → 開発者 → 設定を編集 を開き、実際の絶対パス (pwd で表示されます) を指定してこれを追加します:

{
  "mcpServers": {
    "recruitee": {
      "command": "node",
      "args": ["/absolute/path/to/recruitee-mcp/server.js"]
    }
  }
}

その後、Claude に「Recruitee の募集中の求人を一覧表示して」と依頼します。

使用時のイメージ

あなた: Regional Sales Manager のパイプラインには誰がいますか?

あなた: Dana Whitfield を表示して — 彼女は給与をいくらと入力した? 彼女にはどんな評価が既にある?

あなた: その求人について彼女の評価を書いて。はい: 更新と拡張に強く、9 人のチームを率い、PLG の経験はなし。

Claude は評価、メモ、求人、ステージを表示し、何も書き込みません。

あなた: はい、送信してください。

意図的にできないこと

Recruitee API トークンは、それを生成した人の権限を正確に保持します — ドキュメントには、「そのユーザーの名前で Web またはモバイルアプリケーションと同じ操作を実行できる」と明記されています。読み取り専用のトークンを発行する方法はありません。

そのため、抑制はこのコードに組み込まれています。不合格にする、再び合格にする、削除する、隠蔽する、匿名化する — これらはすべて実際に存在しドキュメント化されたエンドポイントですが、このサーバーは実装していません。フラグの背後に隠されているのでも、コメントアウトされているのでもなく、存在しないのです。そのため、いかなる指示、プロンプト、バグもそれらに到達できません。候補者を不合格にすることは、UI で行うあなたの判断のままです。

ステージ移動は唯一許可されている操作です。 rt_set_stage は、候補者を 1 つの求人のパイプラインに沿って進めます。これは判断ではなく記帳であり、ここから進められないパイプラインは、他の場所で追跡しているものとずれてしまうからです。線引きは不合格の時点で引かれ、文書化だけでなく強制されます: この移動はすでに不合格になった配置を拒否します。ステージを変更するとその人を再び合格扱いにしてしまうからです — 記帳呼び出しの副作用として誰かの不合格を取り消すことになります。

npm run smoke は、実行のたびに次のプロパティを検証します: 破壊的なツールが公開されていないこと、ステージ移動が不合格の配置を拒否し 1 つの求人に限定されていること、すべての書き込みが確認ゲートを明示していること。最後のチェックは、名前パターンのリストではなくツールスキーマから書き込みを導出します — 以前のバージョンは新しいツールを静かにカバーしなくなり、rt_set_stage をまったくテストせずに通していました。

知っておくとよいこと

新規候補者は「Sourced」に登録されます。 Recruitee の create エンドポイントは常に人材を「Applied」に登録するため、あなたがソーシングした全員が本物の応募者の中に紛れ込んでしまいます。そのため、作成直後に移動され、移動が成功しなかった場合は通知されます。stage を渡すと上書きできます — 実際に応募した人には "Applied"、すでにプロセスが進行中の人にはそれ以降のステージを指定します。後から移動するには rt_set_stage を使用します。

CV を設定すると、既存の CV が置き換えられます。 Recruitee の set_as_cv は CV を追加するのではなく、スロットを入れ替えて以前のファイルを通常の添付ファイルに格下げします。そのため rt_attach_file は、replaceCv を渡さない限り、すでに CV を持つ候補者に CV を設定することを拒否します。ファイル上の CV は誰かの決定であり、上書きした痕跡は添付ファイルリストの追加行だけです。

評価はあなたの名前で記録されます。 手動でクリックしたものと区別できない「あなたが評価しました」として表示されます。行っていない会話や読んでいない会話について評価を書くことは絶対に避け、判断が同僚によるものであれば、その旨をメモに記載してください。

帰属情報は取得時に信頼できません。 任意の API トークンを介して書き込まれたものはすべて、そのトークンの所有者に帰属します。そのため、誰かが同期した評価のレビュー担当者は、面接を行った本人ではなく、同期した人になる可能性があります。通常、メモには実際の担当者が記載されています。

アンケートのスコアカードはサポートされていません。 対応しているのは通常の評価カードのみです。API ドキュメントには、各レスポンスの質問ごとの回答が記載されていますが、リクエストボディには一切記載されていないため、書き込み形式は実際の送信を観察して確認する必要があります。また、あなたのアカウントでは問題にならない可能性もあります。/results/scorecards が面接ステージを通過した人に対して空で返ってくる場合、使用されているのは通常の評価カードであり、欠落しているものはありません。アンケートのパスに投資する前に確認する価値があります。

動作環境

これはローカル stdio MCP サーバーです。Claude はこれをあなたのマシン上でプロセスとして起動し、トークンがマシンの外に出ることはありません。

• Claude Code（ターミナル、デスクトップアプリ、IDE 拡張機能）✅

• Claude デスクトップアプリ ✅

• ブラウザの claude.ai ❌ — これは HTTPS で到達可能なリモート MCP サーバーにのみ接続します。つまり、これをホスティングし、全員の Recruitee トークンをそのホストに保存する必要があります。

設定

トラブルシューティング

開発

npm run smoke     # self-check: tool list, no destructive tools, confirm gates, one live read
npm run sourcing  # 20 checks on the search filters, including the four silent-failure modes
npm run check     # prove the token
npm start         # run the server directly (it speaks JSON-RPC on stdin/stdout)

ドキュメントではなくプロービングによって発見された2つの実装メモ:

• ファイルアップロードはドキュメント化されていません。 リファレンスには、取得方法が説明されていないサーバーサイドの path を含む JSON ボディが記載されています。プレーンな multipart POST が機能し、ファイルパートは attachment[file] という名前です。裸の file は 500 を返し、候補者 ID をクエリパラメータとして渡すと、誰にもリンクされていない添付ファイルが作成されます。ファイルを CV スロットに昇格させると、新しい ID と生成されたファイル名で置き換えられるため、アップロードはアップロードされた ID ではなく、候補者の CV URL に対して検証されます。

• /search/new/candidates は自身のクエリパラメータを無視し、会社内のすべてのレコードを返すため、名前検索は代わりに /candidates?query= を使用します。パイプラインステージは /offers/{id}/pipeline_templates ではなく、/offers/{id}/placements からステージごとにグループ化されて取得されます。/offers/{id}/pipeline_templates は、ロールが利用可能なテンプレートをステージなしで一新規候補者は「Sourced」に登録されます。 Recruitee の create エンドポイントは常に人材を「Applied」に登録するため、ソーシングした全員が実際の応募者の中に紛れ込んでしまいます。そのため、作成直後に移動され、移動が成功しなかった場合は通知されます。stage を渡すと上書きできます — 実際に応募した人には "Applied"、すでにプロセスが進行中の人にはそれ以降のステージを指定します。後から移動するには rt_set_stage を使用します。

CV を設定すると、既存の CV が置き換えられます。 Recruitee の set_as_cv は CV を追加するのではなく、スロットを交換して以前のファイルを通常の添付ファイルに格下げします。そのため rt_attach_file は、replaceCv を渡さない限り、すでに CV を持つ候補者に CV を設定することを拒否します。ファイル上の CV は誰かの決定であり、上書きした痕跡は添付ファイルリストの追加行だけです。

評価はあなたの名前で記録されます。 手動でクリックしたものと区別できない「あなたが評価しました」として表示されます。行っていない会話や読んでいない会話について評価を書くことは絶対に避けてください。また、判断が同僚によるものである場合は、その旨をメモに記載してください。

帰属情報は戻ってきた時点では信頼できません。 任意の API トークンを通じて書き込まれたものはすべて、そのトークンの所有者に帰属します。そのため、誰かが同期した評価のレビュー者は、面接を行った本人ではなく、同期した人になる可能性があります。メモには通常、実際の人物が記載されています。

アンケートのスコアカードはサポートされていません。 サポートされているのは通常の評価カードのみです。API ドキュメントには、各レスポンスに質問ごとの回答が記載されていますが、リクエストボディには一切記載されていないため、書き込み形式は実際の送信を観察して確認する必要があります。また、あなたのアカウントでは問題にならない可能性もあります。/results/scorecards が面接ステージを通過した人に対して空で返ってくる場合、使用されているのは通常の評価カードであり、欠落しているものはありません。アンケートのパスに投資する前に確認する価値があります。

動作環境

これはローカル stdio MCP サーバーです。Claude はこれをあなたのマシン上でプロセスとして起動し、あなたのトークンがマシンの外に出ることはありません。

• Claude Code（ターミナル、デスクトップアプリ、IDE 拡張機能）✅

• Claude デスクトップアプリ ✅

• ブラウザの claude.ai ❌ — これは HTTPS で到達可能なリモート MCP サーバーにのみ接続します。つまり、これをホスティングし、全員の Recruitee トークンをそのホストに保存する必要があります。

設定

トラブルシューティング

開発

npm run smoke     # self-check: tool list, no destructive tools, confirm gates, one live read
npm run sourcing  # 20 checks on the search filters, including the four silent-failure modes
npm run check     # prove the token
npm start         # run the server directly (it speaks JSON-RPC on stdin/stdout)

ドキュメントではなくプロービングによって発見された2つの実装メモ:

• ファイルアップロードはドキュメント化されていません。 リファレンスには、サーバーサイドの path を含む JSON ボディが記載されていますが、その取得方法は説明されていません。プレーンな multipart POST が機能し、ファイルパートは attachment[file] という名前です。裸の file は 500 を返し、候補者 ID をクエリパラメータとして渡すと、誰にもリンクされていない添付ファイルが作成されます。ファイルを CV スロットに昇格させると、新しい ID と生成されたファイル名で置き換えられるため、アップロードはアップロードされた ID ではなく、候補者の CV URL に対して検証されます。

• /search/new/candidates は自身のクエリパラメータを無視し、会社内のすべてのレコードを返すため、名前検索は代わりに /candidates?query= を使用します。パイプラインステージは /offers/{id}/pipeline_templates ではなく、/offers/{id}/placements からステージごとにグループ化されて取得されます。/offers/{id}/pipeline_templates は、ロールが利用可能なテンプレートをステージなしで一覧表示します。