L'ambiente di lavoro¶

Prima di iniziare a costruire qualsiasi progetto, è necessario preparare l'ambiente di lavoro. Questo capitolo si concentra sulla configurazione specifica di Claude Desktop per il vibe coding, non sull'installazione dell'applicazione, per tale aspetto rimando a questo articolo sul mio blog.

Claude Desktop come piattaforma di sviluppo¶

Claude Desktop non è un'interfaccia di chat. O meglio, la chat è una delle tre modalità di lavoro disponibili, ma non l'unica e non sempre la più indicata. L'applicazione è una piattaforma estensibile che può accedere ai file sul computer con modalità diverse, eseguire comandi, interagire con servizi esterni e produrre artefatti complessi. Quando si usa Claude Desktop per il vibe coding, il modello linguistico è solo una parte del sistema, l'altra parte è l'insieme di connessioni e strumenti che gli permettono di agire oltre la conversazione.

Le tre modalità si chiamano Chat, Cowork e Code, e ciascuna corrisponde a un modo diverso di collaborare con l'AI.

Le differenze principali: - Chat è l'ambiente interattivo classico di chat, dove si scambia un messaggio alla volta e si mantiene il controllo su ogni passaggio. - Cowork è la modalità agentica pensata per il lavoro di sviluppo, dove Claude riceve un compito, pianifica i passaggi, opera sui file locali e restituisce un risultato finito. - Code è la modalità simil-terminale orientata allo sviluppo software, progettata per chi lavora con il codice in modo sistematico.

La distinzione è importante per il vibe coding perché ciascuna modalità si posiziona diversamente sullo spettro della delega descritto nel capitolo precedente. Chat favorisce la delega guidata, dove si osserva ogni passaggio e si interviene in ogni step. Cowork favorisce la delega piena, dove si definisce l'obiettivo e si lascia lavorare l'agente. Code propone un contesto ottimizzato per i progetti software, con strumenti specifici come l'integrazione Git e la gestione dei permessi.

Il capitolo successivo entra nel merito di ciascuna modalità con un confronto dettagliato. Per il momento è sufficiente sapere che esistono, che la scelta dell'ambiente influenza il tipo di controllo che si esercita sul lavoro dell'AI, e che le tre modalità non sono equivalenti per ogni tipo di compito.

Nella mia esperienza ho visto che Chat è l'ambiente che uso per scrivere (anche questo manuale lo sto scrivendo in Chat) o per fare brainstorming all'inizio di un progetto importante, per arrivare alle specifiche da dare poi a Cowork, che a sua volta eccelle nel completamento autonomo di compiti strutturati. La ragione plausibile è che l'architettura agentica di Cowork distribuisce le proprie risorse tra pianificazione, coordinamento e esecuzione, mentre Chat concentra tutta la propria attenzione sulla risposta al messaggio ricevuto.

Per utilizzare Claude Desktop come piattaforma di sviluppo è necessario un piano a pagamento. Il piano Pro costa 20 dollari al mese (17 con abbonamento annuale) e include l'accesso a tutte e tre le modalità, ai progetti, all'integrazione con Google Workspace e ai connettori MCP. Per chi lavora intensivamente, i piani Max (100 e 200 dollari al mese) offrono limiti di utilizzo più alti e accesso anticipato alle novità. Il piano gratuito consente di esplorare la chat e le desktop extension, ma i limiti di utilizzo lo rendono inadeguato per sessioni di lavoro prolungate come quelle richieste dal vibe coding.

Il protocollo MCP¶

Il Model Context Protocol (MCP) è uno dei meccanismi che permettono a Claude Desktop di agire oltre la conversazione. Il suo ruolo varia a seconda della modalità di lavoro. In Chat, MCP è il canale principale attraverso cui Claude accede ai file, esegue comandi e interagisce con servizi esterni, senza server MCP configurati la chat può solo leggere e generare testo. Cowork e Code hanno invece meccanismi propri per accedere ai file e eseguire comandi, e utilizzano MCP come estensione per funzionalità aggiuntive. Il capitolo successivo entra nel dettaglio di queste differenze.

L'analogia più diffusa descrive MCP come "l'USB-C dell'intelligenza artificiale", un connettore universale che permette a qualsiasi applicazione AI di comunicare con qualsiasi strumento esterno attraverso un'interfaccia standardizzata. L'analogia è efficace ma va completata con un dettaglio, così come USB-C funziona perché nessun produttore di laptop ne controlla le specifiche, MCP funziona perché è uno standard aperto e neutrale.

La storia del protocollo è interessante, Anthropic ha rilasciato MCP nel novembre 2024 già come standard aperto, nel giro di un anno il protocollo è stato adottato anche da Cursor, Microsoft Copilot, Gemini, Visual Studio Code e ChatGPT. Nel dicembre 2025 Anthropic ha donato MCP alla Linux Foundation, che lo ha inserito nella neonata Agentic AI Foundation insieme a contributi di OpenAI, Google, Microsoft, Amazon Web Services e altri. L'ecosistema conta oggi oltre 10.000 server pubblicati e SDK ufficiali in tutti i principali linguaggi di programmazione.

Per chi fa vibe coding questi numeri significano una cosa concreta, quando l'utente ha bisogno di leggere un file, creare una cartella, eseguire uno script o consultare una documentazione esterna, molto probabilmente da qualche parte esiste già un server MCP adatto.

Ogni server espone un insieme di "strumenti" che Claude può invocare durante la conversazione. L'utente non deve preoccuparsi del protocollo in sé, ma deve sapere quali server sono attivi e cosa permettono di fare.

I server MCP essenziali¶

La quantità di server MCP disponibili può disorientare. Per iniziare a fare vibe coding non servono decine di strumenti ma pochi server ben scelti, sufficienti a coprire le operazioni fondamentali. La selezione che segue è particolarmente rilevante per chi lavora in modalità Chat, dove MCP è il canale principale di interazione con il sistema. In Cowork e Code molte di queste funzionalità sono già integrate, ma i server MCP restano utili per estendere le capacità di base.

Claude Desktop offre due modi per aggiungere server MCP, le Desktop Extension e la configurazione manuale. Le Desktop Extension sono pacchetti preconfigurati che si installano con un clic dalla directory integrata nell'applicazione. La configurazione manuale richiede la modifica di un file JSON e offre il controllo completo su ogni parametro. Per la maggior parte dei server comuni le Desktop Extension sono la scelta più semplice, la configurazione manuale resta necessaria per server personalizzati o non presenti nella directory. Una differenza pratica rilevante riguarda i prerequisiti software, le Desktop Extension includono tutto il necessario per funzionare, mentre la configurazione manuale richiede l'installazione di strumenti aggiuntivi come Node.js, come descritto nella sezione sul file di configurazione.

Partenza: accesso ai file e controllo del sistema¶

Il primo server da installare in Chat è Filesystem, il server ufficiale che permette a Claude di leggere, scrivere e organizzare file nelle cartelle specificate dall'utente. Senza Filesystem o un server equivalente, la modalità Chat non ha accesso al filesystem e può solo operare all'interno della finestra di conversazione. Con Filesystem attivo, può creare file di progetto, modificare codice esistente, organizzare cartelle e produrre documenti, tutto a partire dalla conversazione.

Desktop Commander è un'alternativa a Filesystem da valutare con attenzione visto che può operare ovunque nel computer dell'utente. Oltre alla gestione dei file, Desktop Commander permette a Claude di eseguire comandi nel terminale, gestire processi, effettuare ricerche nei file e modificare documenti con precisione chirurgica. Per il vibe coding è uno strumento particolarmente utile perché consente di eseguire il codice generato, verificare i risultati e correggere gli errori senza uscire dalla conversazione.

Produttività: documentazione e ricerca¶

Context7 risolve un problema specifico e frequente. I modelli linguistici hanno una data limite oltre la quale le informazioni diventano inaffidabili, e le librerie software si aggiornano continuamente. Context7 permette a Claude di consultare la documentazione aggiornata delle librerie e dei framework utilizzati nel progetto, riducendo il rischio di generare codice basato su API obsolete o su funzioni rinominate.

Claude Desktop include già una funzionalità nativa di ricerca web, sufficiente per la maggior parte delle esigenze durante una sessione di vibe coding. I server MCP di ricerca web aggiungono valore in situazioni specifiche, ad esempio quando si vuole utilizzare un motore di ricerca particolare, quando si ha bisogno di recuperare il contenuto completo di una pagina web e non solo un riassunto, o quando si lavora in modalità Code dove la ricerca nativa potrebbe non essere disponibile. Per chi inizia, la ricerca nativa è più che adeguata.

Strumenti avanzati¶

Con la crescita dei progetti, possono emergere esigenze più specifiche. Server per l'automazione del browser permettono a Claude di interagire con pagine web, compilare moduli, estrarre dati. Server per database consentono di leggere e scrivere su database locali come SQLite, spesso usato nei progetti di vibe coding per la sua semplicità. Server per servizi cloud collegano Claude a piattaforme come GitHub, Google Drive o Slack.

Questi strumenti avanzati non servono per iniziare. Diventano rilevanti quando un progetto cresce oltre lo stadio del prototipo e richiede integrazioni con sistemi esterni. Il consiglio è di partire con i server essenziali e aggiungere strumenti aggiuntivi quando emerge un bisogno concreto.

Il file di configurazione¶

I server MCP installati tramite Desktop Extension non richiedono alcuna configurazione manuale, Claude Desktop li gestisce in autonomia. Per i server che non sono disponibili nella directory, o per quelli che richiedono parametri personalizzati, la configurazione avviene attraverso un file JSON che Claude Desktop legge all'avvio.

Il file si chiama claude_desktop_config.json e si trova in una posizione diversa a seconda del sistema operativo. Su macOS il percorso è ~/Library/Application Support/Claude/claude_desktop_config.json, su Windows è %APPDATA%\Claude\claude_desktop_config.json, su Linux ~/.config/Claude/claude_desktop_config.json.

Il modo più rapido per accedere al file è attraverso Claude Desktop stesso. Aprire le impostazioni, selezionare la sezione Developer e fare clic su "Edit Config". Se il file non esiste, viene creato automaticamente.

La struttura del file è un oggetto JSON con una chiave principale mcpServers, sotto la quale ogni server è identificato da un nome e configurato con tre proprietà: il comando da eseguire per avviarlo, gli argomenti da passare al comando e, opzionalmente, le variabili d'ambiente necessarie.

Un prerequisito importante per la configurazione manuale è l'installazione di Node.js sulla propria macchina. La maggior parte dei server MCP utilizza il comando npx per avviarsi, che fa parte dell'ecosistema Node.js. Le Desktop Extension non hanno questo requisito perché Claude Desktop include un ambiente Node.js integrato, ma per la configurazione manuale è necessario installare Node.js separatamente, scaricandolo dal sito ufficiale nodejs.org. Per verificare se Node.js è già presente, è sufficiente aprire un terminale e digitare node --version.

Un esempio concreto, la configurazione del server Filesystem per dare a Claude accesso alla cartella dei progetti e al desktop:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "C:\\Users\\nome-utente\\Desktop",
        "C:\\Users\\nome-utente\\Progetti"
      ]
    }
  }
}

La voce nome-utente va sostituita con il proprio nome utente di sistema. I percorsi indicano le cartelle a cui Claude avrà accesso, ed è possibile aggiungerne o rimuoverne secondo le proprie esigenze.

Per aggiungere più server è sufficiente inserire ulteriori voci dentro l'oggetto mcpServers, separate da virgole. L'errore più comune nella configurazione è proprio un errore di sintassi JSON, una virgola mancante o in eccesso, una parentesi non chiusa. Claude Desktop non segnala gli errori nel file di configurazione, semplicemente ignora i server mal configurati. È consigliabile usare un editor con validazione JSON, come Visual Studio Code, per evitare errori silenziosi.

Dopo ogni modifica al file di configurazione è necessario chiudere completamente Claude Desktop e riavviarlo. Chiudere la finestra non è sufficiente, occorre uscire dall'applicazione (su macOS tramite il menu Claude → Esci, su Windows dalla system tray).

Per verificare che i server siano correttamente collegati, aprire una nuova conversazione in Claude Desktop, fare clic sul pulsante "+" nella barra inferiore e selezionare "Connettori". La lista mostra tutti i server attivi e gli strumenti disponibili.