Codex 接入

August 11, 2026 · View on GitHub

在 OpenAI Codex 中使用 DeepSeek Visionary MCP server。

一键接入（推荐）

visionary-server init codex

优先调用 codex mcp add 注册；若 codex CLI 不可用，则回退写入 ~/.codex/config.toml。

手动配置

方式 A：CLI（推荐）

codex mcp add deepseek-visionary -- visionary-server mcp-stdio

注意 -- 分隔符形式：codex mcp add <name> -- <command> [args...]。 旧文档中的 --command flag 形式已过时。

方式 B：直接编辑 config.toml

在 ~/.codex/config.toml 中添加：

[mcp_servers.deepseek-visionary]
command = "visionary-server"
args = ["mcp-stdio"]

键名必须是 mcp_servers（不是 mcp.servers）。mcp.servers 会被 Codex 静默忽略（GitHub issue #3441），配置看起来生效实则无效。

验证

codex mcp list

或直接问 Codex "你能用 deepseek_vision 工具吗"。

常见问题

  • 配置后无工具：检查键名是否为 mcp_servers（mcp.servers 静默失效）。
  • 未登录：调用 deepseek_vision 前先调用 deepseek_vision_login，或用环境变量 DEEPSEEK_USER_TOKEN。
  • 二进制不在 PATH：确认 visionary-server 在 PATH；或用绝对路径： 
    [mcp_servers.deepseek-visionary]
command = "/path/to/visionary-server"
args = ["mcp-stdio"]