Skip to main content
Add the server from your terminal, then authorize it in a Claude Code session.

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

  1. Sign in with your Surfer account in the browser window that opens.
  2. Check the account next to Signed in as. If it is the wrong one, select Switch account and sign in with the right one.
  3. Choose the organization to connect, if you belong to more than one.
  4. Select Authorize, then return to your client.
To change the account of a connection you already made, see Disconnect or switch accounts.
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.