Dreamwork

@dreamworkhq/mcp

Dreamwork 用の MCP サーバーです。AI エージェント向けの求人検索ツールを提供します。Claude Desktop、Cursor、MCP Inspector など、あらゆる MCP クライアントで利用でき、求人の検索やランキング付け、応募書類の調整、応募、そして一人のユーザーの成果を継続的に追跡できます。

このサーバーは薄いゲートウェイです。HTTPS 経由で Dreamwork API を呼び出し、独自のデータベースアクセスは持ちません。トランスポートは stdio で、標準出力には JSON-RPC フレームのみが出力されます。

インストール

インストール手順はありません。MCP クライアントが必要に応じて npx で実行します。以下の例では npx -y @dreamworkhq/mcp を使用します。

起動時にキーやアカウントは不要です。DREAMWORK_API_KEY が設定されていない場合、サーバーは無料のゲストモードで動作し、エージェントはすべての求人情報を検索して閲覧できます。以下の env ブロックは任意です。アカウント用ツールを使う場合はキーを追加してください（ゲストモードと API キーを参照）。

設定

Claude Desktop

claude_desktop_config.json（macOS の場合は ~/Library/Application Support/Claude/claude_desktop_config.json）にエントリを追加します。

{
  "mcpServers": {
    "dreamwork": {
      "command": "npx",
      "args": ["-y", "@dreamworkhq/mcp"],
      "env": {
        "DREAMWORK_API_KEY": "sk_..."
      }
    }
  }
}

編集後、Claude Desktop を再起動してください。認証情報は env ブロックに記述します。command をシェルや dotenvx run -- … などの環境変数ローダーでラップしないでください。stdio サーバーでは、ラッパーが標準出力に出力するバナーによって JSON-RPC ストリームが破損し、ツールの呼び出しがハングすることがあります。

Cursor およびその他のクライアント

stdio MCP クライアントならどれでも動作します。Cursor では上記と同じ設定を使用します。コマンドに npx -y @dreamworkhq/mcp を指定し、環境変数として DREAMWORK_API_KEY を渡してください。Inspector で設定を確認するには、次のようにします。

DREAMWORK_API_KEY=sk_... npx @modelcontextprotocol/inspector npx -y @dreamworkhq/mcp

ホステッドエンドポイント

Dreamwork は Streamable HTTP 経由でも、これらのツールを https://mcp.dreamworkhq.com/mcp で提供しています。claude.ai、Claude Desktop、または ChatGPT で、この URL をカスタムコネクターとして追加し、Dreamwork にサインインしてください。インストールもキーの貼り付けも不要です。同意画面で、コネクターに付与するスコープを選択します。

リクエストヘッダーを設定できるクライアントでは、代わりに同じ URL に API キーを送信できます。Claude Code の場合は次のとおりです。

claude mcp add --transport http dreamwork https://mcp.dreamworkhq.com/mcp \
  --header "Authorization: Bearer sk_..."

ゲストモードと API キー

ゲストモードは無料で、アカウントも不要です。キーを設定せずに起動すると、サーバーはゲストモードで動作し、公開されている読み取り専用ツール browse_listings、get_listing、get_platform_context、get_upgrade_link を利用できます。サーバーはエージェントにゲストモードであることを伝えるため、エージェントは現在利用できる機能を案内できます。アカウント用ツールは、キーの取得手順を示す短い「No API key」メッセージを返します。

ホステッドエンドポイントでも、ハンドシェイクに同じ動作が適用されます。サインインなしで initialize と tools/list が成功し、上記の 4 つのツールを実行できます。すべてのアカウント用ツールと、その他のすべてのメソッドは WWW-Authenticate ヘッダー付きで 401 を返すため、コネクターは OAuth でサインインできます。API に拒否されたベアラーも同じ 401 を返します。

API キーの取得には無料アカウントが必要です。履歴書に基づく求人のランキング、保存した求人、応募に合わせた資料、選考状況、採用担当者からのメール、応募には API キーが必要です。無料プランを含め、どの Dreamwork アカウントでもキーを生成できます。プランによって、キーのレート制限と利用枠が決まります。 dreamworkhq.com にサインインし、Profile を開いてから MCP を選択します（または Agents ページの Get a key ボタンを使用します）。次に、キー（形式は sk_...）を DREAMWORK_API_KEY として設定し、MCP クライアントを再起動してください。

キーを生成するときに、許可する操作として、読み取り、書き込み、応募、メール送信を選択できます。プロフィールページでは、最初は 4 つすべてが選択されています。エージェントに許可したくない操作は選択を解除してください。キーに許可できるのは、あなた自身に許可されている範囲以下であり、それを超えることはありません。

環境変数

変数	必須	デフォルト	用途
DREAMWORK_API_KEY	アカウント用ツールの場合	なし	API キー（sk_...）。パイプライン、履歴書、応募、アウトリーチ、プロフィール、面接を利用できます。
DREAMWORK_API_URL	いいえ	https://api.dreamworkhq.com	API エンドポイントを上書きします（ローカル開発／セルフホスト）。
DREAMWORK_UNREAD_NOTICES	いいえ	オン	off（または 0／false／no）にすると、未読の採用担当者からのメールに関する通知がツールの結果に含まれなくなります。確認は5分ごとに最大1回です。確認してもメールは既読になりません。

JOBLESS_API_TOKEN と JOBLESS_API_URL は、後方互換性のあるエイリアスとして引き続き利用でき、それぞれ DREAMWORK_API_KEY と DREAMWORK_API_URL に対応します。新しい設定では DREAMWORK_ で始まる名前を使用してください。

テレメトリ

使用状況を測定するため、サーバーは初回実行時に匿名のランダムなインストール ID（UUID）を生成し、OS の状態ディレクトリに保存します（Linux/macOS では $XDG_STATE_HOME/dreamwork/install-id または ~/.local/state/dreamwork/install-id、Windows では %LOCALAPPDATA%\dreamwork\install-id）。この値はランダムで、ホスト名、ユーザー名、その他のマシン属性から導出されることはありません。ゲスト（未認証）利用のユニークなインストール数を集計します。ビルド時や公開時ではなく、実行時にお使いのマシン上で書き込まれます。

次の環境変数のいずれかを設定すると、オプトアウトできます。

• DREAMWORK_TELEMETRY=0（または false／no／off）
• DO_NOT_TRACK=1（標準のオプトアウト設定。true／yes／on も使用できます）

テレメトリが無効の場合、インストール ID は生成、読み取り、送信されません。

ツール

一般的な流れは、公開インデックスを閲覧し、求人をパイプラインに保存して、応募書類を調整し、応募した後、返信や面接の状況を追跡することです。まず get_platform_context を呼び出してください。Dreamwork でできることが説明されているため、エージェントは適切なワークフローを選べます。

公開（キー不要）：

browse_listings、get_listing、get_market_pulse、get_platform_context、get_top_hiring_companies、get_upgrade_link

アシスタントのアクション： Dreamwork のアシスタントレジストリには機能ごとにツールが1つずつあり、いずれもサイト上のアシスタントと同じ認可手順とレシート台帳を通じて実行されます。重要な操作を伴うツールは、初回の呼び出しでは保留となり、概要と confirmationToken を返します。実行するには、同一の引数でそのトークンを返送してください。

apply、cancel_apply、confirm_hypothesis、dismiss_match、edit_answer、edit_cover_letter、edit_resume、forget_hypothesis、format_resume、generate_pack、get_application_documents、get_application_readiness、get_application_status、get_autopilot_settings、get_autopilot_status、get_career_record、get_communication_preferences、get_inbox、get_job、get_pack_status、get_pipeline、get_preferences、get_resume_download_link、get_resume_work_history、get_task、get_unread_reminders、get_updates_since、get_usage、import_job、list_dismissed_matches、list_matches、list_tasks、mark_applied_offsite、mark_messages_read、move_pipeline、parse_preferences_text、prepare_applications、remember_hypothesis、replace_application_document、reply_to_recruiter、restore_match、restore_material、save_application_answers、save_job、set_autopilot、start_checkout、strengthen_application、undo_last、update_autopilot_settings、update_communication_preferences、update_preferences

製品の直接ツール： レジストリアクションに紐付いていないルートです。

add_contact、add_jobs、generate_outreach、generate_resume、get_application_materials、get_generated_resumes、get_profile、get_stats、list_contacts、list_interviews、reopen_application_materials、update_application_materials、update_profile、upload_resume

このサーバーは5つのプロンプトも提供しており、Claude Desktop や Claude Code などのホストではコマンドとして表示されます：morning_brief（前回の確認以降の変更点）、find_and_prepare（検索、選択、応募書類の準備）、 apply_to_prepared（不足している回答を補い、確認してから、確認を経て応募）、interview_prep、autopilot_setup。

いくつかのツールに関する注意事項：

• どのツールも、初回の呼び出しではメールを送信したり、応募を送信したりしません。apply、 reply_to_recruiter、set_autopilot、update_autopilot_settings、start_checkout は概要と confirmationToken を返して held 状態となり、同一の引数でそのトークンを返送した場合にのみ実行されます。
• 1.3.0 では、レジストリアクションに置き換えられた 1.2.0 のツール、search_jobs と list_applications（get_pipeline を使用してください。インデックスの検索には browse_listings を使用します）、apply_to_job（apply）、add_listing_to_pipeline（save_job）、 skip_job（dismiss_match）、send_outreach が削除されました。返信と再応募には reply_to_recruiter と apply を使用します。
• 1.5.1 より後のリリースには list_escalations と resolve_escalation は含まれておらず、ホスト型サーバーでも提供されなくなりました。Dreamwork は応募をエスカレーションとしてユーザーに差し戻さなくなったため、一覧表示したり解決したりする対象はありません。
• update_application_materials と reopen_application_materials は、API が認める Applications ロールアウト対象者が利用できます。対象外の場合は、API 自身の拒否が返されます。
• get_stats はサインイン中の候補者本人のパイプラインを集計するため、ほかのツールと同様にキーが必要です。

主なスコープ

API キーにはスコープが設定されており、生成時に選択します。

スコープ	利用できる操作
read	すべての読み取り操作：マッチ、パイプライン、受信トレイ、ステータス、使用状況、領収書
write	負荷が小さく、キューに入る書き込み操作：保存、非表示、移動、資料の編集、設定、チェックアウトリンク
apply	応募の送信、送信中の応募のキャンセル、自動操縦
send	採用担当者へのメール送信

スコープは、直接ルートを含むすべての操作経路を制限します。 write は何かを変更するための最低限の権限です。このスコープのないキーは、 GET、HEAD、OPTIONS 以外のリクエストをすべて拒否されます。そのため、読み取り専用の キーでルートを直接呼び出してプロフィールを書き換えたり、ボード上の項目を移動したりすることはできません。apply のないキーは、apply と POST /jobs/:id/apply、ターボ応募ルート、エスカレーションルートで拒否されます。send のないキーは、reply_to_recruiter、 POST /outreach/send、POST /conversations/:id/reply で拒否されます。直接呼び出した場合は、 api_key_scope_required と、必要なスコープおよび次の手順を示すメッセージを含む 403 が返されます。 アシスタントの操作では、同じ次の手順を示す action_not_authorized が返されます。

キーでは、キーの管理、セッショントークンのローテーション、アカウントの削除はできません。 キーがどのスコープを持っていても、これらの操作では 403 session_required が返されます。

プロフィールページでは 4 つすべてのスコープがあらかじめ選択されます。また、スコープを指定しないキーリクエストには、read と write が設定されます。スコープが導入される前に作成されたキーでは、従来可能だった操作をすべて引き続き実行できます。

トラブルシューティング

• ツール呼び出しがハングする／タイムアウトするが、ハンドシェイクは成功する。 stdout に JSON-RPC 以外のバイト列を書き込んでいるものがあります。command が、起動メッセージを表示する env ローダーやシェルでラップされていないことを確認し、最新バージョンに更新してください （npx -y @dreamworkhq/mcp@latest。古いビルドがキャッシュされている場合は、rm -rf ~/.npm/_npx で npx キャッシュをクリアしてください）。stdout にはプロトコルフレームのみを出力する必要があります。サーバーのログはすべて stderr に出力されます。
• すべてのアカウントツールで「No API key」と表示される。 DREAMWORK_API_KEY が プロセスに渡されていません。クライアント設定の env ブロックに設定されていることを確認してください。
• すべてのアカウントツールで「API key rejected」と表示される。 キーはサーバーに届いていますが、有効期限が切れているか、取り消されています。Profile の MCP で新しいキーを作成し、 DREAMWORK_API_KEY を置き換えてから、MCP クライアントを再起動してください。
• Apply で missing_onboarding_fields または missing_profile_fields が返される。 ツールは、不足しているフィールドと、それぞれを修正する Dreamwork 内の場所を報告します。再試行する前に、Dreamwork で必要な情報を入力してください。失敗したリクエストによって応募が開始されることはありません。

開発

pnpm --filter @dreamworkhq/mcp check   # typecheck
pnpm --filter @dreamworkhq/mcp build   # emit dist/
pnpm --filter @dreamworkhq/mcp test    # unit tests

stdio エントリーポイントは src/stdio.ts にあり、ツール定義は src/mcp.ts に、HTTP API クライアントは src/client.ts にあります。

サーバーはプロセス環境からのみ設定を読み込みます。.env ファイルは 読み込みません。ローカル開発では、シェルで変数をエクスポートしてください（例： DREAMWORK_API_URL=http://127.0.0.1:3000 pnpm --filter @dreamworkhq/mcp stdio）。

パッケージ境界の判断、ツール登録の規約 （registerDreamworkTool）、エラー／バージョニングのルール、レビューを後回しにする条件は ARCHITECTURE.md に記録されています。上記のツールカタログと登録済みツールの差異は、 test/tool-catalog.test.ts で検出されます。

ライセンス

MIT