> ## 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 Mattone Platform: collegarlo al tuo Claude > Come collegare l'MCP Mattone Platform al tuo Claude per lavorare sulla Mattone Platform (studenti, voci, richieste ai fornitori): cosa incolli, come verifichi che funzioni davvero, e cosa fare se non funziona. Passo per passo, senza dare niente per scontato. Si chiamava **MCP Delivery**: stesso strumento, stesso indirizzo, nome aggiornato. L'**MCP Mattone Platform** è quello che il team di delivery collega al proprio Claude per lavorare sulla Mattone Platform: studenti, voci, richieste ai fornitori. Permette al tuo Claude di rispondere a domande come «a che punto è questo studente?», «cosa ho di aperto oggi?», «cosa è rimasto senza risposta in quel gruppo?» — senza che tu apra cinque schede diverse. **Non confonderlo con l'MCP Gateway.** L'MCP Gateway è quello a cui si collegano gli **agenti Conduit degli studenti** per arrivare a KrossBooking, Shelly e Stripe: lo usano gli assistenti degli ospiti, non tu. L'MCP Mattone Platform è **il tuo**, e parla solo con la piattaforma. I due nomi sono nel [glossario](/inizia-qui/glossario). Questa pagina serve a collegartelo. **Non devi saper programmare**, e nella maggior parte dei casi ti bastano due minuti: incolli un indirizzo dentro Claude e hai finito. Il token che ti viene consegnato è **tuo**, e vale come una password: chi ce l'ha sei tu, agli occhi del sistema. Non si gira a un collega, non si incolla in una chat, non si mette dentro un repository, non finisce in uno screenshot. Se pensi che qualcuno l'abbia visto, dillo in `#mattone-team`: te ne facciamo un altro in trenta secondi e il vecchio smette di funzionare. ## Due modi per collegarlo. Quasi sempre ti serve il primo | | **Connettore remoto** | **Installazione locale** | | - | - | - | | Cosa fai | incolli un indirizzo dentro Claude | apri il terminale e installi un programma | | Ti serve il terminale? | **no** | sì | | Ti serve Node? | **no** | sì (versione 20 o più recente) | | Funziona su | Claude sul web, desktop e Claude Code | solo Claude Code sul tuo computer | | Ci trovi | studenti, voci, richieste | **tutto quello a sinistra, più qualche strumento in più** | Se non hai un motivo preciso per usare il secondo, **usa il primo**: sono due minuti e non tocchi niente sul tuo computer. Il connettore remoto copre studenti, voci e richieste: cioè quello che serve tutti i giorni. Restano fuori un paio di strumenti che leggono dati **sul tuo computer**, e per quel motivo da un indirizzo remoto non possono funzionare: se ti servono, ti serve l'installazione locale. ## Il connettore remoto, in due minuti Lo chiedi in `#mattone-team`. È una riga sola e ha questa forma: ```text theme={null} https://mcp.mattone.co/api/mcp/team/ ``` L'ultima parte è **il tuo token**, ed è quello che ti fa riconoscere. Per questo l'indirizzo intero va trattato come una password: vale come una. In Claude vai su **Impostazioni → Connettori → Aggiungi connettore personalizzato**, incolla l'indirizzo, dai un nome (per esempio `MCP Mattone Platform`) e salva. Non ti chiede né utente né password: il riconoscimento è già dentro l'indirizzo. Scrivi a Claude: ```text theme={null} chi sono? ``` Se ti risponde con il tuo nome e il tuo ruolo, è collegato. Se ti dice che non trova lo strumento, il connettore non si è attivato: chiudi e riapri Claude, e ricontrolla di aver incollato l'indirizzo **intero**, fino all'ultimo carattere. **L'indirizzo è una credenziale.** Chi ce l'ha è te, agli occhi del sistema. Non si gira a un collega, non si incolla in una chat, non finisce in un repository, non si mette in uno screenshot. Se pensi che l'abbia visto qualcun altro, dillo in `#mattone-team`: te ne facciamo un altro e **il vecchio smette di funzionare all'istante**. ### Quando qualcosa non va, l'errore te lo dice Il connettore non risponde mai con un errore muto: ogni guasto arriva con un'etichetta che dice **di chi è il problema**. Serve a non farti aprire il ticket sbagliato. | Cosa leggi | Cosa vuol dire | Cosa fai | | - | - | - | | `TOKEN_NON_VALIDO` | il tuo token è scaduto o è stato revocato | chiedine uno nuovo in `#mattone-team` e rifai l'indirizzo | | `PERMESSO_MANCANTE` | il token è buono, ma quella operazione non è nel tuo ruolo | non è un guasto: se ti serve davvero, chiedi che ti allarghino il permesso | | `MCP_TEAM_NON_INSTALLATO` | manca un pezzo lato piattaforma | **non dipende da te**: segnalalo e basta | | `PIATTAFORMA_IRRAGGIUNGIBILE` | la piattaforma non ha risposto | è passeggero: riprova fra qualche minuto | | `PIATTAFORMA_IN_ERRORE` | la piattaforma ha risposto male | copia il messaggio e segnalalo | | `TOOL_SCONOSCIUTO` | hai chiesto uno strumento che qui non c'è | è uno di quelli che esistono solo nell'installazione locale | *** ## Cosa sa fare, in pratica | Se vuoi sapere… | Chiedi qualcosa tipo… | | - | - | | a che punto è uno studente | «fammi il quadro completo di questo studente» | | chi si è fermato | «elencami gli studenti fermi» | | cosa devi fare tu oggi | «quali voci ho aperte oggi?» | | cosa è fermo da troppo tempo | «cosa è fermo da più di sette giorni?» | | di cosa non si sta occupando nessuno | «quali voci sono senza titolare?» | | se una richiesta a un fornitore è in ritardo | «quali richieste ai fornitori sono in sofferenza?» | | cosa è rimasto senza risposta a un cliente | «cosa è rimasto senza risposta nel suo gruppo?» | | quando sono le prossime group call | «elencami le prossime group call» | | spostare o annullare una group call | «sposta la group call di giovedì 8 ottobre alle 18» · «annulla la call di mercoledì 30 settembre» | **Aprire, assegnare e chiudere le voci** è il lavoro di tutti i giorni dei setter e di chi risolve. La procedura completa, passo per passo, è in [La coda Voci](/delivery/coda-voci). **Spostare o annullare una group call avvisa tutti gli studenti** (dal 16/09/2026, solo per il team). In un colpo solo cambia il calendario, la pagina Eventi e manda una mail con l'orario vecchio e quello nuovo. Per questo va in **due passi**: prima Claude ti mostra cosa cambia e quante persone riceveranno la mail, e procede solo se gli rispondi di sì. Puoi spostare **solo quella data** oppure **quella data e tutte le successive**. Se la mail non parte, la risposta te lo dice: non darlo per fatto. **Una cosa da sapere sul semaforo degli studenti.** Quando l'MCP dice che qualcuno è «fermo», vuol dire che **non ha collegato i sistemi** — non che non stia lavorando. Il lavoro vero degli studenti (video, campagne, contratti, sopralluoghi) non passa dalla piattaforma. Prima di scrivere a qualcuno che è fermo, guarda il suo gruppo: molto spesso è tutt'altro che fermo. L'MCP te lo ricorda da solo in ogni risposta, ed è lì apposta. *** ## L'installazione locale Ti serve **solo** se ti servono anche gli strumenti che leggono dati sul tuo computer. Per tutto il resto, il connettore remoto qui sopra fa le stesse cose senza farti aprire il terminale. Gli strumenti WhatsApp funzionano se sul tuo computer c'è l'MCP WhatsApp: vedi [MCP WhatsApp](/riferimenti/whatsapp) (Mac e Windows) e, una volta installato, [Collegarlo all'MCP Mattone Platform](/riferimenti/whatsapp/collegare-mattone-platform) — lo trova da solo, non serve configurare niente qui. ### Cosa ti serve prima di cominciare Apri il terminale e scrivi: ```bash theme={null} claude --version ``` Se risponde con un numero, sei a posto. Se dice *command not found*, Claude Code non è installato: sistemalo prima di andare avanti (vedi [Prompt e Claude Code](/riferimenti/prompt-claude-code)). ```bash theme={null} node --version ``` Deve rispondere `v20` o un numero più alto. Se è più basso, o se dice *command not found*, scarica Node da [nodejs.org](https://nodejs.org) scegliendo la versione **LTS**, poi riprova. Ti vengono consegnati insieme, in `#mattone-team`: * **una riga da incollare nel terminale**, che scarica il programma; * **il tuo token personale**, una riga di testo che serve a farti riconoscere. Tienili tutti e due a portata di mano. Se ti manca uno dei due, chiedilo **prima** di continuare: senza token l'MCP si installa ma non risponde a niente. ### Installazione Aprila nel terminale e premi Invio. Scarica il programma e prepara quello che gli serve per funzionare: ci mette qualche secondo e stampa parecchie righe, è normale. Se ti risponde *Repository not found*, oppure ti chiede una password, vuol dire che il tuo account non ha ancora accesso. **Non è un errore tuo**: scrivilo in `#mattone-team`. Alla fine il programma si ferma e ti chiede di incollare il tuo token. Incollalo tutto intero e premi Invio. Non compare a schermo mentre lo incolli ed è giusto così. Non viene salvato in nessun file che si possa condividere per sbaglio. Se ti dice che il token **contiene uno spazio**, quasi sempre vuol dire che la copia si è spezzata: ricopialo dall'inizio alla fine e rilancia. Se tutto è andato bene, alla fine leggi `Fatto.` e una frase che ti dice cosa scrivere in Claude Code per provarlo. Se invece leggi una riga che comincia per `✗`, **quella riga dice cosa manca**: leggila, è scritta per essere capita. Se non ti torna, copiala in `#mattone-team`. ### La prova che funziona davvero Che l'installazione dica «fatto» vuol dire che il programma parte, **non** che ti riconosce. La prova vera è questa: apri Claude Code e scrivi > chiedi all'MCP Mattone Platform chi sono Deve risponderti con **il tuo nome e la tua email**. Se ti risponde con quelli, hai finito. Poi prova le due cose che userai davvero: > quali voci ho aperte oggi? > a che punto è quello studente? ### Cosa fare se non funziona Nella grande maggioranza dei casi è un errore di copia: un pezzo in meno all'inizio o alla fine, oppure uno spazio finito dentro. Rilancia l'installazione e ricopia il token **tutto intero**, dal primo all'ultimo carattere. Se dopo il secondo tentativo dice ancora la stessa cosa, il token è stato revocato o è scaduto: chiedi che te ne facciano uno nuovo. Non è recuperabile ed è voluto. Non c'è niente da sistemare sul tuo computer. Vuol dire che la parte della piattaforma che serve all'MCP non è ancora stata pubblicata. Segnalalo in `#mattone-team` e riprova quando ti dicono che è online. Il tuo token ti fa **leggere** ma non scrivere, oppure ti fa aprire e chiudere voci ma non toccare le richieste ai fornitori. Non è un guasto: è una scelta, e il messaggio ti dice esattamente quale permesso manca. Se ti serve, chiedilo: si allarga in un minuto e **non devi rifare l'installazione**. **È corretto, e non è un guasto.** Il registro dei messaggi WhatsApp vive sul computer dove è installato l'MCP WhatsApp: se non è il tuo, dal tuo non si vede. L'MCP te lo dice apertamente invece di risponderti «nessun messaggio». La differenza conta: una risposta vuota ti farebbe concludere che non c'è niente di aperto, quando la verità è che non lo stai proprio guardando. Installa l'MCP WhatsApp sul tuo computer seguendo [MCP WhatsApp](/riferimenti/whatsapp): una volta installato, questa parte funziona da sola, senza bisogno di reinstallare l'MCP Mattone Platform. Se hai già installato tutto e vedi ancora questo messaggio, vedi [Problemi e domande frequenti](/riferimenti/whatsapp/problemi#gli-strumenti-whatsapp-dell-mcp-mattone-platform-dicono-non-raggiungibile-da-questa-macchina). Manca uno dei due programmi di base. Torna alla sezione *Cosa ti serve prima di cominciare* e sistemalo lì: senza quelli non si va avanti, e non dipende dall'MCP. Chiudi **completamente** il terminale, riaprilo e riprova: ```bash theme={null} claude mcp list ``` Se ancora non c'è, rilancia l'installazione da capo. Non fa danni rifarla: la seconda volta sostituisce la prima. **Le note vocali si possono trascrivere, ma ci mettono.** Circa tre volte la durata dell'audio: un vocale di un minuto sono tre minuti di attesa. Per questo la prima richiesta **avvia** la trascrizione e te lo dice, e la seconda ti restituisce il testo. Una volta trascritta resta pronta: non la rifà. ### Aggiornarlo Ogni tanto esce una versione nuova. Il comando per prendertela è nella stessa nota di installazione che ti è stata consegnata: è una riga sola, e **non devi rifare il collegamento a Claude Code** — il token e la configurazione restano quelli. Se qualcosa in questa pagina non torna con quello che vedi sul tuo computer, **scrivilo in `#mattone-team`**: vuol dire che la pagina è sbagliata e va corretta. Vedi [Manutenzione docs](/riferimenti/manutenzione-docs). This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.