HireLab Screener — 個人用MCPコネクタ

あなたのClaudeがあなたのHireLab Screener ATSから読み取れるようにします。読み取り専用で安全です。サービスアカウントとしてログインし、既存のオーナースコープAPIを呼び出すため、テナント分離ルールがすべて適用されます。Claudeは検索と閲覧ができますが、編集や削除はできません。

Claudeにできること（15ツール）

読み取り（常時有効）

書き込み / アクション（MCP_ALLOW_WRITES=true のとき有効。デフォルトは有効）

Claudeに対してやりたいことをそのまま依頼できます。例："Ravi Kumar（ABB、18 LPA、Pune）をL&TのPLC案件に追加して、明日彼に電話するリマインダーを設定しておいて。"

安全性

• すべてのアクションは、お使いのATSのオーナースコープAPIを経由するため、Claudeが触れるのは自社のデータだけに限られます。

• 書き込みツールにはMCPのメタデータ（annotations）が付与されており、編集やメール送信の前にClaudeが提示・確認します。

• 削除ツールは公開されていません。削除はアプリ側の操作に残留します。

• Renderで MCP_ALLOW_WRITES=false に変更するだけでしたら、いつでも即座に読み取り専用に戻せます。

Related MCP server: Lever ATS MCP Server

今回限りのセットアップ

1. ATSでサービスアカウントを作成する

通常のATSユーザー（例：ユーザー名 claude-mcp）を強力なパスワードで作成します。専用アカウントにすることで、自分のログインに影響を与えずMCPのアクセスをいつでも無効化できます。そのアカウントは自社に属し、自分のデータが確認ができるように会社所属である必要があります。

2. このフォルダを新しいRenderサービスとしてデプロイする

• このフォルダ（またはサブフォルダ）をGitリポジトリに配置し、それを指す新しいRender Web Serviceを作成します（ATSサービスとは別で、独立したものです）。

• Renderは render.yaml を使います（build: requirements をインストール、start: python mcp_server.py）。

• 新しいサービスのEnvironmentで以下を設定します：

  • ATS_BASE_URL = 使用しているATSのURL。例：https://hirelabscreener.onrender.com（末尾スラッシュなし）

  • ATS_USERNAME = claude-mcp

  • ATS_PASSWORD = そのアカウントのパスワード

  • MCP_SECRET = 十分な長さのランダム文字列（例：30文字以上）。外部に漏らさないこと。

  • MCP_ALLOW_WRITES = true でアクション（追加・更新・メール送信）を許可、または false で読み取り専用。デフォルトは true。

• デプロイ後、https://<your-mcp-service>.onrender.com/health が {"status":"ok"} を返すことを確認します。

3. Claudeに追加する

• Claude.ai → Settings → Connectors → Add custom connector。

• 名前： HireLab Screener

• URL： https://<your-mcp-service>.onrender.com/mcp ← 必ず /mcp 展だけを指定します。URLにシークレットは含めません。

• OAuth Client ID / Secret は空欄のままにし、Addをクリックします。

• Claudeが小さな "Connect HireLab Screener" ページを開くので、そこに MCP_SECRET を一度入力して、Authorizeをクリックします。これでClaudeが接続されます。

• チャットで、コネクタメニューを開いて有効にし、次のように聞いてます："募集中の案件を一覧表示して。"

なぜシークレットページが必要か？ claude.ai のWebコネクターフローは、個人用サーバーでもOAuthサインイン手順を要求するため、このコネクタは軽量なOAuthハンドシェイクを実行します。MCP_SECRET が「その一度だけのサインイン」です。トークンは30日間有効で、MCP_SECRET を変更すると即座にアクセスを失効させられます。

セキュリティ上の注意点

• MCPエンドポイントはシークレットパスの後ろに隠されていて、シークレットがない場合リクエストは404になります。

• ツールは読み取り専用です。後に書き込みアクションを確定的に追加するには、mcp_server.py の TOOLS を拡張します。

• アクセスのローテーションは、MCP_SECRET を変更（コネクタのURLも更新）するか、ATSでサービスアカウントを無効化することで行えます。

• 無料のRenderサービスはアイドル時にスリープします。スリープ後の最初の呼び出しは、復帰まで約30秒かかることがあります。常時起動しておきたい場合はプランをアップグレードしてください。