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

# Claude에 Didit MCP 서버 연결하기

> 원클릭으로 Claude에 Didit MCP 서버를 추가하세요. 커넥터 링크가 설정 창을 미리 채우며, OAuth로 Didit에 로그인합니다. API 키가 필요 없고 도구는 169개입니다.

Claude는 링크 하나로 호스팅된 Didit MCP 서버에 연결됩니다. 링크를 클릭하고, 미리 채워진 대화상자를 확인한 뒤, Didit 계정으로 로그인하세요. 복사할 API 키도, 설치할 항목도 없습니다.

> [card] [Claude에 Didit 추가](https://claude.ai/customize/connectors?modal=add-custom-connector\&connectorName=Didit\&connectorUrl=https://mcp.didit.me/mcp)
>
> Add custom connector 대화상자가 미리 채워진 상태로 claude.ai가 열립니다. 이름은 Didit, URL은 mcp.didit.me/mcp입니다. 확인하고, Didit으로 로그인하면 완료됩니다.

커넥터 전체 링크입니다. 공유하거나 직접 만든 버튼에 연결하고 싶다면 사용하세요:

```text theme={null}
https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=Didit&connectorUrl=https://mcp.didit.me/mcp
```

이 링크는 [Business Console](https://business.didit.me)의 연동 페이지에 표시되는 링크와 같습니다.

MCP Academy 강의의 1:42 챕터에서는 이 흐름 전체를 보여 줍니다. Claude에 커넥터를 추가하는 과정, OAuth 로그인, 그리고 채팅에 도구가 나타나는 모습입니다.

[Claude에서 커넥터 추가하기, Didit Academy](https://www.youtube.com/embed/I3UkFIhW548?start=102\&rel=0\&playsinline=1)

***

## 플랫폼별 설정

> [tab] Claude 웹
>
> 1. [**Didit을 Claude에 추가 →**](https://claude.ai/customize/connectors?modal=add-custom-connector\&connectorName=Didit\&connectorUrl=https://mcp.didit.me/mcp)를 클릭합니다. 모든 필드가 채워진 **Add custom connector** 대화상자가 열립니다.
> 2. 대화상자를 확인합니다.
> 3. 브라우저에서 **Didit으로 로그인**을 완료하고 권한을 승인합니다.
>
> 그러면 Didit 도구가 채팅의 도구 메뉴에 표시되며, 읽기 전용, 쓰기, 파괴적 작업 그룹으로 나뉩니다. 수동으로 추가하려면 **Settings → Connectors → Add custom connector**로 이동해 이름에 `Didit`, URL에 `https://mcp.didit.me/mcp`를 입력하세요.

> [tab] Claude 데스크톱
>
> 1. **Settings → Connectors → Add custom connector**를 엽니다.
> 2. 이름을 `Didit`으로 입력하고 URL을 다음과 같이 설정합니다:
>
> ```text theme={null}
> https://mcp.didit.me/mcp
> ```
>
> 3. **Connect**를 클릭하고 브라우저에서 **Didit으로 로그인**을 완료합니다.

> [tab] Claude Code
>
> CLI로 서버를 추가한 다음 로그인을 시작합니다:
>
> ```bash theme={null}
> claude mcp add --transport http didit https://mcp.didit.me/mcp
> ```
>
> Claude Code를 시작하고 `/mcp`를 실행하세요. 그러면 브라우저가 열리며 **Didit으로 로그인**이 표시됩니다. 승인하면 `didit` 도구를 사용할 수 있습니다. `claude mcp list`로 서버와 연결 상태를 확인할 수 있습니다.

> [!NOTE]
>
> **어디에도 API 키가 없습니다.** 호스팅 서버는 OAuth 2.1과 PKCE를 사용하며 **사용자 본인**으로 동작합니다. 소속된 모든 조직에서 역할별 권한으로 `didit:management` 및 `didit:verification` 스코프를 사용합니다. 자세한 내용은 [인증](https://docs.didit.me/ko/integration/mcp/authentication.md)을 참고하세요.

***

## 연결 후 Claude가 할 수 있는 작업

로그인한 사용자에게는 세션, 워크플로, 단독 검사, 거래 모니터링, 케이스, 분석 등에 걸쳐 **169개 도구**가 보입니다. 첫날부터 바로 사용할 수 있는 프롬프트는 다음과 같습니다:

* "신분증 인증, 패시브 라이브니스, AML 스크리닝을 포함한 KYC 워크플로를 만들고 인증 링크를 알려 줘."
* "검토 대기열에 있는 세션을 보여 주고, 각 세션의 경고를 요약해 줘."
* "1시간 안에 \$1,000를 초과하는 이체가 3건을 넘으면 표시하는 거래 모니터링 규칙을 작성하고, 지난 90일 데이터로 백테스트해 줘."
* "이번 달에 거부된 세션이 가장 많은 국가는 어디야?"

[MCP Academy 강의](https://www.youtube.com/watch?v=I3UkFIhW548)에서는 실제 계정에서 위 프롬프트를 각각 실행해 보여 줍니다.

***

## 문제 해결

* **대화상자가 비어 있게 열립니다.** 쿼리 문자열이 빠진 링크를 따라갔습니다. 이 페이지의 전체 커넥터 링크를 붙여 넣거나, URL `https://mcp.didit.me/mcp`를 사용해 수동으로 커넥터를 추가하세요.
* **로그인이 반복되거나 실패합니다.** 먼저 [business.didit.me](https://business.didit.me)에 로그인한 다음 다시 연결하세요. MCP 서버는 같은 계정으로 인증합니다.
* **도구가 `missing_scope`로 응답합니다.** 해당 조직에서 사용자 역할에는 도구에 필요한 권한이 없습니다. 오류 메시지에 권한 이름이 표시됩니다. 소유자 또는 관리자에게 권한 부여를 요청하세요. 자세한 내용은 [인증](https://docs.didit.me/ko/integration/mcp/authentication.md#역할과-권한)을 참고하세요.
* **`didit_org_top_up` 또는 `didit_org_reveal_application_api_key`를 찾을 수 없습니다.** 두 도구는 의도적으로 호스팅 커넥터에서 숨겨져 있습니다. 크레딧 충전과 API 키 확인은 콘솔에서 하세요.

***

## 다음 단계

> [card] [도구 참조](https://docs.didit.me/ko/integration/mcp/tools.md)
>
> Claude가 호출할 수 있는 모든 도구를 하나씩 정리했습니다.

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

> [card] [다른 클라이언트](https://docs.didit.me/ko/integration/mcp/installation.md)
>
> Cursor, VS Code, Windsurf, Zed 및 자체 호스팅 방법입니다.

> [card] [인증](https://docs.didit.me/ko/integration/mcp/authentication.md)
>
> OAuth 흐름, 스코프, 역할을 설명합니다.


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