> ## 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 Windows

> Come installi da solo, sul tuo PC Windows, 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.

<Info>
  Questa pagina installa **l'MCP WhatsApp** (vedi [cos'è](/riferimenti/whatsapp)) sul tuo PC. 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 Mac: [Installazione — Mac](/riferimenti/whatsapp/installazione-mac).
</Info>

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](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-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

<Steps>
  <Step title="Estrai lo zip">
    Scarica `whatsapp-bridge-kit-windows.zip` dalla [pagina dei kit](https://github.com/ftaiano100-dot/mattone-docs/releases/tag/whatsapp-kit-v1) (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`.
  </Step>

  <Step title="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**.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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**.
  </Step>

  <Step title="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.
  </Step>
</Steps>

## Accendere l'invio dei messaggi

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

<Steps>
  <Step title="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.
  </Step>

  <Step title="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**».
  </Step>
</Steps>

<Warning>
  **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.
</Warning>

## 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».

<Note>
  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.
</Note>

## 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](/riferimenti/whatsapp/collegare-mattone-platform).

## Scollegarsi del tutto

<Steps>
  <Step title="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.
  </Step>

  <Step title="Scollega dal telefono">
    WhatsApp → **Dispositivi collegati** → **Chrome (Linux)** → **Esci**.
  </Step>

  <Step title="Togli lo strumento da Claude">
    Claude Desktop → **Impostazioni → Sviluppatore → Modifica configurazione**: togli la voce
    `"whatsapp"`, salva e riavvia Claude Desktop.
  </Step>
</Steps>

**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 di PowerShell** (controlla prima che non si vedano chat o numeri di altre
persone) e mandalo in `#mattone-team`.

<Info>
  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](/riferimenti/manutenzione-docs).
</Info>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.