> ## 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 к MCP-серверу Didit

> Добавьте MCP-сервер Didit в OpenAI Codex одной командой: codex mcp add didit --url https://mcp.didit.me/mcp, затем войдите через Didit. API-ключ не нужен.

OpenAI Codex подключается к размещённому MCP-серверу Didit (`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**. Выберите организации для подключения, проверьте права доступа и нажмите **Approve**. В терминале появится сообщение `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-ключа.** Сервер использует OAuth 2.1 с PKCE и действует **от вашего имени**: только в тех организациях, которые вы одобрите при входе, и с правами вашей роли. Codex идентифицирует себя с помощью Client ID Metadata Document. См. [Аутентификация](https://docs.didit.me/ru/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 или нужный инструмент. Он вызывает `didit_context_get` и выводит список ваших организаций с их приложениями.

Чтобы сессия оставалась сфокусированной, ограничьте Codex только нужными инструментами с помощью `enabled_tools`:

```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/ru/integration/mcp/tools.md).

***

## Устранение неполадок

* **`Not logged in` в выводе `codex mcp list`.** Выполните `codex mcp login didit` и завершите вход в браузере.
* **На удалённой машине без браузера.** Выполните `codex mcp login didit`, откройте выведенный URL на своём компьютере и не закрывайте терминал до завершения входа. Обратный вызов отправляется на локальный порт машины, на которой запущен Codex, поэтому при необходимости пробросьте этот порт.
* **Инструмент возвращает `missing_scope`.** У вашей роли в этой организации нет нужного разрешения. См. [роли и разрешения](https://docs.didit.me/ru/integration/mcp/authentication.md#роли-и-разрешения).
* **Чтобы выйти из системы:** `codex mcp logout didit`.

***

## Следующие шаги

> [card] [Подключение ChatGPT](https://docs.didit.me/ru/integration/mcp/chatgpt.md)
>
> Плагин Didit в каталоге ChatGPT или полный сервер как пользовательский MCP-сервер.

> [card] [Подключение Claude](https://docs.didit.me/ru/integration/mcp/claude.md)
>
> Ссылка для подключения коннектора одним кликом в Claude Web, Desktop и Code.

> [card] [Справочник инструментов](https://docs.didit.me/ru/integration/mcp/tools.md)
>
> Все, что агент может вызвать, инструмент за инструментом.

> [card] [Примеры промптов](https://docs.didit.me/ru/integration/mcp/examples.md)
>
> Развёрнутые примеры с реальными payload.


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