Vai al contenuto principale
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.
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.
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

1

Aggiungi il marketplace Ecco

Nel terminale esegui:
2

Installa il plugin 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.

​
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.
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.
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.
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.
Aggiorna Claude Code all’ultima versione e installa di nuovo il plugin. Non incollare il token nella chat come soluzione.
Verifica di essere entrato in Ecco come owner o admin della struttura, poi scrivi a [email protected].
Ogni token e ogni struttura hanno un limite di richieste al minuto. Attendi un minuto e chiedi di nuovo. Vedi rate_limited.
La scheda compare a owner e admin della struttura selezionata. Se hai uno di questi ruoli e non la vedi, scrivi a [email protected].
Ti serve aiuto? Scrivi a [email protected] indicando l’assistente che usi, il messaggio di errore e l’ID della richiesta, se compare. Non inviare mai il token.