Vai al contenuto principale

Collega Claude, ChatGPT o altri strumenti IA

Aggiungi il connettore MCP di VIVIN a Claude, ChatGPT, Gemini o a qualsiasi altro strumento IA che supporti i server MCP, poi fai domande a quello strumento su prenotazioni, inquilini e finanze senza uscirne. MCP, il Model Context Protocol, è lo standard che gli strumenti IA usano per collegarsi ad altre app.

Questa pagina riguarda gli strumenti IA usati da te e dal tuo team. Il ChatBot rivolto agli inquilini è un prodotto separato.

Dove trovarlo: Impostazioni → IA / MCP, sotto-scheda Connessione MCP (https://platform.vivin.app/settings/mcp). Il banner Vai a MCP in Impostazioni → Integrazioni apre lo stesso posto. Serve il permesso di ruolo Mcp (la riga Mcp sotto Account Settings in Impostazioni → Utenti → Permessi per ruolo), che Super Admin e Admin hanno per impostazione predefinita. Gli altri ruoli con questo permesso vedono invece una scheda Collega il tuo client IA con i passaggi per Claude e ChatGPT. Solo i Super Admin e gli Admin possono creare chiavi API.

Prima di collegare​

  • Accesso: il tuo ruolo ha il permesso Mcp, e un amministratore non ha disattivato il tuo Accesso IA.
  • Almeno un'area attiva: almeno un'area deve essere Sola lettura o Modifica per te. Gli amministratori lo impostano in Impostazioni → IA / MCP → Permessi. Se ogni area è Off, la pagina di approvazione non ti lascia continuare.
  • L'URL di connessione: è mostrato in cima a ogni guida di connessione, con un pulsante Copia URL. Incollalo esattamente come appare. Non aggiungere /sse né altre terminazioni.

La sotto-scheda Connessione MCP ha una scheda per Claude, ChatGPT, Gemini e Altri client. Ogni scheda ha un pulsante Aggiungi che apre la guida per quello strumento. I passaggi sono anche qui sotto.

Collega Claude​

Funziona su claude.ai e nell'app desktop di Claude. Accedi con il tuo account VIVIN, quindi non serve nessuna chiave API.

  1. Apri Claude e vai su Impostazioni.
  2. Apri Connectors.
  3. Clicca su Add custom connector.
  4. Inserisci un nome, per esempio "VIVIN", e incolla l'URL di connessione.
  5. Clicca su Add. VIVIN apre la pagina di approvazione. Controlla l'account e clicca su Authorize.

Collega ChatGPT​

Accedi con il tuo account VIVIN, quindi non serve nessuna chiave API.

  1. Apri ChatGPT e vai su Impostazioni → Connectors. In alcuni piani si trova nel menu laterale sotto Plugins.
  2. Clicca su + o New per creare un connettore personalizzato.
  3. Dagli un nome, per esempio "VIVIN".
  4. In Connection, scegli Server URL e incolla l'URL di connessione.
  5. In Authentication, scegli OAuth.
  6. Spunta I understand and want to continue e clicca su Create.
  7. Accedi con il tuo account VIVIN e clicca su Authorize nella pagina di approvazione.

Collega Gemini o un altro strumento IA​

Accedere con il tuo account VIVIN funziona per Claude, ChatGPT e le app IA installate sul tuo computer che supportano l'accesso. Gli altri strumenti IA basati sul web hanno bisogno di una chiave API.

  1. Nel tuo strumento IA, apri le impostazioni dei server MCP. Gli strumenti lo chiamano server MCP, connettore o strumento personalizzato.
  2. Aggiungi un nuovo server e incolla l'URL di connessione.
  3. Se lo strumento propone di accedere, accedi con il tuo account VIVIN e approva.
  4. Se non riesce ad accedere, crea una chiave API e inviala come Bearer token: Authorization: Bearer <your key>.

Per gli strumenti che usano un file di configurazione JSON, la guida Altri client mostra un Esempio di configurazione del client MCP con il tuo URL già inserito e un pulsante Copia configurazione:

{
  "mcpServers": {
    "vivin": {
      "url": "<your connection URL>",
      "headers": {
        "Authorization": "Bearer <your key>"
      }
    }
  }
}

Crea una chiave API​

Possono farlo solo i Super Admin e gli Admin.

  1. Vai su Impostazioni → IA / MCP → Chiavi API e clicca su Genera chiave.
  2. Inserisci un Nome della chiave che dica dove la userai, per esempio "Claude Desktop".
  3. Scegli una Scadenza: 30 giorni, 90 giorni (il valore predefinito), 180 giorni o Non scade mai.
  4. Clicca su Genera chiave.
  5. Clicca su Copia chiave e incollala subito nel tuo strumento IA. VIVIN mostra la chiave una sola volta.

La tabella Chiavi API elenca ogni chiave del tuo account con la data in cui è stata Creata, l'Ultimo utilizzo e quando Scade. Lo Stato è Attiva, Revocata o Scaduta.

Una chiave agisce come la persona che l'ha creata, con i permessi IA di quella persona. Smette di funzionare se quella persona viene disattivata o se il suo Accesso IA viene disattivato.

La pagina di approvazione​

Quando Claude, ChatGPT o un altro strumento si collega con l'accesso, VIVIN apre per lui una pagina Authorize. La pagina mostra:

  • Signed in as: l'email VIVIN e l'azienda per cui agirà la connessione, con un link Sign out.
  • The following tools will be available: le aree che stai per condividere. Ognuna mostra Read-only o Edit e il suo numero di strumenti. Espandi un'area per vedere gli strumenti.
  • Authorize per collegare, oppure Cancel per rifiutare. Se annulli, allo strumento IA viene detto che l'accesso è stato negato.

La pagina non chiede mai la tua password. Usa la sessione VIVIN nel tuo browser. Se non hai effettuato l'accesso, clicca su Sign in to VIVIN. Accedi nel modo consueto (codice via email, accesso con Google) e torni alla pagina di approvazione.

Se la pagina dice No MCP tools are enabled for this user yet, Authorize resta grigio. Chiedi a un amministratore di attivare almeno un'area in Impostazioni → IA / MCP, poi riavvia la connessione.

Cosa può vedere l'IA collegata​

Lo strumento collegato legge gli stessi dati di Genius, l'assistente integrato di VIVIN, quindi puoi chiedergli, per esempio, "Quali unità sono libere il mese prossimo?". Può leggere ma non modificare i tuoi dati, tranne i tuoi report programmati. Come Genius, riceve esattamente i tuoi permessi IA. Per ogni area, è il più restrittivo di tre valori: l'impostazione dell'account, quella per te in Permessi per utente e il limite fissato dal tuo ruolo. Gli amministratori impostano i primi due in Impostazioni → IA / MCP. Finché un amministratore non li cambia, ogni area è Sola lettura e Report programmati è Modifica.

AreaCosa può leggere l'IA
PrenotazioniPrenotazioni, disponibilità libera, prossimi ingressi, piani di pagamento, panoramica delle vendite
AnnunciUnità, calendari, tabelle degli affitti, blocchi manuali
ProprietàProprietà, le loro unità, commenti, serrature smart
InquiliniInquilini e le loro prenotazioni, richieste di servizio, sondaggi
ManutenzioneTicket, numero di ticket e tempo di chiusura, check-in e check-out di oggi, avanzamento e passaggi di check-in/out, panoramica delle operazioni, report e configurazione dell'inventario
PagamentiValori contrattuali, transazioni, pagamenti, depositi, sconti, impostazioni di fatturazione
FattureBollette delle utenze, mappa dei costi, flussi di cassa
ProprietariProprietari e report dei proprietari
AnalisiRicavi, entrate per proprietà, panoramica finanziaria, debito, occupazione, costi, tasso di chiusura della manutenzione, obiettivi di ricavo
CanaliStato dei canali e integrazioni collegate
ComunicazioneRegole e messaggi automatici, notifiche, conversazioni WhatsApp ed email, impostazioni del ChatBot, FAQ e monitoraggio, feedback degli inquilini sul ChatBot
SupportoI tuoi ticket di supporto VIVIN e l'abbonamento
TeamMembri del team e i loro permessi
Report programmatiI tuoi report programmati
  • Sola lettura: l'IA non può creare, modificare o eliminare prenotazioni, ticket, pagamenti o qualsiasi altra cosa. Modifica è disponibile solo per Report programmati. Lì, il tuo strumento IA può creare, mettere in pausa, riprendere, modificare o annullare i tuoi report ricorrenti ("mandami ogni venerdì quante stanze sono ancora libere"). I tipi di report e la consegna sono descritti nella pagina di Genius.
  • Esportazioni: in ogni area l'IA può anche restituire le stesse liste che puoi esportare in VIVIN, in CSV, fino a 20.000 righe.
  • I link che funzionano come chiavi non vengono mai inviati: i link del portale inquilino, i link ai file privati e i feed dei calendari vengono trattenuti. L'IA ti dice che un file esiste, e lo apri tu in VIVIN.
  • Aiuto sul prodotto: un insieme di strumenti Guida VIVIN risponde alle domande "come faccio a…" su VIVIN. Non contengono dati dell'account e non dipendono dalle impostazioni delle aree.
  • Il tuo fornitore di IA: i dati che questi strumenti restituiscono vengono inviati allo strumento IA che hai collegato. Collega solo strumenti che la tua azienda consente per i dati aziendali.

Restare collegati o rimuovere l'accesso​

Una connessione con accesso è autorizzata per 60 giorni. Il periodo riparte ogni volta che lo strumento IA rinnova il suo accesso, quindi una connessione che usi regolarmente resta collegata. Se lo strumento non rinnova entro 60 giorni, ti chiede di accedere di nuovo a VIVIN.

Quando un amministratore cambia i permessi IA, gli strumenti collegati recepiscono la modifica a breve. Non devi ricollegarli.

Per rimuovere l'accesso:

Per fermare…Fai così
Uno strumento IARimuovi il connettore VIVIN nelle impostazioni di quello strumento
Uno strumento che usa una chiave APIImpostazioni → IA / MCP → Chiavi API → clicca sull'icona del cestino accanto alla chiave → Revoca. L'accesso finisce subito e non si può ripristinare.
Ogni strumento IA collegato da un membro del teamImpostazioni → IA / MCP → Permessi → Permessi per utente → scegli il Membro del team → Accesso IA Disattivato → Salva modifiche
Tutto per chi lascia l'aziendaDisattivalo in Impostazioni → Utenti. Le sue connessioni con accesso e le sue chiavi API smettono di funzionare.

VIVIN non mostra un elenco delle app collegate con accesso. Per escludere un membro del team, disattiva il suo Accesso IA.

Consigli​

  • Browser condiviso? Controlla Signed in as nella pagina di approvazione. Usa Sign out per passare all'account VIVIN giusto prima di cliccare su Authorize.
  • Non creare chiavi API per i colleghi. Una chiave porta i permessi di chi l'ha creata. I colleghi senza il ruolo di amministratore possono collegare Claude o ChatGPT accedendo con il proprio account.
  • La Finestra dello storico (in Permessi per utente) vale anche per gli strumenti IA collegati: lo storico del denaro (transazioni, entrate, flussi di cassa, bollette, liquidazioni dei proprietari ed esportazioni) viene tagliato a quella data, e la risposta lo dice. I singoli record aperti uno per uno e i dati attuali non sono limitati.
  • Attività di Genius nella sotto-scheda Attività non elenca cosa hanno fatto Claude, ChatGPT o altri strumenti collegati. La tabella Chiavi API mostra quando ogni chiave è stata usata l'ultima volta (Ultimo utilizzo).
  • I titoli degli strumenti che il tuo strumento IA mostra seguono la lingua dell'interfaccia VIVIN (inglese, portoghese, spagnolo o italiano) del momento in cui l'hai collegato. I nomi tecnici degli strumenti restano in inglese.