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. 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.
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 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.