---
title: "远端执行器上跑 stdio MCP：experimental_environment = remote"
summary: "实验项。HTTP MCP 远程放置还没做。source = remote 的环境变量也只有这条路径才读远端。"
category: mcp
level: advanced
surfaces: [cli, app]
tags: ["MCP", "stdio", "Remote"]
canonical: /tips/mcp-stdio-remote-executor/
---

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

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

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

```toml
[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`。

## 来源

- [OpenAI · Model Context Protocol](https://learn.chatgpt.com/docs/extend/mcp)
- [OpenAI · Sample configuration](https://learn.chatgpt.com/docs/config-file/config-sample)