> ## Documentation Index
> Fetch the complete documentation index at: https://docs.molesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 接入 Codex

> 通过 OAuth 2.1 或 API Token，将 Codex CLI 与 Codex App 接入 MoleSignal Inbound MCP。

Codex 支持 MoleSignal 的 Streamable HTTP 端点与 OAuth 自动发现。

## 使用 OAuth 2.1

<Steps>
  <Step title="注册 MoleSignal">
    ```bash theme={null}
    codex mcp add molesignal \
      --url https://molesignal.example.com/api/v1/mcp
    ```
  </Step>

  <Step title="授权连接">
    ```bash theme={null}
    codex mcp login molesignal
    ```

    在浏览器中完成 MoleSignal 授权。
  </Step>

  <Step title="验证 Server">
    ```bash theme={null}
    codex mcp get molesignal
    codex mcp list
    ```

    重启当前 Codex 任务或创建新任务，让 MCP Tool 列表重新加载。
  </Step>
</Steps>

<Warning>
  不要添加 `--oauth-resource`。MoleSignal 已通过 OAuth 发现元数据发布受保护资源；再次添加相同
  值可能触发 `duplicate field resource`。
</Warning>

## 使用 API Token

非交互 Codex 进程可以使用个人或 Service Account API Token：

```bash theme={null}
export MOLESIGNAL_MCP_TOKEN="<api-token>"

codex mcp add molesignal \
  --url https://molesignal.example.com/api/v1/mcp \
  --bearer-token-env-var MOLESIGNAL_MCP_TOKEN
```

Codex 保存环境变量名，不保存 Token 值。启动 Codex 的进程必须可以读取该变量。

## 验证 Tool 发现

向 Codex 输入：

> 使用 MoleSignal MCP Server，搜索事件相关 Tool 并列出活动事件，不要执行任何变更。

首次请求应先使用 `tool_search`，再通过 `call_read_tool` 执行延迟发现的读取。

参见 [Codex MCP 官方文档](https://developers.openai.com/codex/mcp/)。