Collega Claude o ChatGPT

Collega Claude o ChatGPT per leggere i tuoi viaggi, percorsi e luoghi preferiti salvati. Potrai poi chiedere all'assistente di preparare un documento di viaggio con le mappe giornaliere. L'assistente crea il documento usando i propri strumenti documentali; WaypointGuru fornisce i dati salvati e le immagini delle mappe con il marchio.

Prima di iniziare

Ti serve un account WaypointGuru, alcuni dati salvati e un account assistente che consenta connessioni MCP remote personalizzate. In uno spazio di lavoro gestito, un amministratore potrebbe dover abilitare o aggiungere la connessione. La creazione del documento richiede anche strumenti appropriati per documenti e immagini in quell'assistente.

Usa questo URL del server MCP:

https://waypoint.guru/mcp

Scegli l'autenticazione OAuth con registrazione automatica (detta anche dynamic client registration o DCR). WaypointGuru non richiede una chiave API, un token di accesso personale, un client secret o un'intestazione di autorizzazione personalizzata. Usa la registrazione automatica anziche Client ID Metadata Documents (CIMD).

Configura Claude sul web

Apri Customize > Connectors, poi + Add > Add custom connector. Per uno spazio di lavoro gestito, il proprietario potrebbe prima dover aggiungere un connettore web in Organization settings > Connectors.
Chiamalo WaypointGuru e inserisci https://waypoint.guru/mcp come URL del server MCP.
Prosegui con la configurazione dell'autenticazione. Scegli Sign in now e Register automatically per il client OAuth. Usa la registrazione automatica invece dell'identita pubblicata di Claude.
Completa l'aggiunta del connettore e scegli Connect se richiesto. Completa l'accesso a WaypointGuru e i passaggi relativi alle autorizzazioni qui sotto.
In una conversazione, apri + > Connectors e abilita WaypointGuru.

Le etichette dei menu e l'idoneita possono cambiare. Consulta le istruzioni di Claude per i connettori personalizzati se nel tuo account compare un layout diverso.

Configura ChatGPT sul web

Al momento ChatGPT documenta due layout di configurazione. Usa quello disponibile nel tuo account.

Per il layout Plugins:

Apri Plugins, seleziona + > Add custom MCP server e assegnagli il nome WaypointGuru.
Inserisci https://waypoint.guru/mcp in Connection. Scegli OAuth, configura DCR e lascia vuote le credenziali client statiche.
Controlla l'avviso, scegli Create as a plugin e installa il plugin risultante. Completa l'accesso a WaypointGuru e il consenso quando richiesto.
In una chat, digita @ e seleziona WaypointGuru quando chiedi di leggere i tuoi dati.

Consulta le istruzioni di OpenAI per i server MCP personalizzati.

Per il layout Apps / developer mode, abilita Settings > Apps > Advanced settings > Developer mode, se consentito. Crea un'app usando lo stesso URL e le stesse impostazioni OAuth/DCR, analizza i suoi strumenti, completa l'accesso e termina la creazione. Seleziona l'app nella chat quando richiedi dati; selezionala di nuovo per le richieste successive, se necessario. Gli amministratori dello spazio di lavoro controllano l'accesso a queste impostazioni. Consulta le istruzioni di OpenAI per la modalita sviluppatore.

Scegli le autorizzazioni

Accedi a WaypointGuru nella finestra del browser aperta dall'assistente. Controlla l'account e l'assistente visualizzati prima di approvare. Potrebbe essere necessario accedere anche se hai gia effettuato l'accesso nell'app mobile.

La schermata di consenso offre queste categorie di lettura:

Categoria	Cosa puo leggere l'assistente
Viaggi	Dettagli dei viaggi salvati e dei percorsi giornalieri che contengono, inclusi i dati del giorno necessari per le mappe. Non concede l'accesso a percorsi indipendenti non correlati o all'intera raccolta dei tuoi preferiti.
Percorsi	Percorsi salvati disponibili per il tuo account, inclusi ricerca per nome, dati completi del percorso e mappe.
Preferiti	I tuoi luoghi preferiti, incluse ricerche per tag, ricerche per prossimita e dettagli completi.

Per un documento di viaggio, inizia solo con Viaggi. Aggiungi le altre categorie solo quando vuoi che l'assistente le usi. Deseleziona le categorie non desiderate e scegli Approva selezionati, oppure approva tutte le categorie richieste. Scegli Annulla per annullare.

L'autorizzazione copre ogni categoria approvata, inclusi gli elementi salvati in seguito e gli elementi condivisi a cui il tuo account puo normalmente accedere. Non e limitata a un solo viaggio o a una sola conversazione. Restano comunque valide le normali limitazioni di condivisione, privacy e abbonamento. Fornire un link non le aggira.

L'accesso e in sola lettura: l'assistente non puo modificare, eliminare o pubblicare dati WaypointGuru. Tuttavia, l'accesso in lettura invia i dati al provider dell'assistente, al quale si applicano le relative impostazioni di archiviazione e privacy. L'accesso si rinnova automaticamente finche la connessione rimane valida; nell'uso normale non dovrebbe essere necessaria un'approvazione ripetuta. Dopo un lungo periodo senza utilizzo, potrebbe essere necessario ricollegarsi.

Chiedi un documento di viaggio

Prova questo con WaypointGuru abilitato nella conversazione:

Usa WaypointGuru per trovare il mio viaggio salvato chiamato “Coastal holiday”. Crea un documento con i dettagli del viaggio e una sezione per ogni giorno. Includi una mappa WaypointGuru per ogni giorno disponibile e scrivi una legenda delle soste a partire dai dettagli dei waypoint salvati. Identifica i giorni di riposo e i percorsi non disponibili. Mantieni separate le statistiche salvate da quelle ricalcolate e dimmi se non e stato possibile recuperare alcuni dati o immagini.

Puoi anche fornire un link completo a un viaggio salvato o a un percorso salvato a cui il tuo account puo accedere. I link abbreviati che contengono un percorso esportato e i percorsi non salvati non sono supportati.

Chiedi all'assistente di completare il recupero di tutte le pagine e di tutti i blocchi dello snapshot prima di dichiarare completo un documento. Viaggi e percorsi vengono acquisiti dai dati salvati in uno snapshot che dura fino a 24 ore. Le modifiche successive non cambiano tale acquisizione, e le modifiche non salvate sono escluse. Per includere modifiche appena salvate o recuperare un'acquisizione scaduta, chiedi un nuovo snapshot e nuove mappe.

Per impostazione predefinita, le mappe usano WebP, dimensione completa, stile standard e colori giornalieri. Sono supportati anche JPEG e PNG, cosi come la dimensione anteprima, lo stile satellite e i colori notturni. Chiedi PNG se lo strumento documentale non puo incorporare WebP. Mantieni visibili il marchio WaypointGuru e l'attribuzione del fornitore delle mappe. L'assistente scrive il testo circostante e la legenda delle soste.

WaypointGuru calcola automaticamente distanze e durate di guida per i percorsi acquisiti e per i giorni del viaggio, inclusi i percorsi importati senza stime salvate. Quando disponibili, vengono usate stime corrispondenti di Google, mentre le stime Valhalla sono identificate come alternative di fallback. Le durate di guida escludono il tempo alle soste. Le stime salvate restano separate. I dettagli di percorso e giornata includono un contorno semplificato del percorso e i nomi delle strade principali quando il routing li fornisce. L'assistente puo richiedere la geometria dettagliata per una tratta o un intervallo di distanza quando ha bisogno di esaminare una sezione specifica.

Normalmente le mappe arrivano come immagini MCP e riferimenti a risorse protette. Per uno strumento documentale che richiede un URL dell'immagine, chiedi all'assistente di richiedere delivery: "url". Per Google Docs, richiedi anche format: "png" o "jpeg"; WebP resta il valore predefinito quando non viene specificato alcun formato.

I link di download funzionano per 15 minuti, o fino alla scadenza dello snapshot salvato se avviene prima. Chiunque possieda il link puo recuperare quell'immagine finche la connessione dell'assistente e il tuo accesso restano validi. Considera il link come privato. Disconnettere l'assistente o perdere l'accesso alla risorsa blocca ulteriori download, ma non puo rimuovere le copie gia inserite in un documento. Se un link scade prima dell'inserimento, chiedi all'assistente di generarne uno nuovo. Se l'incorporamento continua a non riuscire, chiedigli di segnalare le mappe mancanti invece di dichiarare il successo.

Disconnetti o modifica l'accesso

Nell'app web di WaypointGuru, apri Impostazioni di WaypointGuru > Account utente > App collegate.
Controlla il nome dell'assistente, le categorie approvate e le informazioni sull'ultimo utilizzo.
Scegli Disconnetti per una connessione, oppure Disconnetti tutte per revocare tutte le connessioni dell'assistente per quell'account.

Nelle versioni mobili che includono il passaggio al browser, App collegate nel menu dell'account apre queste impostazioni in un browser. Accedi li se richiesto.

La disconnessione interrompe le letture successive dei dati, il recupero delle mappe e il rinnovo automatico, comprese le richieste che usano credenziali non ancora scadute. Non puo richiamare testo, immagini o documenti gia scaricati dall'assistente. Gestisci tali contenuti separatamente con il provider.

Per modificare le categorie approvate, disconnetti la vecchia connessione e ricollegati con un nuovo consenso. Puoi anche rimuovere il connettore, l'app o il plugin in Claude o ChatGPT. Disattivarlo per una sola conversazione non revoca la sua autorizzazione WaypointGuru; usa i controlli di disconnessione di WaypointGuru per revocare l'accesso.

Risoluzione dei problemi

Problema	Cosa provare
Nessuna opzione per aggiungere una connessione	Controlla l'idoneita dell'account e le autorizzazioni dell'amministratore dello spazio di lavoro usando le istruzioni del provider riportate sopra.
La configurazione o la registrazione della connessione non riesce	Controlla che l'URL del server sia `https://waypoint.guru/mcp`. Seleziona OAuth con registrazione automatica/DCR. Non scegliere CIMD o l'identita pubblicata di Claude.
L'accesso termina ma il consenso non compare	Torna alla finestra della connessione in sospeso. Usa il relativo controllo di nuovo tentativo in caso di errore temporaneo. Se la richiesta e scaduta o e stata annullata, avvia una nuova connessione dall'assistente.
Compare l'account sbagliato	Annulla il consenso. Accedi nel browser all'account WaypointGuru desiderato e ricomincia.
Manca uno strumento o l'autorizzazione viene negata	Controlla le categorie in App collegate e gli strumenti abilitati dell'assistente. Ricollegati con la categoria richiesta, se necessario. Solo Viaggi esclude deliberatamente i percorsi non correlati e l'accesso completo ai preferiti.
Un viaggio, un percorso o un link condiviso non e disponibile	Salva prima le modifiche e verifica che lo stesso account possa aprire l'elemento in WaypointGuru. Controlla l'accesso di condivisione e abbonamento. Gli elementi privati, eliminati e inaccessibili possono tutti risultare non disponibili.
I risultati sembrano incompleti	Chiedi all'assistente di continuare l'impaginazione e di leggere tutti i blocchi dello snapshot. Una pagina di ricerca vuota puo comunque avere altre pagine.
Uno snapshot e scaduto	Richiedi una nuova acquisizione. Le vecchie acquisizioni scadono dopo 24 ore e diventano inutilizzabili anche quando l'accesso viene revocato.
Una mappa e in attesa o fallisce temporaneamente	Segui il ritardo di nuovo tentativo restituito e riutilizza la stessa acquisizione. Evita di avviare ripetutamente nuove acquisizioni.
Una mappa raggiunge un limite di quota o dimensione	Attendi il tempo di nuovo tentativo della quota indicato. Ricollegarsi non reimposta la quota. Un risultato dovuto al limite di dimensione non puo essere risolto ritentando ripetutamente la stessa acquisizione; segnalalo o usa un percorso salvato piu piccolo.
Una mappa non puo essere incorporata	Per gli strumenti documentali che richiedono un URL, richiedi `delivery: "url"`; per Google Docs, scegli PNG o JPEG. Richiedi un nuovo link se sono trascorsi i suoi 15 minuti di validita. Considera privati i link di download e segnala le mappe mancanti se l'incorporamento continua a non riuscire.
L'assistente continua a chiedere di accedere	Ricollegati dopo aver controllato App collegate. Il rinnovo puo fallire dopo la disconnessione o un'inattivita prolungata. Richieste ripetute durante una connessione attiva dovrebbero essere segnalate.

Per assistenza, scrivi a support@waypoint.guru indicando la data, l'assistente, il piano dell'account/tipo di spazio di lavoro, il passaggio della configurazione e l'errore visibile. Ometti password, token, link di autorizzazione e contenuti privati del viaggio.