Native SSE transport support for MCP servers
Resolved 💬 25 comments Opened Aug 10, 2025 by nakamurau1 Closed Jan 30, 2026
💡 Likely answer: A maintainer (etraut-openai, contributor)
responded on this thread — see the highlighted reply below.
Summary
Currently, Codex only supports MCP servers that communicate over stdio. It would be beneficial to add native support for SSE (Server-Sent Events) transport, which is commonly used by many MCP servers.
Current Situation
- Codex can only connect to MCP servers using stdio transport
- For SSE-based MCP servers, users need to use an adapter like https://github.com/sparfenyuk/mcp-proxy
- This adds complexity and an additional dependency to the setup
Proposed Solution
Add native SSE transport support to the MCP client implementation in Codex, allowing direct connection to SSE-based MCP servers without requiring an adapter.
Benefits
- Simplified Setup: Users can directly connect to SSE-based MCP servers without additional adapters
- Better Performance: Removes the overhead of protocol translation through adapters
- Broader Compatibility: Many MCP servers use SSE transport, and native support would improve Codex's ecosystem compatibility
- Consistent with Other MCP Clients: Tools like Claude Desktop and Cursor support both stdio and SSE transports
Implementation Considerations
- The SSE transport implementation could be added alongside the existing stdio transport in the mcp-client module
- Configuration format in config.toml could be extended to specify transport type:
[mcp_servers.server-name]
transport = "sse" # or "stdio" (default)
url = "http://localhost:3000/sse"
# ... other SSE-specific config
Related Context
- MCP specification includes both stdio and SSE as standard transports
- Current workaround using mcp-proxy adds complexity for users
- No existing issues or PRs found addressing SSE transport support
Would this feature be considered for future development? Happy to provide more details or help with implementation if needed.
25 Comments
For what it’s worth this feature is a dealbreaker for me, personally.
When support?
In the implementation considerations... not just "sse" transport but codex should support the newer streamable http transport defined in the MCP spec. Ideally codex cli would have transport parameter support of
"http", "sse", and "stdio" (default)Is this feature not yet officially released?
Right, it still needs approval. Pity, as I refuse to use stdio MCP servers due to security concerns.
Major blocker for me too.
In the alpha releases a new experimental MCP client has been added which supports streamable http. So it looks like this is coming from the OpenAI Devs.
They finally added
[mcp_servers.<mcp-name>]
url = "<url>"
bearer_token = "<token>"
Version 0.44.0
https://github.com/openai/codex/pull/4317
@gu-benites i dont think that is working:
@jakeleventhal Did you try streamable http rather than sse? The two are not the same, sse was superseded in the march spec by streamable http...
https://mcp.linear.app/mcphttps://linear.app/docs/mcp
@ben-vargas
It also doesn't seem to have any documentation: https://github.com/openai/codex/blob/main/docs/advanced.md#model-context-protocol-mcp
Has this issue still not been resolved in the latest version, 0.46.0?
@galoi - working fine for me in 0.46.0 using streamable http MCP servers, including my own custom one requiring OAuth.
<img width="2124" height="428" alt="Image" src="https://github.com/user-attachments/assets/8b03eee1-b543-4de6-b154-800a489e0e7a" />
Is this the same problem?
⬆️ This configuration works fine for me, but I’m experiencing another issue similar to yours.
I can not connect to the Figma local mcp server.
Per these docs , s/bearer_token/bearer_token_env_var/g
This linear streamable HTTP MCP setup worked for me (codex-cli 0.47.0):
Streamable http confirmed working for me too, currently running 0.47.0 with config.toml as @glennr calls out from the docs.
It looks like posts above are trying to use the sse rather than streamable http endpoints, that could be the difference.
Note
https://mcp.linear.app/ssevshttps://mcp.linear.app/mcpThis post is tracking feature request for SSE so i would assume they are using that because they need to. For me the MCP connection I use the most is SSE only and therefore I am still unable to fully move to Codex
I have no doubt some users require SSE only, and I can only speak for myself, but my use-case is satisfied with streamable http.
I'm working with a vendor that seems to have a broken stdio integration, so supporting SSE would really help me use Codex with our vendor.
Hi !
This works for me:
Hi all! I actually got stdio working. Here's my working config:
Any new update o this?
were you able to try using stdio instead of sse? perhaps that might be a better route. best of luck!
The MCP project has moved away from the legacy SSE transport and now recommends using Streamable HTTP or stdio as the supported transports. Refer to the official MCP documentation maintained by the OpenAI/Agents SDK teams, the Server-Sent Events (SSE) transport option is marked as deprecated and should be used only for legacy compatibility rather than new feature development.
Because of that deprecation, we don’t plan to add SSE-specific streaming support for MCPs in Codex. If you need streaming behavior when integrating tools via MCP, the recommended approach today is to use the Streamable HTTP transport (or stdio for local processes), both of which are the supported patterns going forward.