우리는 고용 계약을 위한 MCP 서버를 구축했습니다 — remote HTTP, QES/eIDAS, 12 tools

Source: Dev.to

AI 에이전트 워크플로우를 구축해 왔다면, 아마도 이런 벽에 부딪혔을 것입니다: 에이전트는 추론하고, 계획하고, 실행할 수 있지만 외부 시스템에 연결하려면 여전히 각 서비스마다 맞춤형 API 래퍼, 인증 로직, 오류 처리를 작성해야 합니다.

MCP(Model Context Protocol)는 표준화를 통해 이를 해결합니다. MCP 서버를 제공하는 서비스는 MCP‑호환 에이전트에게 직접 도구 접근을 제공하므로 맞춤형 통합이 필요 없습니다.

우리는 이러한 관점을 바탕으로 staffSign— DACH 지역의 HR 및 인력 파견 에이전시를 위한 디지털 고용 계약 API—를 구축했습니다. 주요 인터페이스는 UI가 아니라 MCP 서버입니다.

설정 (Claude Desktop / Cursor / Claude.ai)

{
  "mcpServers": {
    "staffsign": {
      "url": "https://www.promotionbasis.de/api/mcp",
      "headers": { "X-Api-Key": "" }
    }
  }
}

원격 HTTP 서버 — 설치가 필요 없으며 mcp-remote도 필요 없습니다.

두 영역에 걸친 12가지 도구

계약 수명 주기: create_contract, send_contract, get_contract, search_contracts, cancel_contract, delete_contract

템플릿 관리: create_contract_template, update_contract_template, get_contract_template, search_contract_templates, activate_contract_template, archive_contract_template

전형적인 에이전트 워크플로우

flowchart TD
    A[Candidate accepts offer in ATS] --> B[Agent: create_contract(templateId, participants, signatureLevel="QES")]
    B --> C[Agent: send_contract(contractId)]
    C --> D[Candidate signs on phone (QES — eIDAS qualified, legally binding in all EU countries)]
    D --> E[Webhook: contract.signed]
    E --> F[Agent triggers onboarding]

전체 워크플로우가 2분 이내에 완료되며, 인간의 개입이 없습니다.

MCP 관점에서 눈에 띄는 점

• Remote HTTP — url + headers만으로 직접 설정, stdio 래퍼가 필요 없음
• QES (eIDAS) — EU 전역에서 법적 구속력이 있는 자격 전자 서명, 기본 제공
• 모든 POST 엔드포인트에 멱등성 키 적용 — 에이전트 재시도 로직에 안전
• 구조화된 오류 응답과 복구 힌트 제공
• Webhook 이벤트를 통한 이벤트‑드리븐 파이프라인 지원

MCP 서버를 기본 인터페이스로 만든 이유

대부분의 고용 계약 도구는 UI 중심으로 구축됩니다. 우리는 다른 선택을 했습니다: 2~3년 안에 대부분의 통합은 인간이 맞춤 코드를 작성하는 것이 아니라 AI 에이전트가 수행할 것이라고 예상했습니다. 그래서 우리는 사후 생각이 아닌 최초 설계 단계에서 MCP 서버를 만들었습니다.

계약당 €3부터 시작하는 사용량 기반 과금이며, 구독이 필요 없습니다. 문서: staffsign.de/docs

원격 HTTP 설정, QES/eIDAS 적용, MCP 설계 결정 등에 관한 질문에 언제든지 답변해 드리겠습니다.