> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Didit MCP 서버: AI 에이전트를 위한 신원 인증

> Claude, Cursor, VS Code, Windsurf 등 모든 MCP 클라이언트를 Didit에 연결하세요. 자연어로 KYC, KYB, AML을 호스팅 또는 자체 호스팅으로 사용할 수 있습니다.

**Didit MCP 서버**는 [Model Context Protocol](https://modelcontextprotocol.io) 클라이언트(Claude, Cursor, VS Code, Windsurf, Zed 등)를 Didit 신원 확인 플랫폼에 직접 연결합니다. 연결한 뒤에는 에이전트가 자연어 명령으로 KYC, KYB, AML 스크리닝, 거래 모니터링, 워크스페이스 작업 전반(워크플로, 세션, 목록, webhook, 결제)을 수행할 수 있습니다.

이 Didit Academy 강의에서는 호스팅된 MCP 서버를 OAuth로 Claude에 연결한 다음, 프롬프트 하나로 KYC 워크플로를 만들고, 검토 대기열을 조회하고, 90일 거래 이력을 기준으로 거래 규칙을 백테스트합니다.

[MCP로 Didit 사용하기 - Didit Academy](https://www.youtube.com/embed/I3UkFIhW548?rel=0\&playsinline=1)

> [!NOTE]
>
> Didit MCP는 **읽기와 쓰기가 모두 가능합니다**. 에이전트는 사용자를 대신해 세션을 만들고, 워크플로를 구성하고, 상태를 업데이트하고, 목록에 항목을 추가할 수 있습니다. 모든 클라이언트는 도구 호출을 실행하기 전에 검토를 요청합니다. 이 설정을 켜 두세요. 특히 쓰기 및 삭제 작업에서는 이 설정을 켜 두세요.

***

## 30초 만에 시작하기

가장 빠른 방법은 **호스팅 서버**를 사용하는 것입니다. URL 하나면 되며 API 키는 필요 없습니다. 클라이언트가 브라우저를 열면 **Didit으로 로그인**을 선택하고 권한을 승인하세요. 그러면 연결이 완료됩니다.

```text Hosted endpoint theme={null}
https://mcp.didit.me/mcp
```

> [!TIP]
>
> **Claude 웹에서는** [**Claude에 Didit 추가 →**](https://claude.ai/customize/connectors?modal=add-custom-connector\&connectorName=Didit\&connectorUrl=https://mcp.didit.me/mcp)를 누르면 커넥터 대화상자가 미리 채워집니다. 확인한 뒤 Didit으로 로그인하면 끝입니다. 전체 안내는 [Claude 연결](https://docs.didit.me/ko/integration/mcp/claude.md)에서 볼 수 있습니다. 소스 코드는 [GitHub](https://github.com/didit-protocol/mcp)에서 확인할 수 있습니다(MIT 라이선스).

> [card] [클라이언트에 설치](https://docs.didit.me/ko/integration/mcp/installation.md)
>
> Claude, Cursor, VS Code, Windsurf, Zed용 복사-붙여넣기 설정.

> [card] [로그인 작동 방식](https://docs.didit.me/ko/integration/mcp/authentication.md)
>
> "Didit으로 로그인"(PKCE를 사용하는 OAuth 2.1). API 키도, 설정 파일에 넣는 비밀 값도 필요 없습니다.

> [card] [도구 살펴보기](https://docs.didit.me/ko/integration/mcp/tools.md)
>
> 세션, 워크플로, 단독 검사, 거래 모니터링, 목록, 케이스, 보고서, webhook에 걸친 169개 도구.

> [card] [실제 동작 보기](https://docs.didit.me/ko/integration/mcp/examples.md)
>
> 프롬프트 예시와 처음부터 끝까지 이어지는 에이전트 대화.

***

## 작동 방식

호스팅 MCP는 OAuth 2.1 **리소스 서버**이고, Didit Business Console(`business.didit.me`)은 **권한 서버**입니다. URL 하나로 연결하고 브라우저에서 **Didit으로 로그인**을 하면, MCP는 소속된 모든 조직에서 **나**로서 동작하며 콘솔 역할에 부여된 권한을 그대로 가집니다.

> [!NOTE]
>
> **MCP는 애플리케이션이 아니라 Didit 사용자로 동작합니다. API 키 모드는 없습니다.** 모든 도구는 사용자 범위의 콘솔 엔드포인트를 호출하며, 이 엔드포인트는 사용자의 Bearer 토큰만 허용합니다. (애플리케이션 API 키로 원시 REST API를 호출하려면, 예를 들어 자체 백엔드에서 세션을 만드는 경우에는 [REST API](https://docs.didit.me/openapi-25.json)를 직접 사용하세요. 이는 이 MCP와 별개입니다.)

이 서버는 상태를 저장하지 않는(stateless) Streamable HTTP 방식입니다. 요청마다 `POST https://mcp.didit.me/mcp` 호출 하나를 사용하며, 세션 고정(session affinity)은 없습니다. 상태 확인은 `GET https://mcp.didit.me/healthz`에서 공개적으로 제공합니다.

서버를 직접 실행하고 싶으신가요? 가능합니다. [설치 → 셀프 호스팅](https://docs.didit.me/ko/integration/mcp/installation.md#셀프-호스팅)을 참고하세요. 이 경우에도 사용자 인증은 OAuth로 처리합니다(헤드리스 stdio 실행에서는 사용자 Bearer 토큰을 사용합니다).

도구는 기반 Didit 엔드포인트의 원본 JSON을 그대로 반환합니다. 전체 내용은 [인증](https://docs.didit.me/ko/integration/mcp/authentication.md)을 참고하세요.

***

## 이 MCP로 할 수 있는 일

일상 언어로 요청하세요. 에이전트는 **모든 앱을 한꺼번에** 대상으로 다음 작업을 수행할 수 있습니다.

* *"모든 앱에서 최근 검토 중인 세션 5개를 보여줘."*
* *"지난 15일 동안 전화번호 인증을 시도했지만 중간에 이탈한 사람이 몇 명인가요?"*
* *"신분증 스캔과 라이브니스를 포함한 KYC 워크플로를 만들고, 인증 링크를 알려줘."*
* *"vendor\_data `user_8842`인 고객을 찾아줘. 어느 앱에 속해 있고 상태는 무엇인가?"*
* *"이 지갑의 AML 위험을 스크리닝하고, 위험이 감지되면 차단 목록에 추가해줘."*
* *"내 엔드포인트에서 상태 업데이트를 받을 webhook 대상을 등록해줘."*
* *"이번 달 크레딧 잔액과 전환율은 얼마인가요?"*

***

## 에이전트 시대를 위해 설계됨

대부분의 신원 확인 플랫폼은 콘솔에서 수동 설정이 필요합니다. Didit에서는 에이전트가 **워크플로 구성**, **세션 생성 및 검토**, **webhook 연결**, **결제 모니터링**까지 전 과정을 처음부터 끝까지 수행할 수 있습니다. MCP를 [원프롬프트 연동](https://docs.didit.me/ko/integration/integration-prompt.md)과 함께 사용하면, 에이전트가 MCP 도구를 호출해 워크플로와 세션을 실시간으로 만들면서 완전한 연동(백엔드 라우트 + 프론트엔드 SDK + webhook 핸들러)을 배포할 수 있습니다.

> [card] [설치](https://docs.didit.me/ko/integration/mcp/installation.md)
>
> Claude, Cursor, VS Code, Windsurf, Zed별 설정 및 셀프 호스팅.

> [card] [인증](https://docs.didit.me/ko/integration/mcp/authentication.md)
>
> OAuth 로그인, 범위(scope), 역할.

> [card] [도구 레퍼런스](https://docs.didit.me/ko/integration/mcp/tools.md)
>
> 모든 도구를 영역별로 정리하고, 각 도구의 범위와 역할 권한을 함께 제공합니다.

> [card] [고급 설정 및 문제 해결](https://docs.didit.me/ko/integration/mcp/advanced.md)
>
> 역할, 앱 간 동작, 분기 워크플로, webhook, 셀프 호스팅.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.