Claude Code is Anthropic's command-line assistant. Connecting Survio pulls survey results into whatever you're building, without leaving the terminal.

Before you start

Claude Code installed (installation guide)
A Survio account on PRO Business or higher

Which method?

	A command	A config file
Effort	One line	Create or edit one file
Where it applies	All your projects, with `--scope user`	The project the file lives in
Shared with teammates	No	Yes - it travels with the project

Everyone signs in with their own Survio account, so a shared config file never shares your data or login.

Method 1 - One command

Step 1 - Register the server

claude mcp add survio --scope user --transport http https://ai.survio.com/mcp

--scope user makes Survio available in all your projects. --scope project writes it into the current project's .mcp.json instead; no flag keeps it to the current project, for you only.

Step 2 - Open the MCP menu

Start Claude Code and run:

/mcp

Select survio from the list.

Step 3 - Authenticate

Choose Authenticate, then sign in with your Survio account in the browser. Survio's status changes to connected.

Step 4 - Try it

List my Survio surveys.

Method 2 - .mcp.json

For when the connection should live in the project, ready for everyone who works on it.

Step 1 - Create .mcp.json in your project root

The leading dot matters.

Step 2 - Add the Survio server

{
  "mcpServers": {
    "survio": {
      "type": "http",
      "url": "https://ai.survio.com/mcp"
    }
  }
}

If the file already has servers, add "survio" inside the existing mcpServers object rather than creating a second one:

{
  "mcpServers": {
    "some-other-server": {
      "type": "http",
      "url": "https://example.com/mcp"
    },
    "survio": {
      "type": "http",
      "url": "https://ai.survio.com/mcp"
    }
  }
}

Step 3 - Approve the project's servers

Start Claude Code in that folder and approve when it asks whether you trust the servers in .mcp.json. The prompt is deliberate: a file that arrived with someone else's repository can't connect anywhere without your say-so.

Step 4 - Authenticate

Run /mcp, select survio, choose Authenticate, and sign in.

.mcp.json holds only the server address. Your sign-in is stored separately on your own machine.

Where settings are stored

Scope	File	Applies to
`--scope user`	`~/.claude.json`	All your projects
`--scope project`	`.mcp.json` in the project root	That project, shared
default (local)	`~/.claude.json`	That project, just for you

The Claude Code desktop app

The desktop app gives you both routes.

Add it on screen. Go to Customize → Connectors, click Add and choose Add custom connector. Name it Survio, paste the server address, and sign in when the browser opens. Survio then shows with a green tick and its tools listed.

Or use the command above. The desktop app reads the same configuration as the terminal, so a server registered with --scope user is already there - nothing else to do.

Two things worth knowing:

Don't do both. One connector plus one claude mcp add leaves you with the same tools twice.
A conversation loads the configuration when it starts. One that was already open when you added Survio won't see it, and if Survio shows as needing authentication, run /mcp, select survio and choose Authenticate.

Useful commands

claude mcp list              # configured servers and their status
claude mcp get survio        # details for the Survio server
claude mcp remove survio     # remove the connection

How to connect Survio to Claude Code