Skip to main content
Add Surfer from your terminal or the Codex extension’s MCP settings.

​
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.
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:
  1. Sign in with your Surfer account in the browser window that opens.
  2. Choose the organization to connect, if you belong to more than one.
  3. Select Authorize, then return to your client.
If the browser signs you in to the wrong Surfer account, follow Disconnect or switch accounts.
Add this entry to ~/.codex/config.toml, or to .codex/config.toml in a trusted project:
Start sign-in from your terminal, then complete the Surfer authorization:
Restart your Codex session or extension to load the configuration.

​
Verify the connection

In the CLI, start codex, then run /mcp to see active servers. In the IDE extension, check the MCP server list, then open a new chat. Ask your assistant: Your assistant lists the workspaces in the organization you authorized. Each workspace has a name, type, location, and state. Choose an active workspace for content tasks. Continue with Skills for guided workflows or Use cases for example requests. If the request fails, see Troubleshooting.