> ## 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.

# ChatGPT에 Didit MCP 서버 연결

> ChatGPT 디렉터리에서 Didit 플러그인을 설치하거나 mcp.didit.me/mcp를 커스텀 MCP 서버로 추가하세요. API 키 없이 Didit 계정으로 로그인합니다.

> [card] [Didit 플러그인 설치](https://chatgpt.com/plugins/plugin_asdk_app_6a432adffe488191bae655d50a6a0d4c)
>
> ChatGPT 플러그인 디렉터리의 Didit 목록을 엽니다. **Install plugin**을 클릭한 후 Didit으로 로그인합니다.

> [card] [전체 MCP 서버 추가](#didit을-커스텀-mcp-서버로-추가하기)
>
> 역할에 허용된 모든 Didit 도구를 URL로 사용자 지정 MCP 서버에 추가합니다.

Didit은 ChatGPT에서 두 가지 방법으로 사용할 수 있습니다. ChatGPT 플러그인 디렉터리에서 **Didit 플러그인**을 설치하거나, 호스팅된 Didit MCP 서버(`https://mcp.didit.me/mcp`)를 **사용자 지정 MCP 서버**로 추가할 수 있습니다. 두 방법 모두 OAuth를 통해 Didit 계정으로 로그인하므로 복사해서 입력할 API 키가 없습니다.

***

## 어떤 방식을 사용할지

| | Didit 플러그인(디렉터리) | 커스텀 MCP 서버 |
| - | - | - |
| 추가 방법 | **Plugins**, "Didit" 검색, **Install plugin** | **Plugins → Add → Add custom MCP server**, URL `https://mcp.didit.me/mcp` |
| OpenAI 검토 여부 | 예, Didit Identity, Inc.가 게시 | 아니요, 직접 추가합니다 |
| 제공 기능 | 인증 링크, 세션과 세션 상태, 워크플로와 설문지, 케이스와 보고서 상태, webhook 대상, 집계 분석 | [Claude](https://docs.didit.me/ko/integration/mcp/claude.md)와 동일한 호스팅 서버 및 도구 카탈로그를 제공하며, 콘솔 역할에 따라 제한됩니다 |
| 제외되는 항목 | 문서 및 얼굴 업로드, 정부 발급 신분증 번호 입력, 일회용 코드, 원본 API 키, 결제 체크아웃. 신원 증빙, 이미지, 비공개 메모와 보고서 내용은 응답에 포함되지 않습니다 | 역할에서 허용되지 않는 항목, 그리고 호스팅 서버가 모든 커넥터에서 제외하는 항목만 해당됩니다 |
| 권장 대상 | ChatGPT를 사용하는 운영 및 지원 팀 | 전체 도구 세트가 필요한 개발자 및 컴플라이언스 담당자 |

두 방식 모두 **사용자 본인**으로 동작합니다. 로그인 시 승인한 조직 내에서만, 그리고 역할에 부여된 권한 범위 안에서만 동작합니다.

***

## Didit 플러그인 설치

1. ChatGPT에서 사이드바의 **Plugins**를 열고 **Didit**을 검색하거나, [Didit 목록](https://chatgpt.com/plugins/plugin_asdk_app_6a432adffe488191bae655d50a6a0d4c)을 직접 엽니다. 목록에는 **Business & Operations** 카테고리 아래 **By Didit Identity, Inc.**가 표시됩니다.
2. **Install plugin**을 클릭합니다.
3. ChatGPT에 **Log in with Didit**이 열립니다. ChatGPT가 사용할 조직을 선택하고, 권한을 검토한 다음 **Approve**를 클릭합니다.

목록에 있는 예시 프롬프트 중 하나로 사용해 보세요:

* "새 고객에게 보낼 인증 링크를 만들어 줘."
* "지난 30일 동안의 인증 세션을 상태별로 요약해 줘."
* "내 인증 워크플로를 보여 주고, 구성된 단계를 설명해 줘."

고객은 Didit의 호스팅 인증 페이지에서 신원 확인을 완료합니다. ChatGPT는 인증 링크, 상태, 날짜 및 건수만 확인합니다.

***

## Didit을 커스텀 MCP 서버로 추가하기

Didit의 전체 도구 세트를 ChatGPT에서 사용하려면 이 방법을 쓰세요. 워크플로 구축, AML 스크리닝, 거래 모니터링, 목록 관리 등 나머지 기능까지 모두 사용할 수 있습니다. 전체 목록은 [도구 레퍼런스](https://docs.didit.me/ko/integration/mcp/tools.md)를 참고하세요.

**1. 커스텀 서버 대화상자 열기**

ChatGPT에서 **Plugins**를 열고 **Add**를 클릭한 다음 **Add custom MCP server**를 선택합니다.

**Add custom MCP server**가 보이지 않으면 현재 요금제나 워크스페이스에서 아직 커스텀 MCP 서버를 사용할 수 없는 것입니다. Business 또는 Enterprise 워크스페이스라면 관리자에게 이 기능을 활성화해 달라고 요청하세요.

**2. 서버 정보 입력하기**

* **Name**: `Didit MCP`. ChatGPT는 기존 앱이 이미 사용 중인 이름을 받지 않으며, 디렉터리 플러그인의 이름은 `Didit`입니다.
* **Description** (선택 사항): `Identity verification, KYB, AML screening and fraud checks`
* **Connection**: **Server URL**을 선택한 다음 아래 주소를 붙여 넣습니다.

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

* **Authentication**: **OAuth**를 선택합니다.

ChatGPT는 서버에서 OAuth 설정을 스스로 읽어 옵니다. **Advanced OAuth settings**에서 Didit 인가 엔드포인트와 `didit:management`, `didit:verification` 같은 Didit 스코프가 이미 채워져 있는 것을 확인할 수 있습니다. 그대로 두세요.

**3. 생성하고 연결하기**

**I understand and want to continue**를 체크한 다음 **Create as a plugin**을 클릭하고, 이어서 **Connect Didit MCP**를 클릭합니다.

**4. Didit으로 로그인하기**

ChatGPT가 **Log in with Didit** 페이지로 이동합니다. 연결할 조직을 선택하고, ChatGPT에 허용될 작업을 검토한 뒤 **Approve**를 클릭합니다. 그러면 ChatGPT로 돌아오며, **Installed** 아래에 **Didit MCP**가 표시됩니다.

> [!NOTE]
>
> **API 키가 전혀 필요 없습니다.** 서버는 PKCE를 사용하는 OAuth 2.1을 사용합니다. ChatGPT는 Client ID Metadata Document로 자신을 식별하므로 붙여 넣을 클라이언트 ID나 시크릿이 없습니다. [인증](https://docs.didit.me/ko/integration/mcp/authentication.md)을 참고하세요.

***

## 작동 확인

채팅을 시작하고 다음과 같이 질문하세요:

```text theme={null}
Use the Didit MCP app: call didit_context_get and list my Didit organizations and their applications. Read-only, do not change anything.
```

ChatGPT가 `didit_context_get`을 호출하고, 승인한 각 조직과 해당 조직의 애플리케이션, 그리고 각 애플리케이션이 프로덕션 환경인지 샌드박스인지를 답합니다. Didit 도구가 없다고 답하면 로그인이 완료되지 않은 것입니다. **Plugins**를 열고 **Installed** 아래에서 **Didit MCP**를 선택한 뒤 다시 연결하세요.

그다음 실제 작업을 시도해 보세요:

* "신분증 인증, 패시브 라이브니스, AML 스크리닝을 포함한 KYC 워크플로를 만들고 인증 링크를 알려 줘."
* "검토 대기열에 있는 세션은 무엇이며, 각 세션이 플래그된 이유는 무엇인지 알려 줘."
* "이 지갑을 AML 위험에 대해 스크리닝하고, 위험이 감지되면 차단 목록에 추가해 줘."

ChatGPT는 도구가 무언가를 변경하기 전에 확인을 요청합니다. 쓰기 및 삭제 작업에 대해서는 이 확인 설정을 계속 켜 두세요.

***

## 문제 해결

* **"이 이름의 앱이 이미 존재합니다."** 다른 이름을 선택하세요. 예: `Didit MCP`.
* **로그인이 반복되거나 실패합니다.** 같은 브라우저에서 먼저 [business.didit.me](https://business.didit.me)에 로그인한 다음 **Connect**를 다시 클릭하세요.
* **도구가 `missing_scope`로 응답합니다.** 해당 조직에서 사용자의 역할에 이 권한이 없습니다. 소유자 또는 관리자에게 문의하세요. 자세한 내용은 [역할 및 권한](https://docs.didit.me/ko/integration/mcp/authentication.md#역할과-권한)을 참조하세요.
* **잘못된 조직들을 승인했습니다.** [business.didit.me](https://business.didit.me)에 로그인한 후 **Account settings → Connected apps**를 열고, ChatGPT의 연결을 취소한 다음 다시 연결하여 올바른 조직들을 선택하세요.

***

## 다음 단계

> [card] [Claude 연결](https://docs.didit.me/ko/integration/mcp/claude.md)
>
> Claude 웹, 데스크톱 및 Code용 원클릭 커넥터 링크입니다.

> [card] [Cursor 연결](https://docs.didit.me/ko/integration/mcp/cursor.md)
>
> Cursor용 원클릭 설치 링크와 mcp.json입니다.

> [card] [도구 레퍼런스](https://docs.didit.me/ko/integration/mcp/tools.md)
>
> 에이전트가 호출할 수 있는 모든 도구를 도구별로 정리했습니다.

> [card] [예시 프롬프트](https://docs.didit.me/ko/integration/mcp/examples.md)
>
> 실제 페이로드를 사용한 더 긴 실습 예시입니다.


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