Collegare un assistente AI a TESSA (MCP)

TESSA espone i suoi strumenti computazionali attraverso il Model Context Protocol (MCP). Ciò consente di guidare TESSA da un assistente AI come Claude, ChatGPT o Mistral — chiedendo in linguaggio naturale di creare quartieri, generare tracciati di rete, dimensionare tubazioni, eseguire simulazioni e altro ancora. L'assistente chiama gli stessi strumenti utilizzati dall'app web di TESSA, li esegue sul proprio account e sui propri progetti e riporta i risultati nella conversazione.

Questa pagina spiega come collegare a TESSA un assistente AI diffuso. Non è necessario installare nulla né scrivere codice — la connessione viene configurata tramite l'interfaccia del proprio assistente.

Cosa serve prima di iniziare

• Un account TESSA con accesso ai progetti su cui si desidera lavorare. L'assistente agisce come l'utente: può vedere e modificare solo i progetti che il proprio account può già vedere e modificare.
• Un assistente AI che supporti i connettori MCP remoti (a volte chiamati "custom connectors", "integrations" o "remote MCP servers"). Il supporto e i nomi esatti dei menu variano a seconda del prodotto e del piano — vedere le note per singolo strumento più sotto.
• L'URL dell'endpoint MCP di TESSA per la propria istanza. È l'indirizzo web di TESSA con /mcp aggiunto alla fine:

  https://<your-tessa-domain>/mcp
  

  
  Ad esempio, se normalmente si usa TESSA all'indirizzo https://app.example-tessa.ch, l'endpoint MCP è https://app.example-tessa.ch/mcp.
  Se non si è sicuri del proprio dominio TESSA, rivolgersi al proprio amministratore o al supporto clienti Planeto.

Come funziona l'accesso

Quando ci si collega la prima volta, l'assistente apre una pagina di login di TESSA nel browser. Si effettua l'accesso con le proprie normali credenziali TESSA (lo stesso login Auth0 usato per l'app web) e l'assistente riceve un token sicuro per agire per conto dell'utente.

• Si effettua il login una volta per connessione; successivamente l'assistente rinnova automaticamente il proprio accesso.
• L'assistente non vede mai la password — riceve solo un token emesso dopo l'accesso.
• Ogni chiamata a uno strumento viene eseguita come l'utente, quindi tutte le autorizzazioni sui progetti e l'isolamento dei dati continuano ad applicarsi.

Collegare Claude

Claude (claude.ai e l'app desktop Claude) supporta i server MCP remoti tramite custom connectors.

1. In una conversazione Claude, fare clic sul pulsante "+" (o search & tools) accanto alla casella dei messaggi.
2. Scegliere Manage connectors → Add custom connector (la dicitura esatta varia a seconda della versione).
3. Assegnare un nome, ad es. TESSA.
4. Incollare l'URL dell'endpoint MCP: https://<your-tessa-domain>/mcp
5. Salvare. Claude aprirà una finestra del browser chiedendo di accedere a TESSA. Completare l'accesso.
6. Tornati in Claude, abilitare il connettore TESSA per la conversazione. Ora è possibile chiedere a Claude di usare gli strumenti di TESSA.

{
  "mcpServers": {
    "tessa": {
      "url": "https://<your-tessa-domain>/mcp"
    }
  }
}

Collegare ChatGPT

ChatGPT supporta i server MCP remoti tramite connectors (la disponibilità dipende dal proprio piano; i connettori MCP personalizzati/remoti sono tipicamente disponibili nei livelli Plus, Pro, Team ed Enterprise e in modalità sviluppatore).

1. Aprire Settings → Connectors (o Settings → Connections).
2. Scegliere Add connector / Crea e selezionare un custom / remote MCP server.
3. Inserire un nome (TESSA) e l'URL del server: https://<your-tessa-domain>/mcp
4. Scegliere OAuth come metodo di autenticazione se richiesto. Salvare.
5. ChatGPT apre una finestra del browser per accedere a TESSA. Completare l'accesso.
6. In una chat, abilitare il connettore TESSA (tramite il menu tools / connectors) e chiedere a ChatGPT di usare TESSA.

Collegare Mistral (Le Chat)

Le Chat di Mistral supporta i connettori MCP.

1. In Le Chat, aprire Settings → Connectors (o l'area connectors / tools).
2. Scegliere di aggiungere un connettore custom o remote MCP.
3. Inserire un nome (TESSA) e l'URL del server: https://<your-tessa-domain>/mcp
4. Salvare e completare l'accesso a TESSA nella finestra del browser che si apre.
5. Abilitare il connettore nella propria conversazione.

Altri strumenti compatibili con MCP

Qualsiasi client che supporti server MCP remoti autenticati tramite OAuth può collegarsi usando lo stesso URL di endpoint (https://<your-tessa-domain>/mcp). La connessione segue sempre lo stesso schema:

1. Aggiungere un server MCP remoto/personalizzato che punti a https://<your-tessa-domain>/mcp.
2. Utilizzare l'autenticazione OAuth.
3. Accedere a TESSA nel browser quando richiesto.

Cosa è possibile fare una volta collegati

Dopo la connessione, l'assistente può chiamare gli strumenti di TESSA per conto dell'utente. Le richieste tipiche includono:

• "Crea un quartiere in TESSA a partire dagli edifici di questa regione."
• "Genera un tracciato di rete ad albero di copertura minimo per il mio quartiere."
• "Dimensiona le tubazioni ed esegui una simulazione termica."
• "Dimensiona le fonti di calore per la centrale energetica."

L'assistente sceglie lo strumento pertinente, lo esegue e attende il risultato (la maggior parte degli strumenti viene eseguita come calcolo in background e può richiedere fino a qualche minuto). I risultati compaiono sia nella conversazione sia nell'app web di TESSA, dove è possibile ispezionarli come di consueto.

Risoluzione dei problemi

Se i problemi di connessione persistono, contattare il supporto clienti Planeto.

Sicurezza e privacy

• L'assistente si autentica come l'utente tramite il login standard di TESSA. Non può accedere a nulla a cui il proprio account non possa accedere.
• Nessuna password viene condivisa con l'assistente — solo un token emesso dopo l'accesso.
• Le conversazioni e le richieste agli strumenti sono elaborate dal provider AI scelto (Anthropic, OpenAI, Mistral, ecc.) secondo i loro termini. Evitare di incollare dati sensibili che non si vorrebbe inviare a tale provider.