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

# Cursor MCP 서버 연결 - Didit MCP 서버

> 원클릭 설치 링크 또는 세 줄짜리 mcp.json으로 Cursor에 Didit MCP 서버를 추가한 뒤 Didit으로 로그인하세요. API 키가 필요 없으며 Cursor 에이전트에서 작동합니다.

Cursor는 설치 링크 하나 또는 `mcp.json`의 세 줄 설정으로 호스팅된 Didit MCP 서버(`https://mcp.didit.me/mcp`)에 연결합니다. 처음 사용할 때 Cursor가 브라우저에서 **Log in with Didit**을 엽니다. 복사할 API 키는 없습니다.

> [card] [Cursor에 Didit 추가](https://cursor.com/install-mcp?name=didit\&config=eyJ1cmwiOiJodHRwczovL21jcC5kaWRpdC5tZS9tY3AifQ%3D%3D)
>
> Cursor 설치 페이지를 엽니다. 이 페이지에서 Cursor가 실행되고 URL mcp.didit.me/mcp를 가진 `didit` 서버가 추가됩니다. 설치를 확인한 다음 Didit으로 로그인합니다.

버튼 뒤에 두거나 README에 넣고 싶다면 설치 링크는 다음과 같습니다:

```text theme={null}
https://cursor.com/install-mcp?name=didit&config=eyJ1cmwiOiJodHRwczovL21jcC5kaWRpdC5tZS9tY3AifQ%3D%3D
```

이 링크는 Cursor 딥링크를 감싼 것이며, 딥링크를 직접 사용할 수도 있습니다:

```text theme={null}
cursor://anysphere.cursor-deeplink/mcp/install?name=didit&config=eyJ1cmwiOiJodHRwczovL21jcC5kaWRpdC5tZS9tY3AifQ==
```

`config` 값은 `{"url":"https://mcp.didit.me/mcp"}`를 base64로 인코딩한 값입니다.

***

## 방법별 설정

> [tab] 설치 링크
>
> 1. [**Cursor에 Didit 추가 →**](https://cursor.com/install-mcp?name=didit\&config=eyJ1cmwiOiJodHRwczovL21jcC5kaWRpdC5tZS9tY3AifQ%3D%3D)를 클릭합니다. 브라우저가 Cursor를 열어도 되는지 물으면 허용합니다.
> 2. Cursor에 URL `https://mcp.didit.me/mcp`를 사용하는 `didit` 서버가 표시됩니다. 설치를 확인합니다.
> 3. Cursor가 `didit`에 로그인이 필요하다고 표시하면 클릭해 연결하고, 브라우저에서 **Log in with Didit**를 완료합니다.
>
> Cursor가 열리지 않으면 설치 페이지에 구성 정보가 표시됩니다. 이 정보를 `mcp.json`에 직접 붙여 넣으십시오.

> [tab] mcp.json
>
> `~/.cursor/mcp.json`(모든 프로젝트) 또는 `.cursor/mcp.json`(프로젝트 하나)에 Didit를 추가합니다:
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "didit": {
>       "url": "https://mcp.didit.me/mcp"
>     }
>   }
> }
> ```
>
> 이미 사용 중인 서버는 `mcpServers` 안에 그대로 유지합니다. 처음 사용할 때 Cursor는 Didit에 자동으로 등록하고, **Log in with Didit**를 위해 브라우저를 엽니다.

> [tab] 명령줄
>
> `cursor` 명령으로 서버를 사용자 프로필에 추가할 수 있습니다:
>
> ```bash theme={null}
> cursor --add-mcp '{"name":"didit","type":"http","url":"https://mcp.didit.me/mcp"}'
> ```
>
> `Added MCP servers: didit`가 출력됩니다. Cursor를 열고, 로그인을 요청하는 메시지가 표시되면 로그인합니다.

> [!NOTE]
>
> **구성에 API 키가 없습니다.** 이 서버는 OAuth 2.1과 PKCE를 사용하며 **사용자**를 대신해 동작합니다. 로그인할 때 승인한 조직에서만, 그리고 사용자 역할의 권한에 따라 동작합니다. 자세한 내용은 [인증](https://docs.didit.me/ko/integration/mcp/authentication.md)을 참조하십시오.

***

## 작동 확인

Cursor의 에이전트 채팅에서 다음과 같이 요청하세요:

```text theme={null}
Use the Didit MCP server to call didit_context_get and list my organizations and applications.
```

에이전트가 `didit_context_get`을 호출하고 내 조직과 각 조직의 애플리케이션 목록을 보여줍니다. 그다음 코드베이스에서 다음 작업을 시켜 보세요:

* "신분증 인증과 라이브니스 감지가 포함된 샌드박스 KYC 워크플로를 만든 다음, 그 워크플로를 사용해서 이 앱에 Didit 웹 SDK를 추가해 줘."
* "세션 상태 업데이트를 받을 webhook 대상을 내 `/api/didit/webhook` 라우트로 등록하고, 서명을 검증하는 핸들러를 작성해 줘."
* "`user_123`에 대한 테스트 세션을 만들고 인증 링크를 알려 줘."

***

## 문제 해결

* **Cursor가 링크에서 열리지 않습니다.** 대신 **mcp.json** 탭의 JSON을 붙여넣으세요.
* **로그인이 반복되거나 실패합니다.** 먼저 기본 브라우저에서 [business.didit.me](https://business.didit.me)에 로그인한 다음 다시 연결하세요.
* **도구가 `missing_scope`로 응답합니다.** 해당 조직에서 사용자의 역할에 필요한 권한이 없습니다. [역할 및 권한](https://docs.didit.me/ko/integration/mcp/authentication.md#역할과-권한)을 참고하세요.
* **에이전트가 Didit 도구가 없다고 합니다.** Cursor의 MCP 설정에서 `didit` 서버가 활성화되어 있고 로그인이 완료되었는지 확인하세요. [문제 해결](https://docs.didit.me/ko/integration/mcp/advanced.md#문제-해결)을 참고하세요.

***

## 다음 단계

> [card] [VS Code 연결](https://docs.didit.me/ko/integration/mcp/vscode.md)
>
> GitHub Copilot용 VS Code 설치 링크와 mcp.json을 안내합니다.

> [card] [OpenAI Codex 연결](https://docs.didit.me/ko/integration/mcp/codex.md)
>
> Codex CLI와 IDE 확장 프로그램을 위한 명령어 한 줄을 안내합니다.

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

> [card] [단일 프롬프트 연동](https://docs.didit.me/ko/integration/mcp/examples.md)
>
> 에이전트가 Didit 연동을 구축하는 실제 예시입니다.


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