远端执行器上跑 stdio MCP:experimental_environment = remote

实验项。HTTP MCP 远程放置还没做。source = remote 的环境变量也只有这条路径才读远端。

本地 stdio MCP 默认在 Codex 所在机器起进程。桌面 Remote / 远端执行器要把服务器起在那边时,官方样本是:

[mcp_servers.docs]
command = "docs-server"
args = ["--port", "4000"]
experimental_environment = "remote"
env_vars = ["LOCAL_TOKEN", { name = "REMOTE_TOKEN", source = "remote" }]

env_vars 里字符串和 source = "local" 读本机环境。source = "remote" 读远端执行器环境,而且要求这条 stdio 已经走 remote。本机密钥转发见 stdio env_vars 那条,不要和这条混用。

还没做的:

  • Streamable HTTP 的远程放置(配了 url 再写 experimental_environment = "remote" 不会把 HTTP 服务器搬到远端)
  • http_headers_helper 用在远端连接上(官方只支持本机 HTTP MCP)

没有远端执行器时不要开。先确认 Remote / executor 会话能跑普通 shell,再让慢启动的 stdio 走 remote。本机调试继续默认 local

来源