远端执行器上跑 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。