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

# OpenAI Codex에 Didit MCP 서버 연결하기

> 한 번의 명령어 codex mcp add didit --url https://mcp.didit.me/mcp로 Didit MCP 서버를 OpenAI Codex에 추가한 뒤 Didit으로 로그인하세요. API 키는 필요하지 않습니다.

OpenAI Codex는 명령어 한 줄로 호스팅된 Didit MCP 서버(`https://mcp.didit.me/mcp`)에 연결합니다. 그러면 Codex가 브라우저에서 **Log in with Didit**를 열고 로그인 정보를 저장합니다. 복사할 API 키는 없습니다. 같은 설정이 Codex CLI와 Codex IDE 확장 프로그램 모두에 적용됩니다.

```bash theme={null}
codex mcp add didit --url https://mcp.didit.me/mcp
```

***

## 설정

**1. 서버 추가**

```bash theme={null}
codex mcp add didit --url https://mcp.didit.me/mcp
```

Codex가 서버를 `~/.codex/config.toml`에 기록하고, OAuth가 필요하다는 것을 확인한 뒤 바로 로그인을 시작합니다. 로그인을 취소하면 나중에 `codex mcp login didit`을 실행하세요.

**2. Didit에 로그인**

브라우저에서 **Codex가 Didit 계정에 접근하려고 합니다** 창이 열립니다. 연결할 조직을 선택하고, 권한을 검토한 다음 **승인**을 클릭하세요. 터미널에 `Successfully logged in to MCP server 'didit'.`가 출력됩니다.

**3. 확인**

```bash theme={null}
codex mcp list
```

`didit` 행에 상태 `enabled`, 인증 `OAuth`가 표시됩니다.

파일을 직접 편집하고 싶으신가요? 다음은 `~/.codex/config.toml`의 항목 전체입니다:

```toml theme={null}
[mcp_servers.didit]
url = "https://mcp.didit.me/mcp"
```

그런 다음 `codex mcp login didit`을 실행하여 로그인하세요.

> [!NOTE]
>
> **설정 파일에 API 키가 없습니다.** 이 서버는 PKCE를 사용하는 OAuth 2.1을 사용하며, **사용자 본인**으로서 동작합니다. 로그인할 때 승인한 조직에서만, 그리고 사용자 역할에 부여된 권한으로만 동작합니다. Codex는 Client ID Metadata Document로 자신을 식별합니다. [인증](https://docs.didit.me/ko/integration/mcp/authentication.md)을 참조하세요.

***

## 작동 확인

서버 이름을 지정하여 Codex를 시작하고 다음과 같이 질문합니다.

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

Codex는 MCP 도구를 필요할 때 로드하므로, 첫 프롬프트에서 Didit 서버 또는 도구 이름을 명시하세요. 그러면 Codex가 `didit_context_get`을 호출하고 조직과 각 조직의 애플리케이션 목록을 보여줍니다.

세션을 집중된 상태로 유지하려면 `enabled_tools`로 Codex가 사용할 도구를 필요한 것으로만 제한하세요.

```toml theme={null}
[mcp_servers.didit]
url = "https://mcp.didit.me/mcp"
enabled_tools = ["didit_context_get", "didit_session_create", "didit_session_list", "didit_session_get_decision"]
```

`disabled_tools`는 반대로 동작합니다. 도구 이름은 [도구 레퍼런스](https://docs.didit.me/ko/integration/mcp/tools.md)에서 확인할 수 있습니다.

***

## 문제 해결

* **`codex mcp list`에서 `Not logged in`이 표시되는 경우.** `codex mcp login didit`을 실행하고 브라우저에서 로그인을 완료하십시오.
* **브라우저가 없는 원격 머신에서 사용하는 경우.** `codex mcp login didit`을 실행하고, 출력된 URL을 본인의 컴퓨터에서 여십시오. 로그인이 완료될 때까지 터미널을 계속 실행해 두십시오. 콜백은 Codex를 실행 중인 머신의 로컬 포트로 전달되므로, 필요하면 해당 포트를 포워딩하십시오.
* **도구가 `missing_scope`로 응답하는 경우.** 해당 조직에서 사용자의 역할에 해당 권한이 없습니다. [역할 및 권한](https://docs.didit.me/ko/integration/mcp/authentication.md#역할과-권한)을 참조하십시오.
* **로그아웃하려면:** `codex mcp logout didit`를 실행하십시오.

***

## 다음 단계

> [card] [ChatGPT 연결](https://docs.didit.me/ko/integration/mcp/chatgpt.md)
>
> ChatGPT 디렉터리의 Didit 플러그인 또는 전체 서버를 커스텀 MCP 서버로 연결하는 방법입니다.

> [card] [Claude 연결](https://docs.didit.me/ko/integration/mcp/claude.md)
>
> Claude 웹, Desktop, Code에서 사용할 수 있는 원클릭 커넥터 링크입니다.

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

> [card] [프롬프트 예시](https://docs.didit.me/ko/integration/mcp/examples.md)
>
> 실제 payload가 포함된 자세한 작업 예시입니다.


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