Skip to main content
Questa pagina installa l’MCP WhatsApp (vedi cos’è). 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 Windows: Installazione — Windows.
Questa pagina serve a chi vuole che il proprio Claude, sul proprio Mac, 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 doppio clic su due file e incolli un pezzo di testo.

​
Cosa serve

  • Un Mac (va bene sia con processore Apple sia Intel), con macOS 12 o più recente.
  • 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-mac.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 Mac gira un piccolo programma che si aggancia al tuo WhatsApp come dispositivo collegato, come WhatsApp Web. Salva le chat sul tuo Mac, 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

Apri il kit

Scarica whatsapp-bridge-kit-mac.zip dalla pagina dei kit (va nella cartella Download) e fai doppio clic: si crea la cartella whatsapp-bridge-kit-mac.Come capisci che ha funzionato: nella cartella vedi installa.command, configura-claude.command e le cartelle bin e mcp-server.
2

Doppio clic su installa.command

La prima volta macOS lo blocca, perché lo script non viene dall’App Store. È normale:
  1. al messaggio «Impossibile aprire…» clicca Fine;
  2. apri Impostazioni di Sistema → Privacy e sicurezza, scorri in basso e accanto a «installa.command è stato bloccato» clicca Apri comunque; inserisci la password del Mac e conferma Apri.
Su macOS meno recenti basta: clic destro su installa.command → Apri → Apri.Si apre una finestra del Terminale. Se macOS chiede se il Terminale può accedere alla cartella Download, rispondi Consenti. Scrivi il tuo numero di WhatsApp con il prefisso (per esempio +39 333 123 4567), premi Invio e 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 sul Mac (il trattino non serve) e conferma.
Come capisci che ha funzionato: sul Mac compare COLLEGATO! e poi «Collegamento attivo e con avvio automatico». Sul telefono, in Dispositivi collegati, compare Chrome (Linux): è il tuo Mac, il nome è quello per ragioni tecniche.Se il codice scade non succede niente di male: rifai doppio clic su installa.command e ne avrai uno nuovo. Se macOS avvisa «Elementi in background aggiunti», è l’avvio automatico del collegamento: lascialo attivo.
4

Collega Claude Desktop

Doppio clic su configura-claude.command.
  • Se ti dice che manca un programma chiamato uv, ti mostra la riga ufficiale per installarlo: aprila nel Terminale, premi Invio, aspetta la fine e rifai doppio clic.
  • Lo script mostra un pezzo di testo tra due righe di trattini, lo copia già negli appunti e ti dice dove incollarlo: segui esattamente quell’indicazione.
Poi apri Claude Desktop → Impostazioni → Sviluppatore → Modifica configurazione. Si apre una cartella con il file claude_desktop_config.json: aprilo con TextEdit, incolla con Cmd+V dove indicato e salva con Cmd+S.Rifai doppio clic su configura-claude.command: deve dire che la configurazione è valida. Infine chiudi Claude Desktop del tutto (Cmd+Q) 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 Mac 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 Inizio (Finder → Vai → Inizio) e apri config.env con TextEdit. Nella riga dell’invio (è spiegata dal commento subito sopra) cambia false in true, senza spazi. Salva.
2

Riavvia il collegamento

Doppio clic su riavvia.command, nella stessa cartella.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. doppio clic su riavvia.command.
Come capisci che ha funzionato: riavvia.command 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 Mac deve restare acceso perché i messaggi arrivino (lo schermo può essere spento, ma non in stop). Quando lo riaccendi il collegamento riparte da solo 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 Mac

Doppio clic su disinstalla.command (nel kit o nella cartella WhatsAppBridge): ferma il collegamento e toglie l’avvio automatico. Le chat salvate restano sul Mac; 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 del Terminale (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 Mac, scrivilo in #mattone-team: vuol dire che la pagina va corretta. Vedi Manutenzione docs.