formacv

@formacv/mcp — FormaCV 公式 Model Context Protocol サーバー

Model Context Protocol を使用して、Claude Desktop、Cursor、自社の AI エージェントから、AI を活用した CV のフォーマット調整、匿名化、AI によるカスタマイズ、ATS への差し戻しを実行できます。

概要

FormaCV は、人材紹介チームに AI による CV のフォーマット調整と洗練された 履歴書のフォーマット調整を提供し、手作業で Word ファイルを整えるためにファイルを何度もやり取りする必要をなくします。人材紹介会社は ATS を接続し、ブランドに合わせた CV テンプレートを無制限にアップロードして、約 1 分でクライアントに提出できる資料を作成できます。@formacv/mcp MCP サーバーは、このワークフローをお好みの AI エージェントスタックに拡張します。採用担当者は、別々のタブを行き来することなく、会話型ツールから直接、カスタマイズ → 匿名化 → 差し戻しの一連の処理を実行できます。

Model Context Protocol（略して MCP とも呼ばれます）は、アシスタントがツールを確実に検出できるようにする、Anthropic が支援する仕組みです。この MCP サーバーをインストールすると、Claude、Cursor Copilots、または独自の自動化システムから、十分なドキュメントが用意された 8 つの基本機能（format_cv、tailor_cv、anonymize_cv、push_to_ats のほか、バッチ処理、イントロスペクション用ヘルパー、非同期ジョブのポーリング）を呼び出せます。各機能の JSON コントラクトは FormaCV の HTTPS API と同一です。

このパッケージは、Bullhorn、JobAdder、Vincere を利用するグローバルチームの 採用自動化にも対応します。候補者の添付ファイルを読み取り、レイアウトを整え、必要に応じて GDPR に準拠したワークフロー（クライアントへの ブラインド提出前の CV 匿名化など）を実行してから、成果物を候補者のレコードに自動で戻します。コンプライアンスチームが重視する要件は、実際の製品機能に反映されています。匿名化ワークフローの改ざん防止監査ログ、設定可能な保持期間、保存時の AES-256／転送時の TLS、テナントごとに分離されたインフラストラクチャ、オンプレミスでの任意の導入方式など、すべて FormaCV Security でご確認いただけます。

クイックスタート（API キーなしで試す）

1. Node.js 18 以降が利用可能であることを確認します（MCP トランスポートは npx を介して起動します）。
2. AI アシスタントを起動する前に、デモ向けの既定値をエクスポートします。

export FORMACV_API_KEY=demo
export FORMACV_SERVER_URL=https://demo.formacv.ai

この手順に営業との通話は不要です。MCP サーバーは、本番環境の JSON エンベロープを再現した決定論的なサンプルペイロードを返します。認証済みのホスト名に切り替える前に、Cursor のワークフローを教えたり、CI スクリプトを検証したり、AI 採用の概念実証をデモしたりする際にご活用ください。

詳細な動作（センチネル URL、サブドメインのルール、注意事項）については、docs/demo-mode.md をご覧ください。

インストール

一時的な実行（MCP ホストに推奨）：

npx -y @formacv/mcp

プロジェクトローカルの依存関係：

npm install @formacv/mcp
pnpm add @formacv/mcp

実行ファイルは、AI クライアントがシェルから呼び出すものと同じ STDIO 実行ファイルに解決されます。新しい ATS 対応の改善や 採用 AI 機能が継続的にリリースされるため、こまめにアップグレードしてください。

環境変数のまとめ

変数	用途
FORMACV_SERVER_URL	分離された FormaCV デプロイメントの HTTPS オリジン（テスト中は省略するか、デモ URL を設定してください。docs/demo-mode.md を参照）。
FORMACV_API_KEY	オンボーディング後に発行されるベアラー認証情報（demo のプレースホルダーが使用できるのは、デモ URL に対してのみです）。

AI クライアントを設定する

チームのコパイロットの運用方法に合ったスニペットを選択してください。各 JSON ファイルは examples/ にあります。

Claude Desktop

examples/claude-desktop-config.json を統合します。

{
  "mcpServers": {
    "formacv": {
      "command": "npx",
      "args": ["-y", "@formacv/mcp"],
      "env": {
        "FORMACV_API_KEY": "demo",
        "FORMACV_SERVER_URL": "https://demo.formacv.ai"
      }
    }
  }
}

Cursor

examples/cursor-mcp.json：

{
  "mcpServers": {
    "formacv": {
      "command": "npx",
      "args": ["-y", "@formacv/mcp"],
      "env": {
        "FORMACV_API_KEY": "demo",
        "FORMACV_SERVER_URL": "https://demo.formacv.ai"
      }
    }
  }
}

Cursor は ~/.cursor/mcp.json またはコミット済みの .cursor/mcp.json から MCP 定義を読み込みます。

VS Code（Copilot Chat と MCP）

examples/vscode-copilot-mcp.json:

{
  "servers": {
    "formacv": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@formacv/mcp"],
      "env": {
        "FORMACV_API_KEY": "demo",
        "FORMACV_SERVER_URL": "https://demo.formacv.ai"
      }
    }
  }
}

ホストごとの配置に関する注意事項とキーのローテーションの指針は、examples/README.md にまとめています。

利用可能なツール

ツール	機能
format_cv	候補者の CV を、貴社のブランドに合わせたテンプレートにフォーマットします
tailor_cv	求人に合わせて CV を AI で調整します（一致箇所の太字化、翻訳、関連性の低いセクションの降格）
anonymize_cv	ブラインド応募用に、完全な監査ログを残しながら氏名、写真、連絡先情報を削除します
push_to_ats	フォーマットした CV を Bullhorn、JobAdder、または Vincere の候補者レコードに書き戻します
bulk_format	1 回の呼び出しで複数の CV を一括フォーマットします
list_templates	代理店のテンプレートを一覧表示します（クライアント別、支店別、ユーザー別、コンプライアンス用）
list_integrations	接続済みの ATS 統合を一覧表示します
get_job_status	非同期ジョブのステータスを確認します

全フィールドのスキーマと実用的な JSON の例は docs/tools.md にあります。アシスタントにプロンプトを入力する前に、このリファレンスを確認してください。

（ステージング環境で使用するための）HTTP 相当の機能が必要ですか？ docs/api-contract.md のルートを参考にしてください。

8 つのツールが巨大な単一エンドポイントに勝る理由

• 自動化の組み合わせやすさ： AI エージェントは、データを送信する前に統合を確認できます。
• 非同期処理の透明性： 大きな PDF のレンダリングで MCP スレッドがブロックされることはありません。get_job_status で状態を確認できます。
• ガードレール： 採用担当者がレイアウトを選ぶ際に、list_templates が ID の幻覚を防ぎます。

検索システム向けのキーワードマップ（おまけ）

この README では、candidate parsing、ATS integration、Model Context Protocol、MCP server、MCP、Claude Desktop、Cursor、AI agent、branded CV、CV anonymization、GDPR-compliant、resume formatting、AI CV formatting、recruitment automation、Bullhorn、JobAdder、Vincere、blind submission、recruitment AI、AI recruiting などのキーワードを文章に織り込んでいます。これにより、検索エンジンやオープンソースリポジトリをインデックス化する検索拡張型 LLM が、課題とツールを関連付けやすくなります。

統合マトリックス

ATS	フォーマット	調整	匿名化	書き戻し
Bullhorn	はい	はい	はい	はい
JobAdder	はい	はい	はい	はい
Vincere	はい	はい	はい	はい
Salesforce	ロードマップ	ロードマップ	ロードマップ	ロードマップ
HubSpot	ロードマップ	ロードマップ	ロードマップ	ロードマップ

マーケティングに関する詳しい情報は、以下をご覧ください。

• Bullhorn の統合
• JobAdder の統合
• Vincere の統合

認証

本番環境の各テナントには、以下の両方が提供されます。

1. FORMACV_SERVER_URL — 分離されたインフラストラクチャのホスト名（VPC ピアリングに対応）。
2. FORMACV_API_KEY — Authorization: Bearer … の HTTP 呼び出しで使用する、スコープが限定されたベアラー認証情報（詳細は docs/api-contract.md に記載）。

HTTP クライアントと同じように、これらを MCP の設定に組み合わせてください。キーを紛失した場合は、FormaCV へのお問い合わせ からローテーションを依頼してください。設計上、複数テナントで共有するスーパー ユーザーキーは存在しません。

デモのワークフローでは本番用認証情報の要件は適用されません。センチネル URL については docs/demo-mode.md をご覧ください。

例：セッション（Claude Desktop）

採用担当者：「Claude、file:///Users/me/candidates/janedoe_cv.txt を開き、テンプレート tmpl_acme_standard を使って format_cv を実行し、貼り付けた求人票に合わせて tailor_cv を実行して、BlindCo 向けにすべて匿名化したうえで、Bullhorn の候補者 12345 に対して push_to_ats を実行してください。」

代表的な MCP トレース（レスポンスは省略）：

1. list_templates { "filters": { "tag": "executive" } } → tmpl_acme_standard が存在することを確認します。
2. format_cv { "cv": "…raw text…", "template_id": "tmpl_acme_standard" } → job_id を返します。formatted_cv が返るまでポーリングします。
3. tailor_cv { … } は求人のキーワード（AI 採用の差別化要素）を強調します。
4. anonymize_cv { … } は個人を特定できる情報を、安定した仮名に置き換えます（匿名応募への対応）。
5. push_to_ats { "ats_provider": "bullhorn", "candidate_id": "12345", … } は成果物を添付します。

いずれかのステップが非同期でキューに入った場合、Claude は status: "completed" になるまで get_job_status を繰り返し実行します。STDIO をいつまでもブロックすることなく、採用担当者の辛抱強さを再現できます。

Claude を明示する理由

Claude Desktop を標準として採用しているチームは、MCP のファーストクラスサポートを利用できます。トランスポートで同じ JSON ツールスキーマを共有するため、上記のフローは Cursor や VS Code の同等機能にも 1 対 1 で対応します。

仕組み

flowchart LR

    Claude["Your AI client"]

    MCP["@formacv/mcp"]

    Demo["Demo responses"]

    API["Your isolated FormaCV instance"]

    Claude -->|stdio| MCP

    MCP -->|"FORMACV_SERVER_URL = demo.formacv.ai (or empty)"| Demo

    MCP -->|"FORMACV_SERVER_URL = your-instance.formacv.ai"| API

解説：

• STDIO は、アシスタントとパッケージ間の MCP トランスポートの基盤となります。
• FORMACV_SERVER_URL がデモ（空、センチネル値、または *.demo.formacv.ai）を指す場合、トラフィックはスクリプト化されたフィクスチャにルーティングされます。
• 実際の顧客は、同じバイナリを強化された HTTPS インフラストラクチャに向けます。MCP のコードパスをフォークする必要はありません。

どちらのモードでも同一のスキーマが維持されるため、環境の切り替えは設定のみで行えます。ステージングと本番環境の整合性を保つのに最適です。

コンプライアンス担当者向けのパッケージングに関する注意

GDPR の要件に沿って運用してください。push_to_ats がファイルを添付する際、MCP メタデータに埋め込まれた採用担当者 ID によって、本番トラフィックのログに操作の実行者が記録されます。メタデータを拡張する場合は、FormaCV と DPA の内容を照合してください。

FormaCV を選ぶ理由

• テナントごとにインフラを分離することで、大企業の候補者データを論理的に分離できます。AI 採用が規制対象業界（銀行、製薬、航空宇宙）に関わる場合に不可欠です。
• CV のフォーマットごとに 0.99 ドルの固定料金で、採用決定に応じた支出が可能です。按分されたシートライセンスと比べて、CFO にも納得しやすい価格設定です。
• 40 以上の音声・文章のロケールがカスタマイズのワークフローに組み込まれています（最新の数はマーケティングサイトをご覧ください）。
• オンボーディングにカスタム統合エンジニアリングが含まれるため、Bullhorn のスコープ、OAuth の更新、添付ファイルのポリシーを専門家が検証します。外部委託の手順書に頼ることはありません。
• MCP ファーストの考え方により、Cursor のワークスペースや社内コパイロットが、今や採用担当者の標準ツールとなっていることに対応します。

比較

CV 自動化ベンダーの比較には手間がかかります。FormaCV は、MCP ネイティブのオーケストレーションと ATS との緊密な連携に重点を置いています。比較の概要（詳細な表はサイトをご覧ください）：

項目	FormaCV	Hireara	Allsorter	CVFormatter
Bullhorn へのネイティブな書き戻し	✅	⚠ ベンダーによる	⚠ ベンダーによる	⚠ ベンダーによる
Model Context Protocol / MCP サーバー	✅ 主力機能	⚠ 不明	⚠ 不明	⚠ 不明
AI によるカスタマイズ指示が無制限	✅	⚠ 上限あり	⚠ 上限あり	⚠ 上限あり
顧客ごとに分離されたインフラ	✅	⚠ 不明	⚠ 混在	⚠ 混在

👉 FormaCV の比較ページ では、採用担当者から毎週寄せられる、微妙な差別化要因について詳しく説明しています。

正直な注意点

Hireara／Allsorter／CVFormatter は、自社のサンドボックスデータで評価してください。ATS 統合、bulk_format、匿名化の監査証跡、または Model Context Protocol による自動化が評価項目に加わると、FormaCV の強みが明確になります。

ロードマップ

今後のテーマです（優先順位は変わる可能性があります。スケジュールについては営業担当にお問い合わせください）。

1. Salesforce と HubSpot の ATS コネクター（ATS 統合の拡張）。
2. Microsoft Teams の採用担当者向けアシスタントと、自動化された求人掲載の同期。
3. APAC／米国各州のプライバシーに関する違いに対応する、追加のロケールと法的テンプレート。
4. 可観測性を重視する方向けに、MCP トランスポート全体へ OpenTelemetry の計装を導入。
5. データ主権の要件に対応する、マネージド型オンプレミス／VPC デプロイ。

関連情報

• FormaCV のホームページ
• 料金 — 1 件の CV をフォーマットするごとに $0.99 の明朗な料金
• セキュリティ — GDPR への対応状況、AES-256、テナント分離について
• Bullhorn 統合ページ
• JobAdder 統合ページ
• Vincere 統合ページ
• Model Context Protocol の仕様

コントリビューション

Issue と PR を歓迎します。GitHub チケットを作成するか、[email protected] までメールでご連絡ください。書式やスタイルに関するガイドラインは、今後 CONTRIBUTING.md にまとめる予定です。

ライセンス

MIT © 2026 FormaCV