Before you start
You need your own Surfer account on a plan that includes MCP.Codex CLI, the IDE extension, and ChatGPT desktop share MCP configuration on
the same Codex host. If Surfer is already connected there, continue to Verify
the connection.
Connect Surfer
Choose the client you use.- CLI
- IDE extension
- Config file
1
Add the server
Register Surfer from your terminal:
2
Sign in to Surfer
Follow the browser sign-in prompt. If it does not open, start sign-in from your terminal:
- Sign in with your Surfer account in the browser window that opens.
- Check the account next to Signed in as. If it is the wrong one, select Switch account and sign in with the right one.
- Choose the organization to connect, if you belong to more than one.
- Select Authorize, then return to your client.
Verify the connection
In the CLI, startcodex, then run /mcp to see active servers. In the IDE extension, check that surfer is enabled under Codex settings → MCP servers, then open a new chat.
Ask your assistant:
Your assistant lists the workspaces you belong to in the organization you authorized. Each workspace has a name, type, location, and state. Choose an active workspace for content tasks.
A list shorter than the one in the app is expected: over MCP, workspaces you are not a member of are not listed and cannot be reached. If the list is empty, ask an organization owner or admin to add you to a workspace.
Continue with Skills for guided workflows or Use cases for example requests. If the request fails, see Troubleshooting.
