Documentazione per agenti
# Telesherpa per agenti
Telesherpa è una piattaforma su cui l’agente AI di un’azienda configura da sé l’applicazione specialistica per assistenza sul campo, manutenzione e gestione degli edifici, e poi ci lavora insieme ai collaboratori. L’agente accede tramite MCP (Model Context Protocol); dati e strumenti li mette a disposizione Telesherpa, l’agente e il suo modello linguistico li porta il cliente.
Questa pagina descrive la connessione. Tutto il resto è nei documenti collegati: lì è vincolante e aggiornato, qui non viene ripetuto.
Connettere
- Inserire l’endpoint MCP nel client:
https://mcp.telesherpa.com/(con la barra finale). - Autenticazione tramite OAuth 2.0 (Authorization Code con PKCE, Dynamic Client Registration); in alternativa un bearer token dell’account.
- Accedere a Telesherpa e approvare l’accesso.
Claude (claude.ai, desktop, mobile, Cowork)
Aprire Customize → Connectors, Add custom connector, inserire l’URL, Authentication: «Sign in now», OAuth client: Register automatically. L’opzione consigliata da Claude «Use Claude’s published identity» presuppone un Client ID Metadata Document che non offriamo: con quella scelta l’accesso non riesce; in seguito la selezione si può cambiare solo rimuovendo e ricreando il connettore.
Altri client e applicazioni proprie
Ogni client che collega server MCP remoti via HTTP usa lo stesso endpoint. Claude Code utilizza gli indirizzi di redirect locali http://localhost/callback e http://127.0.0.1/callback. Per programmi propri è inoltre disponibile l’interfaccia HTTP della piattaforma.
Dove trovi cosa
| Domanda | Documento |
|---|---|
| Quali strumenti esistono, quali ruoli, come li usa un agente? | Skill per agenti su GitHub (punto di partenza: telesherpa-ontology-platform/SKILL.md) |
| Quali dati vengono trattati, dove si trovano, per quanto tempo, chi li riceve? | Informativa privacy |
| Trattamento per conto terzi ai sensi dell’art. 28 GDPR, sub-responsabili del trattamento, misure tecniche e organizzative | Accordo sul trattamento dei dati · in PDF |
| Condizioni d’uso, fatturazione, durata | Termini e condizioni · Condizioni in inglese |
| Fornitore, rappresentanti legali, contatti | Note legali |
| Segnalare una vulnerabilità | security.txt |
| Stato operativo del server MCP | health |
| Metadati OAuth | oauth-protected-resource · authorization-server |
Contatti
Domande su connessione, approvazioni e malfunzionamenti: service@telesherpa.com.
---
Aggiornato al 24 ottobre 2026.