contratando-mcp

MCPサーバー。AIエージェント（Hermes）が Contratando を制御するためのものです。プラットフォームの完全な読み書きに対応：求人、企業、候補者、応募、クレジット、サブスクリプション、手数料、ユーザー、設定。

仕組み

このリポジトリはデータベースにアクセスしません。薄いクライアントです。エージェントが呼び出す各ツールは、HTTPS で POST {MCP_BRIDGE_URL}/api/mcp に転送されます。これは Contratando アプリ自体の中にある保護されたルートです（すでにデプロイ済み）。本番データベースは意図的にプライベートモードになっています。このブリッジが、インターネットに公開せずにデータベースを制御する方法です。

Hermes → contratando-mcp (stdio, local) → HTTPS + secreto → contratandord.com/api/mcp → Postgres (privada)

実際のロジック（各ツールが行うミューテーション、検証、監査）は Contratando のリポジトリ（src/lib/mcp/registro.ts）にあります。このリポジトリは、エージェントが何を要求できるかを把握できるよう、46個のツール（名前、説明、入力スキーマ）を宣言するだけです。

scraper_mensajes_pendientes + vacantes_importar_lote（スクレイパー → 下書き → モデレーションのフロー）を使用する場合は、PARSING.md を参照して、バッチの各項目が期待する正確な構造を確認してください。

Related MCP server: HeadHunter API MCP Server

セットアップ

npm install
cp .env.example .env

.env を記入してください：

• MCP_BRIDGE_URL — https://contratandord.com（ローカルに対してテストする場合は http://localhost:3200）。

• MCP_API_SECRET — Contratando の .env にある MCP_API_SECRET と同じ値。一致しない場合、ブリッジはすべて 401 で拒否します。

npm start

エージェントに接続する

Claude Desktop（claude_desktop_config.json）：

{
  "mcpServers": {
    "contratando": {
      "command": "npx",
      "args": ["tsx", "C:\\ruta\\a\\contratando-mcp\\src\\server.ts"],
      "env": {
        "MCP_BRIDGE_URL": "https://contratandord.com",
        "MCP_API_SECRET": "..."
      }
    }
  }
}

Claude Code：

claude mcp add contratando -- npx tsx C:\ruta\a\contratando-mcp\src\server.ts

Hermes や他の MCP ランタイムの場合：このディレクトリで npm start（または node --import tsx src/server.ts）を指定し、環境に MCP_BRIDGE_URL/MCP_API_SECRET を設定してください。

やらないこと

• ファイルをアップロードしません（ロゴ、領収書、RNC 文書）。

• 候補者の CV をセクションごとに編集しません（経験/学歴/言語を1つずつ）— 応募と企業プロフィールの必須項目のみです。

• talento_ficha は電話番号・メール・身分証明書を決して取得しません。実際の人材検索では、このブリッジが再現しない監査付きのロック解除フローが必要です。

• ミューテーション時にメールを送信したり Google に通知したりしません。アプリ内通知のみです。サイトは独自に変更を取得します（設定キャッシュ最大30秒、SEO用の通常のサイトマップ/クロール）。

セキュリティ

• シークレットはサーバー側で timingSafeEqual を使って比較されます（応答時間による漏洩はありません）。

• ブリッジでは IP ごとに 5分間で30回のレート制限があります。

• 各ミューテーションは datos.via: "mcp" として Contratando の監査ログに残り、サーバー側の SEED_ADMIN_EMAIL で設定されたスーパー管理者に帰属します。

• シークレットが漏洩した場合は、両方の側でローテーションしてください：Contratando の .env の MCP_API_SECRET（再デプロイ）と、こちらの .env。