Skip to main content
Collega KrossBooking così che Conduit possa leggere le prenotazioni, i dati degli ospiti e lo stato del check-in per tutti gli appartamenti dello studente. Senza questa connessione attiva e verde, l’agente AI non ha accesso alle informazioni sulle prenotazioni e non può svolgere il suo lavoro. Completa questo step solo dopo aver finito l’anagrafica Notion.
Le credenziali Kross non vanno mai condivise in chat e vanno salvate subito nel Vault, mai in chiaro altrove. Attenzione a chi le procura: per i clienti partner le prendiamo noi dal Partner Portal, non si chiedono allo studente.

​
Prerequisiti

  • Step 1 · Anagrafica & Notion completato: il DB Apartments è allineato e tutti i listing_id sono valorizzati
  • Sai da dove arrivano le tre credenziali del cliente, perché cambia a seconda del caso:
Lo studente non deve mai scrivere a Kross per chiedere “le API”. È il cliente che apre la richiesta di condivisione dati con Mattone, non una richiesta di chiavi. La distinzione non è formale: nell’agosto 2026 diversi clienti hanno scritto a Kross chiedendo le API per collegarsi a strumenti terzi, e Kross ci ha contestato per iscritto la violazione dell’accordo. Le chiavi restano nostre, sempre.

​
Step (in ordine)

1

Solo caso partner: attiva il cliente sotto il nostro profilo

Le tre credenziali non esistono finché il cliente non è agganciato al nostro profilo partner. La sequenza, confermata per iscritto dal referente Kross, è questa e va nell’ordine:
  1. Il cliente apre un ticket all’assistenza Kross chiedendo l’accesso all’API tramite Mattone.co. Il testo glielo diamo noi, già pronto da copiare: vedi Accessi & credenziali. ⚠️ Non siamo noi a scrivere a Kross per ogni cliente: l’invio della lista endpoint è stato fatto una volta sola per il nostro profilo partner.
  2. Kross genera un link di condivisione dati per quel cliente.
  3. Il cliente accetta: apre la richiesta dal suo lato e Kross gli comunica il canone previsto dall’accordo partner, a unità al mese.
  4. Dopo l’accettazione le tre credenziali di quel cliente compaiono nel Partner Portal → sezione API → voce Credenziali. Le copiamo da lì.
Dettaglio completo, incluso il caso own, in Kross · Accessi & credenziali.
2

Inserisci le credenziali nella piattaforma Mattone

Dalla piattaforma Mattone, apri il pannello Admin → Collega Kross per lo studente in questione. Inserisci i tre valori (presi dal Partner Portal se partner, ricevuti dallo studente se own):
  • hotel_id
  • Username API
  • Password API
Premi Salva. Le credenziali vengono cifrate e archiviate nel Vault, non vengono mai mostrate in chiaro dopo il salvataggio.
3

Fai attivare il modulo di prenotazione online (Booking Engine)

Serve solo se lo studente avrà un sito di prenotazione diretta, ma va chiesto subito: lo attiva il proprietario dal suo pannello del gestionale, e va autorizzato il collegamento con Mattone.Senza, il collegamento sembra funzionare a metà: l’elenco degli appartamenti e i servizi rispondono, la ricerca di tariffe e disponibilità viene rifiutata con un errore che parla di credenziali. Misurato su due strutture reali il 07/09/2026: con il modulo attivo, 33 tariffe; senza, rifiuto — stesse credenziali, stesso minuto. Non perdere tempo a rigenerare le chiavi: sono sane.Vedi Direct booking: procedura guidata.
4

Verifica il test di connessione

Dopo il salvataggio, il sistema esegue automaticamente un test di connessione attraverso l’MCP Gateway (mcp.mattone.co). Attendi il risultato:
  • Verde ✅, le 3 credenziali sono salvate cifrate (cred_secret_id) nel Vault. Non serve creare nessuna chiave manuale: la chiave generica partner è già nostra. Gli strumenti dell’assistente si montano nello Step 3 · Conduit col bottone Provision; da lì il nostro ponte mcp.mattone.co recupera le 3 credenziali quando l’assistente lavora. Procedi.
  • Rosso ❌, la connessione ha fallito. Vedi la sezione qui sotto.
5

In caso di esito rosso: diagnostica

Se il test restituisce rosso, non procedere allo step successivo. Controlla in quest’ordine:
  1. Le credenziali sono quelle API (non quelle del portale web)
  2. L’hotel_id è corretto, lo studente a volte confonde l’ID hotel con l’ID catena
  3. L’account API è abilitato nel portale Kross (alcuni account hanno le API disattivate di default)
Per una guida completa alla diagnostica, consulta Kross · Troubleshooting.

​
Verifica

Questo step è completo quando:
  • Il test di connessione via mcp.mattone.co restituisce verde
  • Da un pannello di test, Conduit riesce a recuperare almeno una prenotazione reale per lo studente (anche storica)
Per la documentazione completa dell’integrazione KrossBooking, endpoint disponibili, scope delle API, limiti di frequenza e casi limite, consulta Kross · Panoramica.
Step completato? Procedi con → Step 3 · Conduit
▷ Prompt Claude Code: Collega Kross · incolla in Claude Code:

Collega Kross (piattaforma)

Inserisci le 3 credenziali (cifrate nel Vault)

Portale KrossBooking → API

Da qui lo studente prende hotel_id / username / password