보험 청구 어시스턴트

자동차 보험 청구 처리를 자동화하는 MCP 서버로, TypeScript와 Anthropic Claude API로 구축되었습니다.

프랑스 AXA에서 Guidewire ClaimCenter로 1년간 근무하며 EDI 브로커 플로우(506/508/509)를 통합하여 자동 청구 개설 및 수정을 처리한 경험을 바탕으로 만들었습니다. 여기의 비즈니스 로직은 그때 다뤘던 것들 — 엔티티 추출, 심각도 분류, 브로커 알림 — 을 반영하되, 정적 규칙 대신 LLM으로 구현했습니다.

핵심은 두 모델 검증 파이프라인입니다. 빠른 모델이 분류하고, 더 강력한 모델이 검토하여 결과가 전송되기 전에 번복할 수 있습니다.

기능

세 가지 도구가 체인으로 연결됩니다:

    ↓  analyze_claim_report
Structured ClaimData
    ↓  classify_claim_severity
Severity + judge verdict
    ↓  generate_broker_notification
Formal broker notification

Related MCP server: Claim Pilot MCP Server

판사

분류는 두 모델을 통해 실행됩니다.

Claude Haiku가 구조화된 청구 데이터를 받아 심각도와 신뢰도 점수, 근거를 반환합니다. 그다음 Claude Sonnet이 동일한 청구 데이터와 Haiku의 답변을 받아 판정을 내립니다:

{
  "approved": false,
  "feedback": "Injuries confirmed in the report — AUTO_PROCESS is not applicable",
  "finalSeverity": "URGENT_ESCALATION"
}

Sonnet은 Haiku에게 재시도를 요청하지 않습니다. 직접 번복하며, finalSeverity가 다운스트림 파이프라인에서 사용됩니다. 판사는 항상 최종 결정권을 가집니다.

이 패턴이 더 저렴한 곳이 아닌 여기에 있는 이유: 청구 처리에서 오분류는 단순한 표면적 오류가 아닙니다. 부상이 있는 URGENT_ESCALATION 청구가 AUTO_PROCESS로 라우팅되면 누군가가 도움을 더 오래 기다리게 됩니다. Haiku는 모든 청구에 실행하기에 충분히 저렴하고, Sonnet은 비용이 더 들지만 게이트 역할로 한 번만 실행됩니다.

analyze_claim_report

원시 사고 보고서 텍스트를 받아 구조화된 JSON을 반환합니다: 차량, 당사자, 손상, 상황, 목격자.

Agent Skill 패턴을 사용합니다 — 추출 프롬프트는 도구에 인라인으로 작성되지 않고 자체 모듈(skills/claim-extraction.skill.ts)에 있습니다.

classify_claim_severity

청구를 AUTO_PROCESS, REVIEW_NEEDED, 또는 URGENT_ESCALATION으로 분류합니다.

generate_broker_notification

심각도 분류에 따른 필수 조치 사항이 포함된 공식 브로커 알림 서신을 생성합니다.

이 도구는 MCP 진행 알림(1/3, 2/3, 3/3)을 전송하여 클라이언트가 실시간 상태를 표시할 수 있게 합니다.

아키텍처

├── index.ts                       MCP server, tool registration
├── tools/
│   ├── analyze-claim.ts
│   ├── classify-claim.ts
│   └── generate-notification.ts
├── skills/
│   └── claim-extraction.skill.ts  Reusable prompt template
├── judge/
│   └── classification-judge.ts    Sonnet validates Haiku
├── utils/
│   ├── anthropic-client.ts        Shared SDK instance + model config
│   ├── logger.ts                  stderr logging
│   └── progress.ts                Progress notification helper
└── types/
    └── claim.types.ts

설명할 가치가 있는 몇 가지 결정 사항

로깅은 stdout이 아닌 stderr로 출력됩니다. stdio 전송을 사용하는 MCP 서버는 JSON-RPC 메시지용으로 stdout을 예약합니다. 잘못된 console.log 하나가 프로토콜을 손상시키고 클라이언트 연결을 끊습니다. 모든 로깅은 대신 stderr로 출력됩니다.

판사 외에는 모두 Haiku를 사용합니다. 추출, 분류, 알림 생성은 모두 Haiku에서 실행됩니다. Sonnet은 검증자로만 실행됩니다. 실제 청구 규모에서 이 비용 차이는 중요합니다.

진행 알림은 선택 사항입니다. sendProgressFn 매개변수는 선택 사항이므로 진행 업데이트를 지원하지 않는 클라이언트에서도 도구가 계속 작동합니다. 진행 토큰을 보내지 않았다고 클라이언트가 충돌해서는 안 됩니다.

입력 검증에 Zod 사용. MCP SDK는 Zod 스키마를 사용하여 비즈니스 로직이 실행되기 전에 서버 경계에서 도구 입력을 검증합니다. 또한 타입이 지정된 핸들러 인수를 무료로 제공합니다.

설정

Node.js 18+와 Anthropic API 키가 필요합니다.

git clone https://github.com/youssefmkb/insurance-claims-assistant
cd insurance-claims-assistant
npm install
cp .env.example .env    # add your API key
npm run build

서버 실행:

node dist/index.js

MCP Inspector로 테스트:

npx @modelcontextprotocol/inspector node dist/index.js

스크린샷

서버가 노출하는 도구:

원시 사고 보고서에서 엔티티 추출:

판사 판정이 포함된 분류:

오른쪽 하단에 진행 업데이트가 표시되는 브로커 알림:

기술 스택

Node.js, TypeScript, @modelcontextprotocol/sdk v4, Anthropic SDK (Haiku + Sonnet), Zod, stdio 전송.

V2 아이디어

더 발전시킨다면 추가할 것들:

• 실제 이메일 전송 — 현재는 알림이 생성만 되고 발송되지는 않습니다. SendGrid나 Nodemailer를 연결하면 루프가 완성됩니다.

• 영속성 — 현재 청구는 상태가 없습니다. 데이터베이스가 있으면 각 호출을 개별적으로 처리하는 대신 청구의 전체 수명 주기를 추적할 수 있습니다.

• MCP 샘플링 — API를 직접 호출하는 대신 서버가 클라이언트의 모델에서 완성 요청을 받을 수 있게 합니다.

• 원격 전송 — 현재는 stdio만 지원합니다. Streamable HTTP를 지원하면 배포가 가능해집니다.

작성자

Youssef Mokhbi — github.com/youssefmkb · LinkedIn