🔌Server MCP
Un server MCP dà a Claude gli strumenti di un servizio: leggere il tuo account pubblicitario, cercare in uno spazio di lavoro Notion, interrogare un database... Impostazioni -> MCP elenca ogni server MCP che Claude Code usa nel tuo spazio di lavoro, dove si applica ciascuno e se funziona.
Dove si applica un server
| Dove | Significato |
|---|---|
| Ogni sessione | disponibile in tutti i topic (uno strumento che usi ovunque) |
un topic (acme / ads) |
solo nelle sessioni di quel topic - la scelta più comune: l'account pubblicitario nel topic ads, non negli altri |
Clicca su un topic per aprirlo. Quando un topic viene rinominato, i suoi server lo seguono; un topic eliminato lascia i suoi server in Errore (rimuovili).
Stati
| Stato | Cosa fare |
|---|---|
| Connesso | niente, Claude ha gli strumenti |
| Da connettere | il servizio richiede un accesso: clicca Connetti (vedi sotto) |
| Errore | passa il mouse sopra per vedere il motivo (indirizzo sbagliato, programma mancante, chiave rifiutata...) |
| Da approvare | un file .mcp.json trovato in una cartella di progetto di cui Claude Code non si fida ancora |
| Non verificato | clicca Verifica |
Gli stati vengono verificati in background quando apri la pagina e con Verifica (qualche secondo per topic).
Aggiungere un server
Il modo più semplice: chiedi a Claude nel topic che ne ha bisogno - "collega l'MCP di <service>, ecco il suo indirizzo". Oppure Aggiungi un server:
- Nome: breve, lettere, cifre,
-(es.google-ads). - Dove: ogni sessione, oppure un topic.
- Indirizzo (URL) fornito dal servizio (spesso termina con
/mcp), oppure Programma locale: il comando che lo avvia (es.npx -y @acme/mcp-server). - Header (indirizzo) o variabili d'ambiente (programma), solo quando il servizio richiede una chiave. Non incollare mai la chiave stessa: salvala in Impostazioni -> Chiavi e scrivi
${KEY_NAME}(il pulsante della chiave la inserisce). Le chiavi usate in questo modo vengono fornite automaticamente alle sessioni. Un valore scritto in chiaro (un token, una password) mostra un avviso token in chiaro e nell'elenco viene nascosto come•••, così come una password e i valori di query di un indirizzo (?key=•••); restano leggibili solo i riferimenti${KEY_NAME}e gli header innocui comeContent-Type.
Il server è disponibile dal messaggio successivo di una sessione.
Connetti (accesso)
Molti servizi (stato Da connettere) usano un accesso al posto di una chiave:
- Clicca Connetti, poi Apri la pagina di accesso.
- Accedi al servizio e accetta.
- Il browser mostrerà poi "Impossibile raggiungere il sito" su
localhost: è normale. Il servizio ti rimanda a un indirizzo che esiste solo sul server di Harness; il codice di connessione si trova in quell'indirizzo. Copia l'intero indirizzo dalla barra degli indirizzi (contienecode=). - Tornato in Harness, incollalo (pulsante Incolla, oppure Ctrl+V) e clicca Termina.
Fallo entro pochi minuti: il codice scade (in tal caso clicca Riprova). Funziona qualunque sia l'accesso a Harness (dominio o Tailscale): Claude Code, sul server, completa la connessione con il codice che hai incollato.
La connessione viene mantenuta per ogni sessione (Claude Code la rinnova da solo). Si fa una sola volta per server.
Rimuovere
... -> Rimuovi. Le chiavi del vault restano.
Browser del mio PC
Impostazioni -> MCP -> Browser del mio PC permette a Claude di usare un browser sul tuo computer (Windows, Mac o Linux): aprire un sito a cui hai già effettuato l'accesso, compilare un modulo, leggere una pagina, fare uno screenshot... Usa un profilo separato del tuo browser (Brave, Chrome, Edge, Vivaldi, Opera o Chromium): le tue schede abituali, le password e la cronologia non vengono mai toccate. Accedi una sola volta ai siti di cui Claude ha bisogno, nella finestra che si apre. (La scheda compare quando Harness PC può essere scaricato dal tuo server.)
- Scegli il tuo computer e il tuo browser (Harness li indovina dal browser che stai usando), poi Scarica Harness PC.
- Scarica Harness PC (già collegato a questo server, valido 15 minuti) e aprilo - oppure incolla il comando mostrato in PowerShell / in un terminale. Su Windows, SmartScreen può dire "Windows ha protetto il PC": Ulteriori informazioni -> Esegui comunque (Harness PC non è ancora firmato da un editore). Non servono diritti di amministratore.
- La scheda chiede poi "
<il tuo PC>vuole connettersi", con l'indirizzo da cui si è connesso: clicca Sì, è il mio PC. Fino ad allora nulla raggiunge quel computer - se non riconosci il nome (qualcun altro ha usato il tuo link di download), clicca Rifiuta: viene disconnesso e dimentica il tuo server. Ogni sessione può poi usare gli strumenti del browser (harness-pc).
Solo mentre Claude lo usa. Harness PC resta in attesa in background (nessuna finestra, quasi nessun uso di CPU o memoria) e apre la finestra del browser alla prima azione di Claude sul browser; dopo 10 minuti senza azioni (Impostazioni: da 5 a 60 min) il browser e i suoi strumenti si fermano. Ferma ora lo chiude subito. Quando il PC è spento, in stop o Harness PC non è in esecuzione, a Claude viene detto "il PC è offline" e va avanti.
Avvia con il computer (attivo di default) aggiunge Harness PC all'avvio della tua sessione (Windows: chiave Run, Mac: elemento di login, Linux: file di avvio automatico), senza diritti di amministratore. Disconnetti lo ferma e lo rimuove dall'avvio sul PC; Cancella il profilo elimina i cookie e gli accessi del profilo di Claude; Reinstalla / altro PC esegue di nuovo l'abbinamento (un PC alla volta). Le ultime azioni (strumento, pagina) sono elencate nella scheda.
Sicurezza: Harness PC si connette solo in uscita al tuo Harness (nulla resta in ascolto sulla tua rete); la porta di controllo del browser resta su 127.0.0.1 del PC e le pagine web non possono raggiungerla. Harness PC stesso controlla ogni comando che inoltra, quindi nemmeno un server compromesso potrebbe usarlo per raggiungere i tuoi file: si possono aprire solo pagine web (http, https) - niente file:, chrome: o pagine delle impostazioni, e Claude non può aprire indirizzi del tuo PC o della tua rete domestica (localhost, 192.168.x.x, il tuo router, un NAS) -, i download non possono essere inviati in un'altra cartella, nessun file del PC può essere dato a una pagina e nessun permesso o app può essere installato. Claude non può caricare file dal PC né registrare il suo schermo. L'elenco delle azioni recenti conserva gli indirizzi senza la parte di query (i codici di accesso non vengono conservati).
Backup e nuovo server
Il backup della memoria conserva l'elenco dei server (i valori che sembrano segreti vengono oscurati - token, password, nomi simili a API_KEY: usa ${KEY_NAME} per questi, così un ripristino funziona così com'è; le impostazioni semplici come LOG_LEVEL=debug vengono conservate); un ripristino aggiunge di nuovo quelli mancanti. Gli accessi devono essere rifatti su un nuovo server.
Da un terminale: maxxing mcp list|add|remove (vedi il riferimento CLI).