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(scraper → 초안 → 검토 흐름)를 사용하려면 각 일괄 항목이 기대하는 정확한 구조는 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를 섹션별로 편집하지 않습니다(경력/학력/언어를 하나씩) — 지원 및 기업 프로필의 필수 항목만 가능합니다.

• talento_ficha는 전화/이메일/신분증을 절대 가져오지 않습니다 — 실제 인재 검색기는 이 브리지가 복제하지 않는 감사된 잠금 해제 흐름을 요구합니다.

• 변경 시 이메일을 보내거나 Google에 알리지 않습니다 — 앱 내 알림만 가능합니다. 사이트는 자체적으로 변경 사항을 수집합니다(설정 캐시 최대 30초, SEO를 위한 일반 sitemap/크롤링).

보안

• 비밀은 서버 측에서 timingSafeEqual로 비교됩니다(응답 시간으로 유출되지 않음).

• 브리지에는 IP당 30회 호출 / 5분의 Rate limit이 적용됩니다.

• 각 변형은 datos.via: "mcp"와 함께 Contratando의 감사 로그에 남으며, 서버 측 SEED_ADMIN_EMAIL에 설정된 슈퍼 관리자에게 귀속됩니다.

• 비밀이 유출된 경우 양쪽 모두에서 교체하세요: Contratando의 .env에 있는 MCP_API_SECRET(재배포) 및 여기.