Skip to main content
Questa pagina installa l’MCP WhatsApp (vedi cos’è) sul tuo PC. Se il collegamento lo facciamo noi e a te serve solo il telefono, la pagina è un’altra: WhatsApp come dispositivo collegato. Se cerchi la versione Mac: Installazione — Mac.
Questa pagina serve a chi vuole che il proprio Claude, sul proprio PC, legga le chat del proprio WhatsApp. Per esempio: «leggi le mie ultime 5 chat», «cosa mi ha scritto il proprietario di ieri sera?». All’inizio il tuo Claude legge soltanto. L’invio di messaggi è spento, e lo accendi tu solo se e quando lo decidi. Tempo: circa 15 minuti. Non devi saper programmare: fai clic destro su due file e incolli un pezzo di testo.

​
Cosa serve

  • Un PC Windows 10 o 11 (64 bit).
  • Claude Desktop installato e con il tuo account (claude.ai/download).
  • WhatsApp o WhatsApp Business sul telefono, con il numero che vuoi collegare.
  • Il kit di installazione (un file .zip): lo scarichi dalla pagina dei kit, file whatsapp-bridge-kit-windows.zip. Serve un account GitHub con accesso al repo di Mattone Docs: se il link ti dice 404 o ti chiede di entrare, chiedi l’accesso in #mattone-team.

​
Come funziona, in breve

Sul tuo PC gira un piccolo programma che si aggancia al tuo WhatsApp come dispositivo collegato, come WhatsApp Web. Salva le chat sul tuo PC, e il tuo Claude le legge da lì.
  • Il telefono resta il tuo, il numero non cambia, WhatsApp sul telefono funziona come prima.
  • Le chat restano sul tuo computer: non passano dai nostri server.
  • Puoi scollegarlo quando vuoi dal telefono, in due tocchi.

​
Installazione

1

Estrai lo zip

Scarica whatsapp-bridge-kit-windows.zip dalla pagina dei kit (va nella cartella Download), clic destro → Estrai tutto. Non aprire solo lo zip: gli script devono stare nella stessa cartella dei file bin\ e mcp-server\.Come capisci che ha funzionato: nella cartella estratta vedi installa.ps1, configura-claude.ps1 e le cartelle bin e mcp-server.
2

Clic destro su installa.ps1 → Esegui con PowerShell

La prima volta Windows lo blocca con una finestra blu «Windows ha protetto il PC» (SmartScreen): è normale, lo script non ha una firma digitale a pagamento.
  1. clicca Ulteriori informazioni;
  2. clicca Esegui comunque.
Si apre una finestra PowerShell. Scrivi il tuo numero di WhatsApp con il prefisso (per esempio +39 333 123 4567) e premi Invio, poi conferma con s.Come capisci che ha funzionato: dopo qualche secondo la finestra mostra, a lettere grandi, un codice di 8 caratteri.
3

Inserisci il codice sul telefono

Hai circa 2 minuti e mezzo. Sul telefono:
  1. se ti arriva una notifica di WhatsApp che chiede un codice, toccala;
  2. altrimenti: WhatsApp → Impostazioni (su Android i tre puntini) → Dispositivi collegati → Collega un dispositivo → «In alternativa, collega con il numero di telefono»;
  3. scrivi il codice che vedi sullo schermo (il trattino non serve) e conferma.
Come capisci che ha funzionato: sullo schermo compare COLLEGATO! e poi «Collegamento attivo e con avvio automatico: riparte da solo quando accedi a Windows». Sul telefono, in Dispositivi collegati, compare Chrome (Linux): è il tuo PC, il nome è quello per ragioni tecniche.Se il codice scade non succede niente di male: rilancia installa.ps1 e ne avrai uno nuovo.
4

Collega Claude Desktop

Clic destro su configura-claude.ps1 → Esegui con PowerShell.
  • Se ti dice che manca un programma chiamato uv, ti mostra la riga ufficiale per installarlo (un comando da incollare in PowerShell): eseguila, aspetta la fine e rilancia configura-claude.ps1.
  • Lo script mostra un pezzo di testo tra due righe di trattini, lo copia già negli appunti e ti dice dove incollarlo.
Poi apri Claude Desktop → menu (le tre righe) → File → Impostazioni → Sviluppatore → Modifica configurazione. Si apre una cartella con il file claude_desktop_config.json: aprilo con Blocco note, incolla con Ctrl+V dove indicato e salva con Ctrl+S.Rilancia configura-claude.ps1: deve dire che la configurazione è valida. Infine chiudi Claude Desktop del tutto (anche dall’icona vicino all’orologio) e riaprilo.Come capisci che ha funzionato: tra gli strumenti di Claude Desktop compare whatsapp.
5

Prova

In Claude Desktop scrivi «leggi le mie ultime 5 chat di WhatsApp».Come capisci che ha funzionato: Claude ti chiede il permesso di usare lo strumento WhatsApp e poi ti elenca le chat. Nei primi minuti le chat vecchie possono essere poche: WhatsApp le manda al PC un po’ alla volta. Quelle nuove arrivano subito.

​
Accendere l’invio dei messaggi

Finché l’invio è spento, se chiedi a Claude di mandare un messaggio ricevi un errore: è voluto.
1

Cambia una riga

Apri la cartella WhatsAppBridge nella tua cartella utente (%USERPROFILE%\WhatsAppBridge, la trovi scrivendo quel percorso nella barra di Esplora file) e apri config.env con Blocco note. Nella riga dell’invio (è spiegata dal commento subito sopra) cambia false in true, senza spazi. Salva.
2

Riavvia il collegamento

Clic destro su riavvia.ps1, nella stessa cartella → Esegui con PowerShell.Come capisci che ha funzionato: la finestra dice «Invio messaggi: ACCESO».
Niente invii massivi. Se partono tanti messaggi di fila, o messaggi a persone che non ti hanno mai scritto, WhatsApp può sospendere il tuo numero. Usa l’invio per rispondere, un messaggio alla volta, e rileggi prima di confermare. Per rispegnerlo rimetti false e riavvia.

​
Salvare solo alcune chat

Di default si salvano tutte le chat. Per salvarne solo alcune:
  1. nella cartella WhatsAppBridge apri elenco-chat.txt e scrivi una chat per riga: il numero della persona con il prefisso, oppure il codice di un gruppo (finisce con @g.us). Un numero in elenco non include i gruppi di quella persona;
  2. in config.env togli il # all’inizio della riga che richiama l’elenco (è spiegata dal commento sopra) e salva;
  3. clic destro su riavvia.ps1 → Esegui con PowerShell.
Come capisci che ha funzionato: riavvia.ps1 dice «Chat salvate: solo quelle in elenco-chat.txt».
Con l’elenco attivo ma vuoto non si salva niente. Togliere una chat dall’elenco ferma il salvataggio dei messaggi nuovi, ma non cancella quelli già salvati.

​
Cose da sapere

  • Il PC deve restare acceso e non in sospensione perché i messaggi arrivino. Quando lo riaccendi il collegamento riparte da solo (attività pianificata all’accesso) e recupera i messaggi arrivati nel frattempo.
  • Usa WhatsApp sul telefono almeno una volta ogni 14 giorni: se il telefono resta inutilizzato più a lungo, WhatsApp scollega i dispositivi collegati e il tuo Claude smette di vedere i messaggi nuovi.
  • L’MCP Mattone Platform trova questo collegamento da solo se sta sullo stesso computer: vedi Collegarlo all’MCP Mattone Platform.

​
Scollegarsi del tutto

1

Ferma il collegamento sul PC

Clic destro su disinstalla.ps1 (nel kit o nella cartella WhatsAppBridge) → Esegui con PowerShell: ferma il collegamento e toglie l’avvio automatico. Le chat salvate restano sul PC; lo script ti mostra la riga per cancellarle, se vuoi.
2

Scollega dal telefono

WhatsApp → Dispositivi collegati → Chrome (Linux) → Esci.
3

Togli lo strumento da Claude

Claude Desktop → Impostazioni → Sviluppatore → Modifica configurazione: togli la voce "whatsapp", salva e riavvia Claude Desktop.
Come capisci che ha funzionato: sul telefono Chrome (Linux) non compare più tra i dispositivi collegati, e in Claude non c’è più lo strumento whatsapp.

​
Se qualcosa non va

Vai a Problemi e domande frequenti: copre gli errori più comuni di questa pagina, con il testo esatto e cosa fare. Se il tuo caso non c’è, fai uno screenshot della sola finestra di PowerShell (controlla prima che non si vedano chat o numeri di altre persone) e mandalo in #mattone-team.
Se qualcosa in questa pagina non torna con quello che vedi sul tuo PC, scrivilo in #mattone-team: vuol dire che la pagina va corretta. Vedi Manutenzione docs.