Prerequisiti
- Lo studente ha un account PriceLabs attivo su pricelabs.co, con i suoi listing già sincronizzati dal suo PMS (è PriceLabs a tenere il sync coi listing/prezzi, noi ci agganciamo in lettura/scrittura via MCP).
Collegamento
1
Crea il cliente personalizzato in PriceLabs
Lo studente va su PriceLabs → Account Settings → Connettore IA (MCP) → Clienti personalizzati → ”+ Aggiungi cliente personalizzato”. Dà un nome a piacere (es. “Mattone Platform”) e come URL di callback incolla esattamente
https://app.mattone.co/api/integrations/pricelabs/callback — deve essere identico, byte per byte.2
Copia Client ID e Client Secret
PriceLabs genera i due insieme. Il Client Secret si vede una volta sola: va copiato subito, non è recuperabile dopo. Se lo studente lo perde, deve cancellare il cliente personalizzato e crearne uno nuovo.
3
Incollali nella piattaforma Mattone
Su Connessioni → PriceLabs, incolla Client ID e Client Secret nei due campi dedicati e clicca Connetti. Parte il flusso OAuth (via POST, non in query string — il secret non finisce mai nell’URL).
4
Autorizza (OAuth PKCE + secret)
Lo studente fa login su PriceLabs e approva l’accesso (scope
read/write/write per personalizzazione, a sua scelta). Torni in piattaforma con esito verde (?pricelabs=ok).5
Verifica che i listing siano leggibili
Dopo il connect,
get_listings deve tornare i listing dello studente (listing_id, pms_name). Considera solo quelli synced.Come funziona (tecnico)
- MCP runtime:
https://mcp.pricelabs.co/mcp(Bearer access_token). - OAuth PKCE S256 + client_secret (confidential client). Il token si rinfresca al 401, mandando anche il secret.
- Il dominio
app.mattone.coè whitelistato da PriceLabs per i callback URL dei “Clienti personalizzati” (richiesto e ottenuto da PriceLabs il 20/09/2026) — sembra una whitelist a livello di dominio, non per singolo account PriceLabs, ma è stata verificata dal vivo solo con un account interno.
I connettori MCP si legano all’avvio sessione: un reconnect a caldo non entra nella sessione in corso, serve una sessione nuova. Se il connect non parte, verifica che l’URL di callback incollato in PriceLabs sia esattamente quello sopra (un carattere diverso e PriceLabs rifiuta), e che siano stati incollati sia Client ID che Client Secret.
Connessioni (piattaforma)
Card PriceLabs → incolla Client ID e Client Secret
PriceLabs → Clienti personalizzati
Account Settings → Connettore IA (MCP): da qui generi Client ID e Client Secret