Skip to main content
Lo studente collega PriceLabs a Mattone incollando Client ID e Client Secret: il resto è OAuth. Una volta collegato, la piattaforma legge gli insight di pricing (e Francesco AI può agire read+write sui prezzi in chat).
Aggiornato 21/09/2026, verificato dal vivo. Fino a settembre il meccanismo era un Client ID pubblico senza secret, preso da “AI Connector (MCP)”. PriceLabs è passato a un meccanismo diverso (“Clienti personalizzati”): genera Client ID e Client Secret insieme, e il secret è ora obbligatorio — senza, PriceLabs rifiuta lo scambio token con 401. Se trovi ancora riferimenti al vecchio percorso da qualche parte, sono superati.

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.
▷ Prompt Claude Code: Collega PriceLabs · incolla in Claude Code:

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