Codex is OpenAI's coding agent, in three forms - the command-line tool, the ChatGPT desktop app and the IDE extension. They share one MCP configuration, so connect Survio once and it works in all three.
💡 ChatGPT on the web works differently. It only uses connectors OpenAI supplies, so Survio can't be added there. Use the desktop app, the CLI or the IDE extension.
Before you start
Codex installed and signed in - the CLI, the ChatGPT desktop app, or the IDE extension
A recent version. Run
codex --versionand update if you're behind; support for remote HTTP servers arrived along the way.A Survio account on PRO Business or higher
Method 1 - Two commands
Step 1 - Register the server
codex mcp add survio --url https://ai.survio.com/mcp
Step 2 - Sign in
codex mcp login survio
Sign in with your Survio account in the browser, then return to the terminal.
Step 3 - Try it
List my Survio surveys.
Method 2 - The ChatGPT desktop app
Step 1 - Open MCP settings
Settings → MCP servers → Add server.
Step 2 - Enter the server details
Name:
survioType: Streamable HTTP
URL:
https://ai.survio.com/mcp
Save, then restart the app.
Step 3 - Sign in
Sign in with your Survio account when prompted.
Method 3 - The config file
The route with the most control. What you change here applies to the CLI, the desktop app and the IDE extension alike.
Step 1 - Open the config file
Scope | File |
Your whole machine |
|
A single project |
|
On Windows: %USERPROFILE%\.codex\config.toml. Create it if it doesn't exist.
Step 2 - Add the Survio server
[mcp_servers.survio] url = "https://ai.survio.com/mcp"
The part after the dot - survio - is the name you'll use in commands, so keep it lowercase and without spaces.
⚠️ TOML is not JSON. An mcpServers JSON block pasted into config.toml stops Codex starting. Use the block above as it is.
Step 3 - Sign in
codex mcp login survio
The authorization is stored on your machine, so config.toml holds only the server address.
Step 4 - Check it worked
codex mcp list
Survio should be in the list.
Removing the connection
codex mcp remove survio
Or delete the [mcp_servers.survio] block from config.toml.