# Collegare gli assistenti IA

> Permetti a Claude, ChatGPT o un altro client MCP di creare bozze, controllare le statistiche e leggere le risposte ai moduli nel tuo account Walink.

Il server MCP di Walink permette a un assistente IA di lavorare nel tuo account Walink. Chiedi a Claude di preparare la bozza di un link per la tua prossima campagna, chiedi a ChatGPT come vanno i clic della settimana scorsa rispetto a quella prima, oppure chiedi a qualsiasi client MCP di elencare le ultime risposte a un modulo. L’assistente segue le regole dell’app: crea bozze, che sono private e gratuite, e può fare solo ciò che hai consentito quando l’hai collegato.

L’indirizzo del server:

```text
https://mcp.walink.com/mcp
```

## Cosa può fare l’assistente

| Chiedigli di                                                                 | Strumenti                                                                                                                 |
| ---------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
| Leggere il tuo account, la quota e i link gratis                             | `walink_get_account`                                                                                                      |
| Trovare un link, uno Smart Link, un modulo o una pagina Multilink            | `walink_search`, `walink_list_resources`, `walink_get_resource`                                                           |
| Controllare che un indirizzo sia libero                                      | `walink_check_handle`                                                                                                     |
| Dire cosa manca a una bozza prima della pubblicazione                        | `walink_check_publish_readiness`                                                                                          |
| Riportare le statistiche, per paese, sorgente, dispositivo e altro           | `walink_get_analytics`, `walink_get_analytics_breakdown`                                                                  |
| Darti l’indirizzo da condividere e la destinazione del codice QR             | `walink_get_share_kit`                                                                                                    |
| Leggere le risposte a un modulo                                              | `walink_list_form_responses`                                                                                              |
| Preparare la bozza di un Link Premium, Smart Link, modulo o pagina Multilink | `walink_create_link_draft`, `walink_create_smart_link_draft`, `walink_create_form_draft`, `walink_create_multilink_draft` |
| Modificarli                                                                  | `walink_update_link`, `walink_update_smart_link`, `walink_update_form`, `walink_update_multilink`                         |
| Personalizzare un codice QR                                                  | `walink_set_qr_style`                                                                                                     |
| Elencare, leggere, creare ed eliminare link gratis                           | `walink_list_free_links`, `walink_get_free_link`, `walink_create_free_link`, `walink_delete_free_link`                    |
| Pubblicare, riportare in bozza o eliminare                                   | `walink_publish`, `walink_unpublish`, `walink_delete`                                                                     |

Il server offre anche sei prompt già pronti, come un report settimanale sui risultati, un modulo per i lead e una revisione delle tue bozze. Ognuno finisce con una bozza o un report, e si ferma prima della pubblicazione.

## Collega col tuo account Walink

Claude, ChatGPT e gli altri client che supportano l’accesso MCP (OAuth) non hanno bisogno di un token: accedi a Walink e scegli cosa può fare l’assistente.

### In Claude

1. Nell’app Walink, apri **Developers** (sviluppatori) dal menu dell’account e seleziona **Connect with Claude** (collega con Claude), in **MCP Setup**. Claude apre la sua finestra per aggiungere un connettore personalizzato, con Walink e l’indirizzo del server già compilati. Puoi anche aggiungere tu stesso un connettore personalizzato in Claude, con l’indirizzo qui sopra.
2. Conferma in Claude, poi accedi a Walink quando Claude ti ci manda.
3. Scegli le autorizzazioni nella schermata di consenso e seleziona **Allow** (consenti).

Da quel momento la connessione funziona nelle app web, desktop e mobile di Claude.

### In ChatGPT

Aggiungi un connettore personalizzato nelle impostazioni di ChatGPT con l’indirizzo del server e l’accesso OAuth. ChatGPT ti manda poi su Walink per accedere e approvare. Dove si trova quell’impostazione, e quali account ChatGPT ce l’hanno, dipende da OpenAI: il loro centro assistenza ha i passaggi aggiornati.

### La schermata di consenso

Walink chiede se consentire all’app (indicata col suo nome) di usare il tuo account Walink, e mostra l’account con cui hai effettuato l’accesso e l’indirizzo a cui tornerai. In **What it can do** (cosa può fare), le autorizzazioni chieste dall’assistente partono spuntate, tranne quelle ad alto rischio: **Publish** (pubblicare), **Delete** (eliminare) e **Form responses** (risposte ai moduli) restano disattivate finché non le attivi tu.

- Per permettere all’assistente di pubblicare, creare link gratis o modificare ciò che è già online, spunta **Publish** in **Links**, **Forms** o **Multilink**.
- Per un assistente che legge soltanto, seleziona **Read only** (sola lettura) in **Quick presets** (preimpostazioni rapide).

Se Walink non riesce a verificare l’app, la schermata lo dice: continua solo se la connessione l’hai avviata tu.

## Collega con un token API

Claude Code, Cursor, VS Code e gli altri client che possono inviare un’intestazione si collegano invece con un token personale. Creane uno nella pagina Developers, come in [REST API](https://walink.com/it/docs/api), con i soli ambiti che servono all’assistente. Un solo token funziona per la REST API e per il server MCP, con gli stessi ambiti in entrambi.

In Claude Code:

```sh
claude mcp add --transport http walink https://mcp.walink.com/mcp --header "Authorization: Bearer <token>"
```

Qualsiasi altro client invia `Authorization: Bearer wlk_live_...` all’indirizzo del server. La pagina Developers ha impostazioni già pronte per Cursor e VS Code in **MCP Setup**. Tieni il token nelle impostazioni del client, e non incollarlo mai in una chat.

## Cosa può e non può fare

- **Bozze di default.** Ogni creazione produce una bozza privata, tranne nel caso di un link gratis. Una bozza non si pubblica mai da sola.
- **Decidi tu cosa va online.** Pubblicare usa la tua quota e raggiunge il pubblico. Gli strumenti di Walink dicono all’assistente di pubblicare, riportare in bozza, eliminare o creare un link gratis solo quando lo chiedi tu con parole tue. **Publish** e **Delete** partono disattivati, e finché lo sono l’assistente riceve invece un errore `insufficient_scope`.
- **I link gratis vanno online subito.** Crearne uno richiede **Publish** in **Links**. Il suo indirizzo è casuale, non si può modificare in seguito e un account può averne fino a 5.
- **Le modifiche agli elementi pubblicati sono subito online.** Cambiare un link, un modulo o una pagina pubblicati cambia subito ciò che vedono i visitatori, quindi richiede anche **Publish**.
- **Gli indirizzi sono definitivi.** Controlla come è scritto prima che l’assistente crei qualcosa: un indirizzo non si può cambiare dopo la creazione dell’elemento.
- **Niente fatturazione.** L’assistente non può acquistare quota, cambiare il tuo abbonamento o gestire i token. Le statistiche richiedono un abbonamento, come nell’app.

> [!WARNING]
> Le risposte ai moduli, e i valori delle statistiche come una sorgente di traffico, arrivano dal pubblico. Walink li contrassegna come non attendibili e dice all’assistente di trattarli come dati, mai come istruzioni. Leggi ciò che un assistente propone prima di chiedergli di pubblicare.

## Scollegare

- **Un’app collegata:** nella pagina Developers, in **Connected apps** (app collegate), seleziona **Disconnect** (scollega). Smette di funzionare entro 30 secondi.
- **Un token:** in **API Tokens**, seleziona **Revoke** (revoca). Tutto ciò che lo usa si ferma entro 30 secondi.

Ogni endpoint e ogni campo dietro questi strumenti sono nel [riferimento dell’API](https://api.walink.com/docs).
