> ## Documentation Index > Fetch the complete documentation index at: https://docs.tryecco.com/llms.txt > Use this file to discover all available pages before exploring further. # Integrazioni AI > Chiedi a Claude Code o Codex di arrivi, prenotazioni e statistiche Ecco con un token personale in sola lettura. Collega Claude Code o Codex a Ecco e fai domande sulla tua struttura con parole semplici: chi arriva oggi, com'è andato il mese scorso, quanto del tuo piano hai usato. > [!NOTE] > > Il collegamento è **in sola lettura**. L'assistente legge i tuoi dati e non può modificare nulla: prenotazioni, messaggi agli ospiti e impostazioni restano in Ecco. ## Cosa può leggere l'assistente * Arrivi, partenze e prenotazioni * Le tue strutture * Statistiche e report mensili * Utilizzo del piano Il testo delle conversazioni con gli ospiti è escluso per impostazione predefinita. L'assistente vede solo ciò che vede il tuo account Ecco. ## Chi può collegarsi Ti serve il ruolo di **owner** o **admin** sulla struttura da collegare. Ogni token è personale e vale per una sola struttura. ## Crea il token **1. Apri Integrazioni AI** Nella dashboard Ecco apri **Configurazione** nella barra laterale, seleziona la struttura e apri la scheda **Integrazioni AI**. **2. Crea il token** Seleziona **Crea token** e scegli la **Durata**: 7, 30 o 90 giorni. Lascia disattivato **Includi conversazioni ospiti (testo dei messaggi)**. **3. Copialo subito** Copia il token e conservalo in un gestore di password. Ecco lo mostra **una sola volta**. Poi seleziona **Ho salvato il token**. > [!WARNING] > > Non incollare mai il token in una chat AI, in un'email, in un ticket o in uno screenshot. Se pensi che qualcuno l'abbia visto, revocalo subito. ## Collega il tuo assistente **Claude Code** **1. Aggiungi il marketplace Ecco** Nel terminale esegui: ```bash theme={null} claude plugin marketplace add https://github.com/try-ecco/ecco-plugins ``` **2. Installa il plugin Ecco** ```bash theme={null} claude plugin install ecco@ecco ``` Quando ti viene chiesto l'**Ecco token**, incolla il tuo token. Claude Code lo salva nel portachiavi di sistema, non in un file. **3. Apri una nuova sessione** Apri una nuova sessione di Claude Code e fai una prima domanda. **Codex** **1. Imposta il token senza salvarlo nella cronologia** Nel terminale esegui la prima riga, incolla il token (resta nascosto) e premi **Invio**. Poi esegui la seconda riga. ```bash theme={null} read -rs ECCO_MCP_TOKEN export ECCO_MCP_TOKEN ``` **2. Aggiungi il server Ecco** ```bash theme={null} codex mcp add ecco --url https://be.tryecco.com/mcp --bearer-token-env-var ECCO_MCP_TOKEN ``` Il comando contiene il nome della variabile, mai il token. **3. Aggiungi i flussi Ecco** ```bash theme={null} codex plugin marketplace add https://github.com/try-ecco/ecco-plugins codex plugin add ecco@ecco ``` Il plugin aggiunge flussi pronti all'uso sopra il collegamento. **4. Avvia Codex dallo stesso terminale** Esegui `codex` nel terminale in cui hai impostato il token e fai una prima domanda. > [!TIP] > > Il token resta disponibile solo finché quella finestra del terminale è aperta. Ogni volta che apri un nuovo terminale, ripeti il primo passaggio prima di avviare Codex, oppure lascia che il tuo gestore di password fornisca `ECCO_MCP_TOKEN`. ## Prova subito Inizia controllando il collegamento: * “A quale struttura Ecco sei collegato?” Poi chiedi ciò che ti serve: * “Chi arriva e chi parte oggi?” * “Mostrami le prenotazioni del prossimo weekend.” * “Com'è andato il mese scorso rispetto a quello prima?” * “Quanto del mio piano ho usato questo mese?” Le date seguono il fuso orario della struttura. Le risposte si basano sui dati già presenti in Ecco. > [!NOTE] > > Nelle giornate particolarmente intense, Ecco restituisce fino a 200 prenotazioni: prima gli arrivi, poi le partenze e infine gli ospiti già in struttura. L'assistente segnala chiaramente quando l'elenco è parziale. In questo caso, ogni totale indicato è un valore minimo, per esempio “almeno 200 arrivi”. ## Revoca un token Apri **Configurazione → Integrazioni AI** e seleziona **Revoca** accanto al token. L'accesso si interrompe subito. La stessa pagina mostra quando scade ogni token e quando è stato usato l'ultima volta. Per sostituire un token perso o scaduto, creane uno nuovo e aggiorna l'assistente. Ecco non mostra mai di nuovo un token esistente. ## I tuoi dati Le risposte arrivano da Ecco e il fornitore dell'assistente che usi (Anthropic per Claude Code, OpenAI per Codex) riceve i risultati necessari per rispondere. Tratta queste risposte come qualsiasi dato di prenotazione: mantienile riservate. Non inserire nelle domande password, codici di accesso, dati di pagamento o documenti d'identità. ## Risoluzione dei problemi L'assistente mostra il codice di errore restituito da Ecco. Per l'elenco completo, vedi i [codici di errore](/it/ops/errori). > **HTTP 401 o “unauthorized”** > > Il token manca, è stato copiato male, è scaduto o è stato revocato. Controlla il suo stato in **Configurazione → Integrazioni AI**, poi crea un nuovo token e ripeti la configurazione. Vedi [unauthenticated](/it/ops/errori#unauthenticated). > **Codex funzionava, poi si è fermato dopo un riavvio** > > Il token era impostato in un terminale che è stato chiuso. Le app desktop e le nuove finestre del terminale non vedono una variabile impostata in un altro terminale. Imposta di nuovo `ECCO_MCP_TOKEN` e avvia Codex dallo stesso terminale. > **Claude Code non ha chiesto il token** > > Aggiorna Claude Code all'ultima versione e installa di nuovo il plugin. Non incollare il token nella chat come soluzione. > **L'assistente non vede nessuna struttura** > > Verifica di essere entrato in Ecco come owner o admin della struttura, poi scrivi a [support@tryecco.com](mailto:support@tryecco.com). > **“Too many requests” (HTTP 429)** > > Ogni token e ogni struttura hanno un limite di richieste al minuto. Attendi un minuto e chiedi di nuovo. Vedi [rate\_limited](/it/ops/errori#rate_limited). > **Non vedo la scheda Integrazioni AI** > > La scheda compare a owner e admin della struttura selezionata. Se hai uno di questi ruoli e non la vedi, scrivi a [support@tryecco.com](mailto:support@tryecco.com). Ti serve aiuto? Scrivi a [support@tryecco.com](mailto:support@tryecco.com) indicando l'assistente che usi, il messaggio di errore e l'ID della richiesta, se compare. Non inviare mai il token. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.