Claude를 통한 연령 확인: 호스팅된 세션과 로컬 파일

핵심 요약

• 호스팅된 Claude 커넥터는 사용자의 장치에서 didit_verify_age 또는 didit_verify_id로 셀카나 신분증 사진을 보낼 수 없습니다. 이러한 도구는 MCP(Model Context Protocol) 서버를 실행하는 기기의 절대 경로를 읽습니다.
• 올바른 호스팅 경로는 세션 기반입니다. 기존 워크플로에 대한 세션을 생성하고, 사용자에게 반환된 url을 제공한 다음, didit_session_get_decision을 사용하여 완료된 결정을 검색합니다.
• 워크플로에는 얼굴 연령 추정(연령을 추정) 또는 문서 확인(생년월일 및 기타 문서 필드를 추출)이 포함될 수 있습니다. 이는 증거 수준이 다릅니다.
• 파일 경로 도구는 MCP 서버와 이미지 파일이 동일한 시스템에 있는 로컬 또는 자체 호스팅 stdio 배포에 여전히 유용합니다.
• Didit의 호스팅된 MCP 엔드포인트는 115개의 도구를 노출합니다. 서버는 무료이며, 무료 등급은 월 500회 무료 확인을 제공합니다.

“Claude에서 이 사람의 연령을 확인”하는 것은 단일 도구 호출처럼 들립니다. 실제 통합에는 중요한 경계가 있습니다. 이미지는 어디에 있습니까? 이는 Claude가 호스팅된 확인 세션을 생성해야 하는지 아니면 독립형 이미지 도구를 호출해야 하는지를 결정합니다.

Didit의 MCP 개발자 페이지 및 공개 GitHub 저장소는 Claude를 신분 및 사기 확인에 연결하는 서버를 설명합니다. 연령 보증의 경우, 원격으로 Claude를 사용하는 실제 사람에게는 호스팅된 세션 경로가 실용적인 선택입니다. 독립형 이미지 경로 경로는 직접 파일 시스템 액세스가 가능한 로컬 또는 자체 호스팅 환경용으로 설계되었습니다.

대부분의 MCP 예시에서 놓치는 파일 시스템 경계

독립형 didit_verify_age 도구는 절대 image_path를 허용합니다. didit_verify_id도 마찬가지로 절대 front_image_path와 선택적 back_image_path를 허용합니다. MCP 서버 내에서 해당 경로는 파일이 제출되기 전에 검증되고 디스크에서 읽힙니다.

이는 로컬 stdio 배포에서는 간단합니다. Claude Desktop과 자체 호스팅 Didit MCP 서버가 동일한 워크스테이션에서 실행되는 경우 /Users/example/checks/selfie.jpg와 같은 경로는 서버 프로세스에서 사용할 수 있는 실제 파일을 참조할 수 있습니다. 동일한 아이디어는 애플리케이션이 파일을 허용된 로컬 디렉토리에 이미 배치한 경우 제어되는 내부 서버에서도 작동합니다.

호스팅된 엔드포인트에서는 동일하게 작동하지 않습니다. Claude가 https://mcp.didit.me/mcp를 호출할 때, 절대 경로는 Claude 사용자의 노트북이나 휴대폰이 아닌 Didit 서버 파일 시스템을 참조합니다. 호스팅된 Claude에 로컬 경로를 입력해도 해당 파일이 업로드되지 않습니다. 따라서 원격 사용자는 단순히 경로 이름을 지정하는 것만으로 호스팅된 도구에 셀카나 문서 사진을 전달할 수 없습니다.

이는 연령 추정 자체의 한계가 아닙니다. 이는 전송 및 파일 시스템의 차이입니다. 호스팅된 사용자의 경우 Didit은 확인 세션과 사용자 대면 URL을 통해 전달 문제를 해결합니다.

작동하는 호스팅된 Claude 흐름

먼저, 조직은 Didit Business Console에 구성된 기존 워크플로가 필요합니다. 해당 워크플로는 개인이 완료할 확인을 정의합니다. 연령 보증 워크플로에는 얼굴 연령 추정, 생년월일 추출을 통한 문서 확인, 또는 더 광범위한 KYC(Know Your Customer) 시퀀스가 포함될 수 있습니다.

그런 다음 Claude는 didit_session_create를 호출합니다. 유일하게 필요한 입력은 workflow_id입니다. 이 도구는 인라인 “워크플로 구성”을 허용하지 않습니다. 선택적 입력에는 vendor_data의 교환 또는 애플리케이션의 사용자 참조, 리디렉션 callback, UI language가 포함됩니다.

Use didit_session_create with:
{
  "workflow_id": "<existing-workflow-uuid>",
  "vendor_data": "user_18427",
  "callback": "https://example.com/age-check/complete",
  "language": "en"
}

Return the session URL to the user. Do not ask them for a local image path.

응답에는 session_id, url, session_token이 포함됩니다. Claude는 사용자에게 반환된 url을 제공합니다. 사용자는 자신의 장치에서 Didit의 호스팅된 확인 UI를 열고 워크플로에 의해 정의된 캡처 단계를 완료합니다. 이미지 전송은 채팅에 입력된 경로를 통해서가 아니라 해당 UI에서 발생합니다.

완료 후 Claude는 반환된 세션 ID를 사용하여 didit_session_get_decision을 호출합니다.

Use didit_session_get_decision with:
{
  "session_id": "<session-uuid-from-create>"
}

Summarise the session decision and only the extracted fields returned by the workflow.

이 도구는 해당 세션에 대한 전체 확인 결정과 모든 추출된 데이터를 반환합니다. 정확한 데이터는 워크플로에 따라 달라집니다. MCP 소스는 연령 임계값에 대한 별도의 부울 단축키를 문서화하지 않습니다. 문서 확인의 경우, 결정에는 구성된 확인 단계에 의해 반환된 구조화된 문서 데이터가 포함될 수 있습니다. 에이전트는 편리 필드를 발명하는 대신 실제 응답을 읽어야 합니다.

로컬 이미지 도구가 실제로 하는 일

로컬 또는 자체 호스팅 stdio 설정에서 독립형 도구는 배치 작업, 내부 검토 유틸리티 또는 이미지 수집을 이미 제어하는 애플리케이션에 대한 직접적인 경로가 될 수 있습니다.

얼굴 연령 추정

didit_verify_age는 image_path를 요구하며 선택적으로 vendor_data를 허용합니다. 이 도구는 얼굴 이미지에서 사람의 연령을 추정하고 수동 라이브니스 확인도 수행합니다. 추정치는 정확한 생년월일이나 신원의 증거가 아닙니다.

# Local or self-hosted stdio only
# The file must exist on the MCP server's filesystem.
didit_verify_age {
  "image_path": "/absolute/server/path/selfie.jpg",
  "vendor_data": "user_18427"
}

연령 추정은 확인당 $0.10의 비용이 부과됩니다. 입력은 여전히 얼굴 이미지이며, 서비스는 해당 이미지를 처리하여 결과를 생성합니다. 이 방법을 문서 없는 방법으로 설명하는 것은 정확하지만, 개인 데이터를 수집하지 않거나 아무것도 저장하지 않는다고 설명하는 것은 MCP 도구 계약에서 지원되지 않습니다.

문서 기반 생년월일 추출

didit_verify_id는 front_image_path를 요구합니다. 또한 back_image_path, minimum_age 및 기타 문서화된 옵션을 받을 수 있습니다. 이 도구는 신분증 이미지를 제출하고, 광학 문자 인식(OCR)을 수행하며, 구조화된 문서 데이터와 진위 확인을 반환합니다. OCR은 문서에 있는 다른 필드와 함께 생년월일을 추출할 수 있습니다.

# Local or self-hosted stdio only
didit_verify_id {
  "front_image_path": "/absolute/server/path/id-front.jpg",
  "back_image_path": "/absolute/server/path/id-back.jpg",
  "minimum_age": 18,
  "vendor_data": "user_18427"
}

소스는 minimum_age를 추출된 연령이 제공된 값보다 낮을 때 확인을 거부하는 것으로 설명합니다. 에이전트는 추가 임계값 결과 필드를 기대하기보다 반환된 결정을 읽어야 합니다. 신분증 확인은 확인당 $0.15입니다. 전체 문서 이미지가 제출되고 문서 필드가 추출되므로 이 경로는 생년월일만 수집하는 것으로 제시되어서는 안 됩니다.

연령 추정, 문서 확인 및 전체 KYC는 상호 교환 불가능합니다.

경로	확립되는 내용	호스팅된 Claude 경로	공개 가격
얼굴 연령 추정	얼굴 이미지에서 추정된 연령 및 수동 라이브니스	연령 추정을 포함하는 워크플로의 호스팅된 세션 사용	확인당 $0.10
신분증 확인	문서 진위 확인 및 추출된 문서 필드(생년월일 포함)	문서 확인을 포함하는 워크플로의 호스팅된 세션 사용	확인당 $0.15
전체 KYC	신분증 확인, 수동 라이브니스, 얼굴 매칭, IP 분석을 결합한 구성된 신분 확인	기존 KYC 워크플로에 대한 세션 생성 및 URL 전달	묶음당 $00.33

첫 번째 경로는 추정입니다. 두 번째 경로는 제출된 정부 발행 문서에 의존합니다. 세 번째 경로는 여러 확인을 결합하여 더 광범위한 신원 결정을 내립니다. 제품 팀은 어떤 메커니즘도 자동으로 법률이나 규제 기관을 충족시킨다고 주장하지 않고 이러한 증거 수준을 구별할 수 있습니다.

규제 환경은 방법별로 다릅니다.

연령 보증 규칙은 관할권, 서비스 유형, 콘텐츠 및 위험에 따라 다릅니다. 영국에서 Ofcom의 온라인 안전법 연령 보증 지침은 정확성, 회피 저항성, 신뢰성 및 공정성과 같은 기준에 대한 효과를 평가하면서 얼굴 연령 추정 및 사진 신분증 매칭을 포함하여 매우 효과적일 수 있는 여러 방법을 논의합니다. 유럽 연합에서 유럽 위원회의 시청각 미디어 서비스 지침 개요는 PIN 또는 더 정교한 연령 확인 시스템을 포함할 수 있는 미성년자 보호 조치를 설명합니다.

이러한 출처는 구현 언어가 중요한 이유를 보여줍니다. “연령 보증”, “연령 추정”, “문서 확인” 및 “신원 확인”은 관련이 있지만 동의어는 아닙니다. 특정 방법이 특정 서비스에 적합한지 여부는 관할권 및 상황별 평가입니다. MCP 통합은 기술적 경로를 제공하지만 운영자를 위한 평가는 수행하지 않습니다.

경계를 흐리지 않고 Claude 연결

호스팅된 Claude의 경우 Didit 커넥터 딥 링크를 사용하십시오. 이 엔드포인트는 PKCE(Proof Key for Code Exchange)와 함께 OAuth 2.1을 사용합니다. MCP 개요, 인증 가이드 및 도구 참조는 연결 및 검색을 다룹니다.

더 광범위한 세션 패턴에 대해서는 MCP를 통한 KYC 신원 확인을 읽으십시오. 통합의 카탈로그 수준 보기에 대해서는 Didit MCP 도구 참조를 참조하십시오.

실용적인 규칙은 간단합니다. 호스팅된 Claude는 세션을 생성하고 사용자에게 URL을 전달해야 합니다. 로컬 또는 자체 호스팅 stdio는 서버에 해당 파일이 실제로 있는 경우 절대 이미지 경로를 사용할 수 있습니다. 이 경계를 명시적으로 유지하면 연령 보증 프롬프트가 정확하고 실행 가능하며 안전하게 재사용할 수 있습니다.