Claude Code è l’assistente da riga di comando di Anthropic. Connettendo Survio, importi i risultati del sondaggio in ciò che stai costruendo, senza lasciare il terminale.

Registra Survio con un solo comando, oppure inseriscilo in un file di configurazione nel tuo progetto. Entrambi vanno a finire nello stesso posto.

Prima di iniziare

Claude Code installato (guida all’installazione)
Un account Survio con Pro Business o superiore

Quale metodo?

	Un comando	Un file di configurazione
Impegno	Una riga	Crea o modifica un file
A cosa si applica	Tutti i tuoi progetti, con `--scope user`	Il progetto in cui vive il file
Condiviso con i colleghi	No	Sì - viaggia col progetto

Ognuno accede con il proprio account Survio, quindi un file di configurazione condiviso non condividerà mai i tuoi dati o l’accesso.

Metodo 1 - Un comando

Passo 1 - Registra il server

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

--scope user rende Survio disponibile in tutti i tuoi progetti. --scope project lo scrive invece nel .mcp.json del progetto corrente; senza flag rimane solo nel progetto attuale, per te.

Passo 2 - Apri il menu MCP

Avvia Claude Code ed esegui:

/mcp

Seleziona Survio dall’elenco.

Passo 3 - Autenticati

Scegli Autenticati, poi accedi con il tuo account Survio nel browser. Lo stato di Survio passerà a connesso.

Passo 4 - Prova

Elenca i miei sondaggi Survio.

Metodo 2 - .mcp.json

Quando la connessione deve restare nel progetto, pronta per chi ci lavora.

Passo 1 - Crea .mcp.json nella root del progetto

Il punto è importante.

Passo 2 - Aggiungi il server Survio

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

Se il file ha già altri server, aggiungi "survio" dentro l’oggetto mcpServers esistente invece di crearne uno nuovo:

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

Passo 3 - Approva i server del progetto

Avvia Claude Code in quella cartella e approva quando ti chiede se ti fidi dei server nel .mcp.json. La richiesta è voluta: un file arrivato da un altro repository non può collegarsi senza la tua conferma.

Passo 4 - Autenticati

Esegui /mcp, seleziona Survio, scegli Autenticati, e accedi.

.mcp.json contiene solo l’indirizzo del server. Il tuo accesso viene salvato separatamente sul tuo computer.

Dove vengono conservate le impostazioni

Scope	File	A chi si applica
`--scope user`	`~/.claude.json`	Tutti i tuoi progetti
`--scope project`	`.mcp.json` nella root del progetto	Quel progetto, condiviso
predefinito (locale)	`~/.claude.json`	Quel progetto, solo per te

L’app desktop di Claude Code

L’app desktop offre entrambe le opzioni.

Aggiungi da schermo. Vai su Personalizza → Connettori, clicca su Aggiungi e scegli Aggiungi connettore personalizzato. Dagli il nome Survio, incolla l’indirizzo del server e accedi appena si apre il browser. Survio compare con un segno di spunta verde e i suoi strumenti elencati.

Oppure usa il comando qui sopra. L’app desktop legge la stessa configurazione del terminale, quindi un server registrato con --scope user è già presente: non serve altro.

Due cose da sapere:

Non fare entrambe. Un connettore più un claude mcp add ti mostrano gli stessi strumenti due volte.
Ogni conversazione carica la configurazione quando parte. Se era già aperta quando hai aggiunto Survio e ti appare da autenticare, lancia /mcp, seleziona Survio e scegli Autenticati.

Comandi utili

claude mcp list              # server configurati e il loro stato
claude mcp get survio        # dettagli per il server Survio
claude mcp remove survio     # rimuovi la connessione

Come connettere Survio a Claude Code