Before you start
You need your own Surfer account on a plan that includes MCP. You also need Claude Code installed and signed in.Already connected Surfer on claude.ai? With a Claude subscription login active
in Claude Code, that connector is available automatically. Check
/mcp and
verify the connection without adding it again.Connect Surfer
This setup makes Surfer available across your projects.1
Add the server
Run this command in your terminal:
2
Open the sign-in flow
Start
claude, run /mcp, and select surfer to authenticate. Claude Code opens your browser.3
Authorize Surfer
- 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.
Limit the connection to one project
Limit the connection to one project
Omit
--scope user to keep the server local to the current project. Use
--scope project to save it in the project’s .mcp.json for your team. Each
person signs in separately.Verify the connection
Run/mcp and confirm Surfer is listed, then close the panel to send a request in the same session.
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.