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

# 将 Didit MCP 服务器连接到 OpenAI Codex

> 使用一条命令 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/zh/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`，并列出您的组织及其应用。

如需让会话保持专注，可以使用 `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/zh/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/zh/integration/mcp/authentication.md#角色与权限)。
* **退出登录：** `codex mcp logout didit`。

***

## 下一步

> [card] [连接 ChatGPT](https://docs.didit.me/zh/integration/mcp/chatgpt.md)
>
> ChatGPT 目录中的 Didit 插件，或可作为自定义 MCP 服务器使用的完整服务器。

> [card] [连接 Claude](https://docs.didit.me/zh/integration/mcp/claude.md)
>
> 适用于 Claude 网页版、桌面版和 Code 的一键连接器链接。

> [card] [工具参考](https://docs.didit.me/zh/integration/mcp/tools.md)
>
> 智能体可以调用的所有工具，逐个工具说明。

> [card] [示例提示词](https://docs.didit.me/zh/integration/mcp/examples.md)
>
> 包含真实 payload 的较长完整示例。


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