MCP configuration
Connect an agent to Subshell's stdio MCP server.
Before you start
Launch the agent inside a Subshell pane. The MCP process needs SUBSHELL_API_KEY and SUBSHELL_ID, supplied by the host, plus the injected server address and state directory.
Don't paste pane credentials into shared configuration or copy them to another session. The credential identifies the pane's owner and is revoked when the pane is stopped.
Automatic integration
Claude Code, Codex, OpenCode, and Oh My Pi receive per-launch MCP configuration. Open the agent's tool list and verify that the subshell server exposes list_subshells.
The compiled server and node binaries both include an mcp subcommand. The host resolves which executable exists on the machine where the pane runs.
Manual integration
Gemini CLI, Qwen Code, Cline, Open Interpreter, OpenHands, Grok Build, Hermes, and pi require one-time host setup. In the server dashboard's sidebar, choose Settings → Presets → New preset → New agent preset and select the agent. Find Cross-subshell comms near the bottom of the form for the registration commands. Run those commands on the machine where that agent will execute. See Gemini CLI, Qwen Code, Cline, Open Interpreter, OpenHands, Grok Build, Hermes Agent, and pi.
For a node with subshell on PATH, a standard registration has this shape:
{
"mcpServers": {
"subshell": { "command": "subshell", "args": ["mcp"] }
}
}Use subshell-server or the displayed absolute executable where that is the resolved host command. The MCP host must forward the pane's identity environment to the child process. Codex requires an explicit env_vars allowlist; see MCP troubleshooting if its registration omits that list.
OpenClaw appears in neither the automatic nor the manual list: its cross-subshell comms are not wired yet. OpenClaw stores MCP registrations in the Gateway-scoped config that every OpenClaw session on the host shares, while a Subshell MCP child carries one pane's credential from spawn, so a shared registration would leak that pane's identity across sessions. See OpenClaw.
Verify
Ask the agent to call list_subshells without modifying any session. A stdio MCP process may wait for protocol messages; running it by hand isn't a general health-check command.
Next steps
Read Coordinate agents and MCP troubleshooting.
Edit on GitHubLast updated on
