Laddro Career

@laddro/career-mcp

Laddro Career API 用の MCP サーバーです。AI エージェントが履歴書のカスタマイズ、カバーレターの生成、PDF エクスポート、テンプレートの閲覧を利用できます。

セットアップ

Claude Desktop

claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "laddro-career": {
      "command": "npx",
      "args": ["@laddro/career-mcp"],
      "env": {
        "LADDRO_API_KEY": "laddro_live_..."
      }
    }
  }
}

Claude Code

claude mcp add laddro-career -- npx @laddro/career-mcp

実行する前に環境変数 LADDRO_API_KEY を設定してください。

リモート HTTP

ホストされている Streamable HTTP エンドポイントを使用します。

https://mcp.laddro.com/mcp

MCP の初期化リクエストで Laddro API キーを送信します。

Authorization: Bearer laddro_live_...

または：

x-api-key: laddro_live_...

利用可能なツール

ツール	説明
laddro.templates.list	22 種類すべての履歴書テンプレートを閲覧します
laddro.templates.get	テンプレートの色とフォントを取得します
laddro.fonts.list	利用可能なすべてのフォントファミリーを取得します
laddro.languages.list	サポートされている 14 種類すべてのロケールを取得します
laddro.resumes.list	ユーザーの履歴書を取得します
laddro.resumes.get	履歴書のメタデータを取得します
laddro.resumes.render	新しいテンプレート設定で再レンダリングします
laddro.resumes.tailor	求人に合わせて履歴書を AI でカスタマイズします
laddro.resumes.export	PDF としてエクスポートします
laddro.coverLetters.list	ユーザーのカバーレターを取得します
laddro.coverLetters.get	カバーレターのメタデータを取得します
laddro.coverLetters.create	手動で作成します
laddro.coverLetters.generate	履歴書と求人情報から AI で生成します
laddro.coverLetters.render	テンプレート設定でレンダリングします

コネクター（OAuth）モード

MCP_CONNECTOR_ENABLED フラグ（デフォルトではオフ）で制御します。有効にした状態で、リクエストに Authorization: Bearer lad_at_*（Laddro OAuth アクセストークン）が含まれている場合、サーバーは OAuth コネクターセッションを実行し、career-api ではなくトークンを laddro-backend（service.laddro.com）に転送します。また、GET /.well-known/oauth-protected-resource（RFC 9728）を提供し、認証されていない /mcp 呼び出しには 401 + WWW-Authenticate: Bearer resource_metadata=... で応答することで、OAuth クライアントが認可サーバーを検出できるようにします。フラグがオフの場合、動作は変わりません（検出ルートなし、401 による強制なし、career-api 経由ですべての 18 個のツールを利用可能）。

コネクターツール（OAuth セッションのみ）：「コンテンツはあなたが作成します。Laddro が保存して PDF をレンダリングします。」

ツール	スコープ	説明
laddro.resume.schema	—	履歴書コンテンツ用の JSON Schema
laddro.resume.create	resumes:write	履歴書を作成し、{ resumeId } を返します
laddro.resume.update	resumes:write	履歴書を全置換し、{ resumeId, updatedAt } を返します
laddro.coverLetter.schema	—	カバーレターコンテンツ用の JSON Schema

環境変数

変数	必須	説明
LADDRO_API_KEY	stdio では必須、HTTP では任意のフォールバック	Laddro API キー
LADDRO_BASE_URL	いいえ	API URL を上書きします（デフォルト：https://api.laddro.com）
MCP_CONNECTOR_ENABLED	いいえ	true にすると OAuth コネクターモードが有効になります（デフォルトではオフ）
LADDRO_BACKEND_URL	いいえ	コネクターツールのバックエンドベース URL（デフォルト：https://service.laddro.com）
MCP_PUBLIC_URL	いいえ	OAuth メタデータ用のこのサーバーの公開 URL（未設定の場合、転送ヘッダーから導出されます）

開発

npm ci
npm test

npm test は TypeScript パッケージをビルドし、認証処理、ツールのメタデータ、ハンドラーのルーティングに関する MCP コントラクトテストを実行します。

リリース

このパッケージでは Changesets と SemVer を使用しています。

• パッチ：バグ修正、ドキュメント、テスト、内部の強化。
• マイナー：後方互換性のある MCP ツールまたは機能の追加。
• メジャー：ツール名、スキーマ、認証、またはトランスポート動作における破壊的変更。

公開パッケージを変更するすべての PR には、Changeset を含めてください。

npm run changeset

PR が main にマージされると、GitHub Actions がバージョン更新と変更履歴を含むリリース PR を作成します。そのリリース PR をマージすると、パッケージが npm に公開され、GitHub リリースが作成されます。Cloud Run のデプロイワークフローも main で実行されるため、リリースのマージ後にホストされている MCP が自動的に更新されます。

MCP レジストリ

このサーバーは、公式 MCP レジストリに com.laddro/career として登録されています。server.json はレジストリのマニフェストです。scripts/sync-version-metadata.mjs により、リリースごとに npm パッケージのバージョンと同期されます。

公開は自動化されています。.github/workflows/publish-registry.yml は、main 上でリリースによって server.json が変更されるたびに実行され、新しいバージョンをレジストリにプッシュします。認証は DNS ベースです。Ed25519 公開鍵は laddro.com の TXT レコードにあり、対応する秘密鍵（hex）はリポジトリのシークレット MCP_PUBLISHER_ED25519_KEY に保存されています。

手動で公開（または未公開分を反映）するには、次のようにします。

MCP_PUBLISHER_ED25519_KEY=<hex-private-key> ./scripts/publish-registry.sh

リンク

• laddro.com
• API リファレンス
• ドキュメント
• GitHub

ライセンス

MIT