Codex 接入手册

把 A大侠注册为 Codex 的本地 MCP 服务。你可以优先使用设置界面，也可以直接编辑 Codex 的统一配置文件。

接入前检查

先启动 A大侠，并确认 http://127.0.0.1:48327/healthz 能得到响应。A大侠与 Codex 必须运行在同一台电脑上。

方法一：在 Codex 设置中添加

1. 进入 Codex 的 Settings，找到 MCP servers，选择添加服务器。
2. 服务器名称填写 a-stock-mcp，连接方式选择 Streamable HTTP。
3. URL 填写 http://127.0.0.1:48327/mcp，保存配置。
4. 重新启动或重新载入 Codex，使新的 MCP 工具进入当前客户端。

方法二：编辑 config.toml

Codex App、CLI 和 IDE 扩展共用同一份 MCP 配置。把下面内容加入 Codex 的 config.toml：

[mcp_servers.a_stock_mcp]
url = "http://127.0.0.1:48327/mcp"
enabled = true

不要把 JSON 粘贴到 TOML 文件

WorkBuddy 使用 JSON，Codex 这里使用 TOML。方括号、等号与字符串引号都需要保留。

确认 Codex 已发现工具

在 Codex CLI 中输入 /mcp，查看服务器列表和工具状态；在 App 或 IDE 中，可以从 MCP 设置查看服务器是否启用。随后用一个明确的只读任务验证：

请检查 a-stock-mcp 提供了哪些工具，先不要执行写入操作；列出 3 个适合查询 A 股行情或公司资料的只读工具。

成功时，/mcp 能看到 a-stock-mcp，且 Codex 能读取工具说明与参数结构。

常见问题

服务器存在，但没有工具

保持 A大侠运行，检查 URL 末尾为 /mcp，然后重启 Codex。仅在浏览器打开 MCP 地址并不能完成 MCP 握手。

配置无法加载

检查 TOML 是否存在重复的同名区块、中文引号或漏写等号。也可以暂时注释其他 MCP 配置，缩小问题范围。

查看完整排错手册

配置方式参考 OpenAI Codex MCP 官方文档。