MCP 서버를 통한 KYC: 실용 가이드

본인 확인(KYC) 검사는 Didit 플랫폼에서 가장 일반적인 신원 확인 작업이며, https://mcp.didit.me/mcp의 공식 MCP(Model Context Protocol) 서버를 통해 대화처럼 자연스럽게 실행할 수 있습니다. AI 에이전트(Claude Desktop, Claude Code, Cursor, ChatGPT 또는 MCP 지원 클라이언트)를 호스팅된 엔드포인트에 연결하고, "Didit으로 로그인"으로 인증하면 에이전트가 전체 KYC 수명 주기를 진행할 수 있습니다. 조직 및 애플리케이션 검색, 올바른 워크플로 선택, 호스팅된 확인 세션 생성, 사용자에게 링크 전달, 결정 폴링 등의 과정을 거칩니다. 이 가이드는 각 도구별로 시퀀스를 안내하고, 10가지 세션 상태와 각 상태에서 수행할 작업을 다루며, 백엔드 경로를 원하는 독자를 위해 해당 REST 호출을 보여줍니다.

주요 내용

• Didit MCP 서버는 https://mcp.didit.me/mcp에서 Streamable HTTP를 통해 11개 카테고리에 걸쳐 115가지 도구를 제공합니다. 호스팅 또는 자체 호스팅이 가능하며, MCP 계층 자체는 무료입니다.
• 인증은 동적 클라이언트 등록을 통한 OAuth 2.1 + PKCE(Proof Key for Code Exchange)입니다. 호스팅된 MCP 서버에는 API 키가 없으며, 에이전트는 로그인한 사용자로 인증하고 해당 사용자의 콘솔 권한을 상속합니다.
• 신분증 확인, 수동 라이브니스, 얼굴 일치, IP 분석을 포함한 전체 KYC 확인은 $0.33이며, 월 500회 무료 확인과 2초 미만의 p99 추론을 제공합니다. 워크플로에는 AML 심사($0.20) 또는 맞춤형 설문지($0.10)와 같은 추가 검사가 포함될 수 있습니다.
• 에이전트는 5가지 도구로 KYC 세션을 실행합니다: 조직 및 앱 검색, 워크플로 선택, 세션 생성, V3 배열 결정 확인, 세션 상태를 승인, 거부 또는 재제출 요청으로 업데이트.
• 10가지 세션 상태는 에이전트에게 다음에 무엇을 해야 할지 알려줍니다: 시작되지 않음, 진행 중, 검토 중, 승인됨, 거부됨, 만료됨, 중단됨, KYC 만료됨, 재제출됨, 사용자 대기 중.
• MCP 서버는 220개 이상의 국가와 14,000개 이상의 문서 유형, 48개 이상의 언어로 2,000개 이상의 프로덕션 회사에 온보딩을 지원합니다.

Didit MCP 서버란 무엇인가

MCP(Model Context Protocol)는 AI 에이전트가 일관된 인터페이스를 통해 외부 도구를 호출할 수 있도록 하는 오픈 표준입니다. Didit의 https://mcp.didit.me/mcp 구현은 신원 및 사기 방지 플랫폼을 위한 공식 MCP 서버이며, github.com/didit-protocol/mcp에서 MIT 라이선스 하에 게시됩니다. 이는 상태 비저장, POST 전용, Server-Sent Events 없는 Streamable HTTP 전송을 사용하며, 세션, 워크플로, 확인 API, 거래 모니터링, 자금세탁 방지(AML) 심사, 지갑 심사, 웹훅, 사례, 보고서, 작업 공간 운영 등 전체 플랫폼을 포괄하는 11개 카테고리에 걸쳐 115가지 도구를 제공합니다.

호스팅된 인증은 PKCE(Proof Key for Code Exchange) 및 DCR(Dynamic Client Registration)을 사용하는 OAuth 2.1을 사용합니다. 에이전트가 처음 연결할 때 business.didit.me를 통해 "Didit으로 로그인" 흐름을 위한 브라우저를 엽니다. 결과 토큰은 didit:management 및 didit:verification에 걸쳐 콘솔 사용자로 범위가 지정됩니다. 즉, 에이전트는 사용자의 역할이 허용하는 작업만 수행할 수 있습니다. 이는 중요합니다. 호스팅된 서버의 MCP 구성 파일에 붙여넣을 API 키가 없습니다. API 키는 REST API 개념이며 MCP 컨텍스트에서는 사용되지 않습니다.

호스팅된 엔드포인트를 Claude Desktop 또는 Claude.ai에 연결하려면 미리 구축된 커넥터 딥 링크를 사용하십시오:

Didit을 Claude 커넥터로 추가

전체 도구 세트에 대한 개요는 MCP 도구 참조 및 MCP 개요 문서를 참조하십시오.

KYC 시퀀스 — 도구별

Didit의 표준 KYC 세션은 신분증 확인, 본인 확인을 위한 수동 라이브니스, 셀피와 문서 사진 일치 여부 확인을 위한 얼굴 일치, 사기 신호 분석을 위한 IP 분석 등 선택한 신원 확인을 번들로 제공하며, 전체 번들을 구성하면 총 $0.33입니다. 다음은 에이전트가 세션을 생성, 전달 및 해결하기 위해 따르는 정확한 도구 시퀀스입니다:

1. 컨텍스트 검색

무엇이든 생성하기 전에 에이전트는 어떤 조직 및 애플리케이션에서 작동할지 알아야 합니다. didit_context_get을 호출하여 로그인한 사용자가 액세스할 수 있는 사용 가능한 조직 및 애플리케이션을 나열합니다. 이는 이후의 모든 도구 호출에 필요한 organization_id 및 application_id를 반환합니다.

2. 워크플로 선택

확인 워크플로는 어떤 검사를 실행하고 어떻게 결정이 내려지는지 정의합니다. didit_workflow_list를 호출하여 애플리케이션에 구성된 워크플로를 가져옵니다. 각 워크플로는 OCR(광학 문자 인식), 라이브니스, 얼굴 일치, AML, 설문지 등 기능을 노출하므로 에이전트는 필요한 확인 유형에 맞는 워크플로를 선택할 수 있습니다. 표준 KYC 온보딩의 경우 워크플로는 일반적으로 OCR, 라이브니스, 얼굴 일치 및 IP 분석을 포함합니다.

3. 세션 생성

워크플로가 선택되면 workflow_id와 선택적으로 vendor_data에 자신의 외부 참조를 사용하여 didit_session_create를 호출합니다. 조직 및 애플리케이션 범위는 모호하지 않을 때 자동으로 해결되므로 거의 전달할 필요가 없습니다. 또한 호스팅된 확인 UI의 language, 신청자가 돌아갈 callback, contact_details 또는 expected_details를 통해 미리 채워진 데이터를 설정할 수 있습니다. 이 도구는 신청자에게 보내는 호스팅된 링크인 url을 반환합니다. 이 경로에는 SDK 통합이 필요하지 않습니다. 신청자는 브라우저에서 링크를 열고 검사를 완료하면 에이전트가 거기서부터 작업을 시작합니다.

4. 결정 확인

신청자가 검사를 완료하면 세션 ID로 didit_session_get_decision을 호출합니다. 이는 V3 복수 배열 결정인 status 문자열, 평결 및 위험 점수가 포함된 decision 객체, 그리고 기능별 결과(OCR 데이터, 라이브니스 신뢰도, 얼굴 일치 유사성 등)를 반환합니다. 에이전트는 평결을 읽어 다음 작업을 결정합니다.

5. 결정에 따른 조치

결정 평결에 따라 세션 상태를 설정하려면 didit_session_update_status를 호출합니다:

• 승인됨 — 모든 검사가 통과되었습니다. 상태를 approved로 설정하여 완료합니다.
• 거부됨 — 검사가 실패했거나 사기가 감지되었습니다. 상태를 declined로 설정합니다.
• 재제출됨 — 문서가 불분명하거나 신청자가 다시 시도해야 합니다. 상태를 resubmitted로 설정하여 재시도를 허용합니다.

이것이 자연어 프롬프트에서 5가지 도구로 이루어지는 전체 KYC 왕복 과정입니다.

10가지 세션 상태

Didit 세션은 10가지 상태의 수명 주기를 거칩니다. 세션을 모니터링하도록 구성된 에이전트는 각 상태를 처리해야 합니다:

• 시작되지 않음 — 세션이 생성되었지만 신청자가 확인 링크를 열지 않았습니다. 아직 조치가 필요하지 않습니다.
• 진행 중 — 신청자가 링크를 열고 검사를 진행 중입니다. 에이전트는 기다려야 합니다.
• 검토 중 — 자동화된 검사가 경계선 점수로 완료되었습니다. 세션에 수동 검토가 필요합니다. 인간 규정 준수 담당자에게 알립니다.
• 승인됨 — 모든 검사가 통과되었습니다. 온보딩을 완료합니다.
• 거부됨 — 검사가 실패했습니다. 신청자를 거부하거나 다른 문서로 새 확인을 시작합니다.
• 만료됨 — 완료 전에 세션이 만료되었습니다. 새 세션을 제공합니다.
• 중단됨 — 신청자가 완료하기 전에 흐름을 닫았습니다. 알림 또는 새 링크를 보냅니다.
• KYC 만료됨 — 주기적인 재확인 세션이 만료되었습니다. 재온보딩을 위해 플래그를 지정합니다.
• 재제출됨 — 신청자가 더 나은 데이터를 요청받은 후 다시 제출했습니다. didit_session_get_decision을 다시 실행하여 새 평결을 얻습니다.
• 사용자 대기 중 — 세션이 신청자가 추가 정보 또는 문서를 제공하기를 기다리며 일시 중지되었습니다.

에이전트 수준 제어: 목록, 차단 목록 및 지속적인 모니터링

단일 세션 KYC 외에도 MCP 서버는 에이전트에게 위험 제어 표면에 대한 액세스를 제공합니다. didit_lists_list 및 didit_lists_entry_create를 사용하여 거부된 신청자를 차단 목록에 추가하여 새 세션을 생성하는 것을 방지합니다. didit_blocklist_get 및 didit_blocklist_add를 사용하여 새 세션 요청이 생성되기 전에 심사합니다. 지속적인 모니터링을 위해 KYC 승인 후 didit_verify_aml을 실행하여 1,300개 이상의 감시 목록에 대해 자금세탁 방지 심사를 건당 $0.20에, didit_transaction_screen_wallet을 실행하여 암호화폐 지갑 심사를 건당 $0.15에 실행할 수 있습니다.

동등한 REST API 경로

모든 통합이 AI 에이전트를 통해 실행되는 것은 아닙니다. HTTP를 통해 Didit을 직접 호출하는 백엔드를 구축하는 경우 REST API는 x-api-key 인증(콘솔의 애플리케이션 비밀 키)을 사용합니다. 다음은 curl을 통한 동등한 KYC 세션 생성입니다:

curl -X POST https://api.didit.me/v3/session/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workflow_id": "wfl_abc123",
    "vendor_data": "user-456",
    "language": "en",
    "callback": "https://myapp.com/kyc-callback"
  }'

응답에는 session_id와 url이 포함됩니다. 이는 MCP 세션이 반환하는 것과 동일한 호스팅된 링크입니다. 결정 엔드포인트를 폴링하고 REST를 통해 동일한 방식으로 상태를 업데이트합니다. x-api-key 헤더에 유의하십시오. 이는 REST API 인증 메커니즘이며 위에 설명된 MCP OAuth 흐름과는 관련이 없습니다. REST API는 별도의 표면이며, MCP 서버는 API 키를 필요로 하거나 사용하지 않습니다.

가격 및 제한

모든 Didit 기능은 최소 금액 없이 성공당 가격이 공개되어 있습니다. MCP 서버 자체는 무료입니다. 연결 또는 도구 목록에 대한 요금은 없습니다. 성공적인 확인에 대해서만 비용을 지불합니다:

• 전체 KYC 번들(ID + 수동 라이브니스 + 얼굴 일치 + IP): $0.33
• ID 확인(단독): $0.15
• 수동 라이브니스(단독): $0.10
• AML 심사: 건당 $0.20, 1,300개 이상의 감시 목록
• 지갑 심사(KYT): 건당 $0.15
• 거래 모니터링: 거래당 $0.02
• 사업자 확인(KYB): 사업자당 $2.00부터

모든 기능에는 월 500회 무료 확인이 영구적으로 포함됩니다. 시간 제한이나 계층 제한이 없습니다. $0.33의 전체 KYC 번들은 220개 이상의 국가와 14,000개 이상의 문서 유형에 걸쳐 2초 미만의 p99 추론을 제공하며, 기존 KYC 제공업체보다 3-5배 저렴합니다.

시작하기

몇 분 안에 에이전트를 연결하고 KYC 검사를 시작하려면:

1. Claude 커넥터 딥 링크를 열고 Didit을 사용자 지정 커넥터로 추가합니다.
2. Claude Code의 경우: claude mcp add --transport http didit https://mcp.didit.me/mcp를 실행한 다음 /mcp를 실행하여 인증합니다.
3. Cursor의 경우: {"mcpServers":{"didit":{"url":"https://mcp.didit.me/mcp"}}}를 .cursor/mcp.json에 추가합니다.
4. 인증되면 "내 조직 및 애플리케이션을 검색하고, KYC 워크플로를 나열하고, 신규 신청자를 위한 확인 세션을 생성해줘."라고 프롬프트를 입력합니다.

MCP 소스 코드는 github.com/didit-protocol/mcp에서 오픈 소스이며 MIT 라이선스가 적용됩니다. 다양한 클라이언트에 서버를 설치하는 방법에 대한 자세한 내용은 Claude에 Didit MCP 서버를 설치하는 방법을 참조하십시오. 매개변수가 포함된 전체 도구 카탈로그는 Didit MCP 도구 참조를 참조하십시오.