ClaudeとWorkableを連携する方法 — 接続手順とできること

Workable Connectorでできること

Workable ConnectorはClaudeとWorkableを直接つなぐコネクタです。候補者のパイプライン移動、レビューやコメントの追加、リクイジション(採用申請)とオファーの承認、従業員・HRデータの参照を、チャットの指示で実行できます。読み取りだけでなく書き込みにも対応します。

Claude Marketplaceの掲載ページには、カテゴリがProductivity、提供元がWorkable、認証が「Sign-in Required」、追加時期が2026年5月と載っています。状態は「Anthropic verified」です。接続先のURLは https://mcp.workable.com/mcp です。

求人については、読む操作に限られます。求人の一覧・詳細・応募フォーム・ステージ・担当メンバーを取得するツールはありますが、求人の作成や編集のツールは、掲載ページにもWorkableのドキュメントにもありません。「求人を新規作成して」という指示は、このコネクタでは実行できない前提で考えます。

Claude Codeから使う場合も、claude.aiやDesktopで使う場合も、つながる先は同じMCPサーバーです。

接続前に決めておくこと

最初に、どのプランで追加するかを確認します。リモートMCPのカスタムコネクタは、Free・Pro・Max・Team・Enterpriseの全プランで使えます。Freeは1件までです。

Team・Enterpriseでは、先に管理者が組織へ追加し、各メンバーが自分のアカウントで「Connect」する2段階です。追加できるのは、TeamならOwnerとPrimary Ownerです。Enterpriseは、この2つに加えて「Manage access to Libraries」を含むカスタムロールの人も追加できます。

もう1つは経路です。コネクタを追加すると、ClaudeはAnthropicのクラウド基盤からMCPサーバーへ接続します。claude.ai・Claude Desktop・Cowork・モバイルアプリのどれでも同じです。

ローカル端末のネットワークを通らないので、VPN内や社内限定のサーバーには届きません。その場合は、AnthropicのIPアドレス帯をファイアウォールで許可します。

Claudeが触れるのは、サインインしたWorkableアカウントが許されている範囲です。

カスタムコネクタの仕組みと、自前でリモートMCPサーバーを立てる方法は、Coworkカスタムコネクタ自作ガイドにあります。Workableは既存のサーバーにつなぐだけなので、自作は要りません。

claude.aiへの追加手順

掲載ページの「Add to Claude」から追加する方法と、URLを自分で入力する方法があります。どちらも接続先は同じURLです。URLを入力する場合の手順は、Team・Enterpriseの管理者なら次のとおりです。

メンバーは、「Customize」の「Connectors」でWorkableを探して「Connect」を押し、Workableへサインインして権限を許可します。項目には「Custom」ラベルが付くことが多く、接続先のドメインがディレクトリの掲載先と一致するときは、Workableの名称とロゴで表示されます。

個人のPro・Maxプランでは組織側の作業がありません。「Customize」の「Connectors」で「+ Add」から「Add custom connector」を選び、名前とURLを入れて、上と同じ認証設定を見直します。

追加しただけでは会話では使われません。チャット画面左下の「+」から「Connectors」を開き、Workableのトグルをオンにします。有効化は会話ごとなので、候補者データを扱わない会話はオフのままにできます。

Claude Codeで使う2つの経路

Claude Codeからは、claude.aiで追加済みのコネクタをそのまま使う方法と、コマンドで直接追加する方法があります。

コマンドで追加する場合は、HTTPトランスポートを指定します。

claude mcp add --transport http workable https://mcp.workable.com/mcp

WorkableのMCPサーバーは、Streamable HTTPのステートレス構成で、SSEは使いません。OAuthの動的クライアント登録(RFC 7591)にも対応しているので、上のコマンドに --client-id は付けていません。v2.1.289の claude mcp add --help から、この記事に関係するオプションを抜き出します。

Usage: claude mcp add [options] <name> <commandOrUrl> [args...]
 
Options:
  --callback-port <port>       Fixed port for OAuth callback (for servers
                               requiring pre-registered redirect URIs)
  --client-id <clientId>       OAuth client ID for HTTP/SSE servers
  --client-secret              Prompt for OAuth client secret (or set
                               MCP_CLIENT_SECRET env var)
  -H, --header <header...>     Set headers for HTTP/SSE servers
  -s, --scope <scope>          Configuration scope (local, user, or project)
                               (default: "local")
  -t, --transport <transport>  Transport type (stdio, sse, http).

--callback-port と --client-id は、事前登録のリダイレクトURIが必要なサーバー向けです。動的登録に対応するWorkableでは、通常は不要です。保存先は既定でlocalスコープです。チームで共有したい場合は、--scope project を付けるとプロジェクトルートの .mcp.json に書き出されます。候補者データを扱う接続を共有設定に載せるかどうかは、別に決めます。

追加後は claude mcp list で、各サーバーの状態を ✔ Connected・! Needs authentication・✘ Failed to connect のように確かめられます。

Claude Codeのドキュメントによると、claude.aiのコネクタが一覧に出ないときは、認証方式を疑います。ANTHROPIC_API_KEY・ANTHROPIC_AUTH_TOKEN・apiKeyHelper のいずれかが有効、BedrockなどのサードパーティプロバイダーやClaude Code用の長期トークン(claude setup-token)を使っている場合は、claude.aiのコネクタが読み込まれません。/status で認証方式を確かめ、/login でclaude.aiのアカウントを選び直します。

ツールは45本か94本か

掲載ページには「40+ tools」とあり、「Show all」を開くと45本が並びます。一方でWorkableのMCPサーバーのドキュメントは、カテゴリごとに合計94本のツールを載せています。

掲載ページにあって、ドキュメントの94本にないツールはありません。差はドキュメント側の追加分です。掲載の45本に含まれない例は、メンバーの招待・ロール変更・無効化です。勤怠の打刻や、評価サイクルの提出と署名のツールも含まれません。

実際にClaudeの画面に並ぶのがどちらの範囲かは、接続後に /mcp(Claude Code)か会話の「Search and tools」メニューで確かめます。ドキュメントには、アカウントの指定方法も書かれています。まず get_accounts で一覧を取り、各ツールの account パラメーターにサブドメインを渡す仕様です。複数のアカウントに所属する人は、対象のアカウントを指示に入れておくと取り違えを避けられます。

取り消しにくい書き込みツール

書き込み系のうち、実行結果を元に戻しにくいものをWorkableのドキュメントの記述から拾うと、次のようになります。

mark_review_task_ready も、有効な評価サイクルでは以後フォームを編集できなくなる操作として、ドキュメントに「point of no return」と書かれています。

書き込みを絞る3つの手段

手段は3つあります。まず、会話の「Search and tools」メニューで、その会話で使わないツールを無効にします。サポート記事は、関係のないツールを無効にする使い方を案内しています。

次に、ツール呼び出しの承認です。サポート記事は「Allow always」を、信頼できるサーバーとツールを無人で動かす場合だけに限るよう案内しています。候補者のステージ移動やオファー承認は、Workableのデータを実際に書き換えます。

最後が組織の設定です。Team・Enterpriseの管理者は、コネクタのツールごとに ask(毎回承認)と blocked(隠す)を設定できます。Claude Codeでは、ask のツールは bypassPermissions モードでも毎回確認が出て、「次回から許可」の選択肢も出ません。ただし、デスクトップアプリのローカル・SSHセッションでは ask がClaude Codeに届かず、通常の権限ルールが適用されます。

Researchの機能は、コネクタのツールを承認なしで自動的に呼び出せます。サポート記事は、Researchで使うカスタムコネクタの書き込み系ツールを、事前に無効にするよう案内しています。

Workableのドキュメントは、求人と候補者の活動ログを取るツールを、監査と報告の用途として挙げています。操作のあとに状態を読み返す手段にもなります。

操作の記録は、Claudeコネクタの権限設定は監査ログでどこまで追えるかで扱っています。

症状別のつまずき

Claude Codeで足した同じURLのサーバーとclaude.aiのコネクタが並ぶと、コネクタ側は「hidden」と表示されます。どちらを使うかを決め、片方を外します。

Claude側の設定から決める運用

候補者の一覧確認やコメント追加だけなら、書き込み系を無効にした会話で足ります。要件照合やスコアリング、リクイジション承認を軸にした使い方は、Workableの一次スクリーニングで扱います。

メンバー管理や勤怠のツールが一覧に出る組織では、45本との差分を blocked にするかどうかが、管理者の判断点になります。