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

# Mattone Docs: a chi è rivolto e come usarlo al meglio

> Scopri a chi è rivolto Mattone Docs, i tre profili del team, come sono organizzate le sezioni e la regola d'oro da seguire sempre.

Mattone Docs è pensato per l'intero team Mattone: dai developer che mantengono le integrazioni agli account manager non tecnici che onboardano gli studenti ogni settimana. L'obiettivo è che chiunque nel team riesca a portare online un nuovo property manager e a risolvere i problemi di integrazione più comuni senza dipendere da uno sviluppatore senior per ogni passo.

## I tre profili

Mattone Docs parla direttamente a tre figure che lavorano con la piattaforma in modi diversi.

**Team delivery / account manager non tecnico**
Gestisci l'onboarding degli studenti, configuri Conduit e coordini le attivazioni. Userai soprattutto la sezione Onboarding, i playbook Troubleshooting e il Glossario quando incontri un termine che non conosci. Non devi capire il codice, devi sapere dove guardare e cosa fare.

**Developer di riferimento**
Mantieni le integrazioni, scrivi i tool MCP e gestisci le credenziali nel Vault. Userai soprattutto le sezioni Integrazioni e Riferimenti (repo API, catalogo MCP, schema credenziali). Questa documentazione è la fonte di verità condivisa con il team non tecnico.

**Nuovo membro del team**
Stai imparando come funziona Mattone. Inizia da questa pagina, poi leggi il Glossario e la sezione Onboarding nell'ordine in cui è scritta. Ogni pagina apre con l'obiettivo dell'utente, segui quello e non ti perdi.

## Come sono organizzati

Mattone Docs è diviso in sezioni tematiche, ognuna con uno scopo preciso:

* **Onboarding studente**: la procedura guidata passo dopo passo per portare online un nuovo property manager, dall'anagrafica alla verifica finale
* **Integrazioni**: come funziona ogni pezzo della piattaforma (KrossBooking, Conduit, SwitchBot, Stripe, GHL) e come si collega agli altri
* **Troubleshooting**: il metodo di debug in 5 mosse e i codici di errore per ogni integrazione, con la soluzione associata
* **Casistiche**: playbook per le situazioni ricorrenti: studente che cambia PMS, porta che non risponde, agente che ignora un tool
* **Riferimenti**: repo API, catalogo MCP, schema delle credenziali nel Vault, contatti di escalation

## Regola d'oro

<Tip>
  Prima di collegare qualsiasi pezzo, un tool Conduit, una serratura, un PMS, apri la pagina **Integrazioni** corrispondente e segui i passi nell'ordine in cui sono scritti. L'ordine non è casuale: ogni passo crea la precondizione del successivo. Saltarlo è la causa numero uno di malfunzionamenti silenziosi.
</Tip>