Landed

---

これは何ですか？

Landed MCP は、AI ネイティブな職種（AI エンジニア、ML エンジニア、RAG エンジニア、AI プロダクトマネージャー、GTM エンジニアなど）を厳選し、継続的に更新しているデータに AI アシスタントを接続します。求人サイトの内容をチャットにコピー＆ペーストする代わりに、エージェントは次のことができます。

• 🔎 求人を検索 — 職種、スキル、経験年数、リモート勤務、報酬、業界などの構造化された条件、または自然な文章による説明に基づいて、ランキング付けと適合度スコアリングを行います。
• 📝 応募を準備 — 求人の実際の応募フォームを取得し、標準項目、スクリーニング項目、EEO 項目に分類して、応募前にエージェントが自動入力し、回答案を作成できるようにします。
• 🎓 面接対策 — 無料で厳選された面接対策、ポートフォリオ、ロードマップのリソースを取得します。

Streamable HTTP を使用しており、あらゆる MCP クライアントで動作します。ホスト型サーバーならすぐに利用でき、このリポジトリを独自の Landed API に接続してセルフホストすることもできます。

無料で始められます。 匿名ユーザーには、サインアップもキーも不要の共有無料利用枠が提供されます。API トークンを追加すると、無制限でパーソナライズされた結果を利用できます。

---

クイックスタート（ホスト型）

ホスト型サーバーの場所：

https://mcp.landed.jobs/mcp

以下からクライアントを選択してください。すべて匿名でそのまま動作するため、Authorization ヘッダーを省略してください。無制限の検索や条件に合わせた検索には、Authorization: Bearer lnd_live_… を追加してください（Landed → Settings → API tokens で発行できます）。

Claude Code

ワンライナー（CLI）：

# Anonymous (free tier)
claude mcp add --transport http landed-jobs https://mcp.landed.jobs/mcp

# Authenticated (unlimited, personalized)
claude mcp add --transport http landed-jobs https://mcp.landed.jobs/mcp \
  --header "Authorization: Bearer lnd_live_your_token_here"

セッションで /mcp を実行して接続を確認し、find_jobs プロンプトを試してください。

Claude Desktop

Settings → Developer → Edit Config を開き（claude_desktop_config.json が開きます）、次を追加します。

{
  "mcpServers": {
    "landed-jobs": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "https://mcp.landed.jobs/mcp",
        "--header", "Authorization: Bearer lnd_live_your_token_here"
      ]
    }
  }
}

Claude Desktop を再起動します。無料の匿名利用枠では、--header の行を削除してください。

Claude Desktop は mcp-remote を介してリモート HTTP サーバーに接続します。 お使いのビルドにネイティブの Custom Connectors（Settings → Connectors → Add custom connector）がある場合は、 代わりに https://mcp.landed.jobs/mcp を直接貼り付けることができます。

Cursor

プロジェクト内に .cursor/mcp.json を作成します（全体設定の場合は ~/.cursor/mcp.json）。

{
  "mcpServers": {
    "landed-jobs": {
      "url": "https://mcp.landed.jobs/mcp",
      "headers": { "Authorization": "Bearer lnd_live_your_token_here" }
    }
  }
}

Settings → MCP で landed-jobs を有効にします。無料利用枠では headers を省略してください。

VS Code（GitHub Copilot / Agent Mode）

.vscode/mcp.json を作成します。

{
  "servers": {
    "landed-jobs": {
      "type": "http",
      "url": "https://mcp.landed.jobs/mcp",
      "headers": { "Authorization": "Bearer lnd_live_your_token_here" }
    }
  }
}

Chat ビューを開き、Agent モードにすると、🔧 ピッカーにツールが表示されます。

Windsurf

~/.codeium/windsurf/mcp_config.json を編集します。

{
  "mcpServers": {
    "landed-jobs": {
      "serverUrl": "https://mcp.landed.jobs/mcp",
      "headers": { "Authorization": "Bearer lnd_live_your_token_here" }
    }
  }
}

Cline（VS Code 拡張機能）

Cline → MCP Servers → Configure を開くか、cline_mcp_settings.json を編集します。

{
  "mcpServers": {
    "landed-jobs": {
      "type": "streamableHttp",
      "url": "https://mcp.landed.jobs/mcp",
      "headers": { "Authorization": "Bearer lnd_live_your_token_here" }
    }
  }
}

Gemini CLI

~/.gemini/settings.json（またはプロジェクト内の .gemini/settings.json）を編集します。

{
  "mcpServers": {
    "landed-jobs": {
      "httpUrl": "https://mcp.landed.jobs/mcp",
      "headers": { "Authorization": "Bearer lnd_live_your_token_here" }
    }
  }
}

gemini を再起動し、/mcp を実行してツールを確認します。無料枠では headers を省略してください。

その他の MCP クライアント

Streamable HTTP トランスポートを使用して、https://mcp.landed.jobs/mcp に接続します。 トークンをお持ちの場合は、Authorization: Bearer <token> を渡してください。ターミナルから簡単に動作確認するには、次のコマンドを実行します。

curl -s -X POST https://mcp.landed.jobs/mcp \
  -H 'content-type: application/json' \
  -H 'accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

レジストリ

Landed は Official MCP Registry に io.github.landedjobs/landed として、また Smithery に landedjobs/landed として登録されています。どちらかのレジストリを参照するクライアントは、手動で設定しなくても Landed を検出してインストールできます。

---

ツール

ツール	機能	匿名利用時のコスト
search_jobs	ランク付けされ、適合度スコアが付いた求人を検索します。物理的な都市名・国名と、リモート勤務の対象国・地域を示す標準コードに対応しています。自由記述はサーバー側で解析されます。	1 単位／返された求人
get_job_form	jobId の応募フォームを、回答準備用に standard／screening／eeo のグループに分けて取得します。	無料
get_learning_content	厳選された面接対策、ポートフォリオ、ロードマップのリソースを取得します。	無料

プロンプト（ガイド付きワークフロー）

MCP プロンプトは、ツールを連携して使い、結果を生の JSON ではなく、見やすい候補リストとして提示する方法をエージェントに教える、再利用可能でユーザーが呼び出せるスキルです。ほとんどのクライアントでは、スラッシュコマンドとして表示されます。

プロンプト	引数	ガイドする内容
find_jobs	describe?	求人を検索し、ランク付けと適合度スコアを付けた候補リストと、次のステップを提示します。
prepare_application	jobId	応募フォームを取得し、standard を自動入力して、screening の回答案を作成し、eeo はユーザーに委ねます。
prep_for_role	role?	職種に合わせて学習リソースを取得し、学習順を提案します。

サーバーには、常時有効な instructions（ツールの概要、結果の提示ルール、フリーミアムの動作）も含まれており、準拠クライアントはこれを自動的に読み込みます。

場所のパラメーター

勤務地の適格性は、キーワード照合ではなく、構造化された情報として扱われます。

• locations：物理的な都市名・国名。都市名が曖昧な場合は国名も含めます。例：["Bengaluru, India"]
• countryCodes：リモート勤務または勤務地の適格性を示す ISO alpha-2 コード。例：["IN"]
• regionCodes：apac、emea、americas
• workAuthorizationCountryCodes：就労許可のある国を示す ISO alpha-2 コード
• remote：勤務形態（remote、hybrid、onsite）

ホストされた API は、人間が読める都市名を安定した場所 ID に解決します。呼び出し側で場所 ID を作り出してはいけません。互換性のため、従来の regions フィールドも引き続き使用できます。

---

認証と料金

ティア	方法	利用できる内容
匿名	ヘッダーなし	毎日 00:00 UTC にリセットされる、無料の求人ユニット枠。IP アドレスと発行された X-Landed-Anon トークンを組み合わせて使用量を計測します（トークンはすべてのレスポンスで返されます。セッションをまたいで枠を維持するには、再送してください）。
認証済み	Authorization: Bearer lnd_live_…	保存済みの希望条件とプロフィールに基づく、無制限の検索。Landed → Settings → API tokens でトークンを発行できます。

すべての結果には freemium ブロックが含まれており、エージェントは残りの枠と上限を解除する方法を確認できます。

---

アーキテクチャ

このリポジトリは、薄型でセルフホスト可能なプロキシです。MCP として動作し、ホストされた Landed API にリクエストを転送します。データベース、ランキングエンジン、求人データは一切保持しません。

   MCP client                 landed-mcp (this repo)              Landed API
 ┌─────────────┐   HTTP    ┌────────────────────────┐  HTTPS   ┌────────────────────────┐
 │ Claude /    │ ───────▶  │ • MCP protocol + tools │ ──────▶  │ • search engine        │
 │ Cursor /    │  /mcp     │ • forwards caller creds│          │ • job corpus + forms   │
 │ VS Code …   │ ◀───────  │ • local learning list  │ ◀──────  │ • auth · freemium meter│
 └─────────────┘           └────────────────────────┘          └────────────────────────┘

プロキシ自体は何も解決しません。呼び出し側の API トークン（または匿名 ID）を Landed API に転送し、Landed API がトークンを検証して検索を実行し、使用量を計測したうえで、結果と freemium ブロックを返します。プロキシはこれをそのまま中継します。get_learning_content のカタログは静的で、このリポジトリ内にあります（src/mcp/catalog/learning.ts）。このツールはバックエンドがなくても動作します。

---

セルフホスト

Landed API（またはその独自デプロイ）に接続して、独自のプロキシを実行します。

前提条件

• Node.js ≥ 20
• pnpm（npm i -g pnpm）
• Landed API のベース URLと共有内部シークレット

実行

git clone [email protected]:landedjobs/landed-mcp.git
cd landed-mcp
pnpm install
cp .env.example .env       # then fill in the values below
pnpm dev                   # hot-reload dev server
# → [mcp] listening on :8090 — POST /mcp → https://api.landed.jobs/api/v1

本番環境では、pnpm start を実行します。

Stdio と Docker

サーバーをプロセスとして起動するクライアント向けに、pnpm start:stdio は HTTP ではなく stdio 経由で MCP を使用します。独自の API トークンを使用するには LANDED_API_TOKEN を設定してください。設定しない場合は、匿名の無料利用枠が適用されます。

docker build -t landed-mcp .
docker run -i --rm landed-mcp

このイメージは、ホストされた API に対して stdio サーバーを実行します。

環境変数

変数	必須	デフォルト	説明
LANDED_API_BASE	✓	http://localhost:8000/api/v1	ホストされた Landed API のベース URL。/api/v1 プレフィックスを含めて指定します。
LANDED_INTERNAL_SECRET	✓	—	このプロキシを API に対して認証する共有シークレット（サーバーの INTERNAL_SERVICE_SECRET と一致する必要があります）。
PORT		8090	リッスンする HTTP ポート。
CORS_ORIGINS		*	許可するオリジンのカンマ区切りリスト、または *。
RATE_LIMIT_PER_MIN		60	IP ごとの一次リクエスト上限。実際の経済的な上限は、API のフリーミアム利用量です。

エンドポイント

メソッド	パス	用途
POST	/mcp	MCP Streamable HTTP エンドポイント（ステートレス）。
GET	/healthz	生存確認プローブ（{ "ok": true }）。

---

開発

pnpm dev           # watch + reload
pnpm check-types   # tsc --noEmit
pnpm test          # deterministic input-contract tests
pnpm start         # run once

このリポジトリには、server.json に公式 MCP Registry のメタデータが含まれています。これは公開 Streamable HTTP エンドポイントを記述するものであり、サーバーが外部レジストリに登録申請された、または承認されたことを意味するものではありません。

プロジェクト構成

src/
├── index.ts                 # bootstrap: start the HTTP server
├── config/                  # env → typed config
├── http/                    # express shell + per-IP rate limiter
├── services/api-client.ts   # typed fetch client → Landed API
├── types.ts                 # the API response contract (owned here)
└── mcp/
    ├── server.ts            # instructions + tool/prompt registration
    ├── prompts.ts           # find_jobs / prepare_application / prep_for_role
    ├── catalog/learning.ts  # static, public learning resources
    └── tools/               # search_jobs · get_job_form · get_learning_content

スタック：TypeScript · Express · @modelcontextprotocol/sdk · Zod。データベースはなく、ビルド手順もありません（tsx で実行します）。

---

コントリビューション

Issue や PR を歓迎します。特に、バグ修正、新しいクライアント設定ガイド、学習カタログへの追加を歓迎します。 PR を作成する前に、pnpm check-types と pnpm test を実行してください。非公開の脆弱性レポートについては、 SECURITY.md に従ってください。

ライセンス

MIT © Landed