> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mattone.co/llms.txt
> Use this file to discover all available pages before exploring further.
# MCP WhatsApp — installazione su Mac
> Come installi da solo, sul tuo Mac, il collegamento che fa leggere al tuo Claude le tue chat di WhatsApp: cosa serve, i passi con il kit, come colleghi il telefono con un codice, come lo colleghi a Claude Desktop, come accendi l'invio e come ti scolleghi.
Questa pagina installa **l'MCP WhatsApp** (vedi [cos'è](/riferimenti/whatsapp)). Se il
collegamento lo facciamo **noi** e a te serve solo il telefono, la pagina è un'altra:
[WhatsApp come dispositivo collegato](/integrazioni/whatsapp/dispositivo-collegato). Se cerchi
la versione Windows: [Installazione — Windows](/riferimenti/whatsapp/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](https://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](https://github.com/ftaiano100-dot/mattone-docs/releases/tag/whatsapp-kit-v1), 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
Scarica `whatsapp-bridge-kit-mac.zip` dalla [pagina dei kit](https://github.com/ftaiano100-dot/mattone-docs/releases/tag/whatsapp-kit-v1) (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`.
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**.
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.
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**.
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.
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.
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](/riferimenti/whatsapp/collegare-mattone-platform).
## Scollegarsi del tutto
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.
WhatsApp → **Dispositivi collegati** → **Chrome (Linux)** → **Esci**.
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](/riferimenti/whatsapp/problemi): 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](/riferimenti/manutenzione-docs).
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.