Ligar o Claude ou o ChatGPT

Ligue o Claude ou o ChatGPT para ler as suas viagens, rotas e locais favoritos guardados. Depois, pode pedir ao assistente para preparar um documento de viagem com mapas por dia. O assistente cria o documento com as suas próprias ferramentas de documentos; o WaypointGuru fornece os dados guardados e imagens de mapas com a marca.

Antes de começar

Precisa de uma conta WaypointGuru, de alguns dados guardados e de uma conta de assistente que permita ligações MCP remotas personalizadas. Num espaço de trabalho gerido, um administrador poderá ter de ativar ou adicionar a ligação. A criação de documentos também requer ferramentas adequadas de documentos e imagens nesse assistente.

Utilize este URL do servidor MCP:

https://waypoint.guru/mcp

Escolha autenticação OAuth com registo automático (também chamado dynamic client registration ou DCR). O WaypointGuru não requer uma chave API, token de acesso pessoal, segredo do cliente nem cabeçalho de autorização personalizado. Utilize o registo automático em vez de Client ID Metadata Documents (CIMD).

Configurar o Claude na web

Abra Customize > Connectors e depois + Add > Add custom connector. Num espaço de trabalho gerido, o respetivo proprietário poderá primeiro ter de adicionar um conector web em Organization settings > Connectors.
Dê-lhe o nome WaypointGuru e introduza https://waypoint.guru/mcp como URL do servidor MCP.
Continue pela configuração da autenticação. Escolha Sign in now e Register automatically para o cliente OAuth. Utilize o registo automático em vez da identidade publicada do Claude.
Termine de adicionar o conector e escolha Connect se tal lhe for pedido. Conclua os passos de início de sessão e permissões do WaypointGuru indicados abaixo.
Numa conversa, abra + > Connectors e ative o WaypointGuru.

Os nomes dos menus e a elegibilidade podem mudar. Consulte as instruções de conectores personalizados do Claude se a sua conta apresentar uma disposição diferente.

Configurar o ChatGPT na web

Atualmente, o ChatGPT documenta duas disposições de configuração. Utilize a que estiver disponível na sua conta.

Para a disposição Plugins:

Abra Plugins, selecione + > Add custom MCP server e dê-lhe o nome WaypointGuru.
Introduza https://waypoint.guru/mcp em Connection. Escolha OAuth, configure DCR e deixe vazias as credenciais estáticas do cliente.
Reveja o aviso, escolha Create as a plugin e instale o plugin resultante. Conclua o início de sessão e o consentimento do WaypointGuru quando solicitado.
Num chat, escreva @ e selecione WaypointGuru ao pedir-lhe para ler os seus dados.

Consulte as instruções da OpenAI para servidores MCP personalizados.

Para a disposição Apps / developer mode, ative Settings > Apps > Advanced settings > Developer mode, se permitido. Crie uma app com o mesmo URL e as mesmas definições OAuth/DCR, examine as respetivas ferramentas, conclua o início de sessão e termine a criação. Selecione a app no seu chat quando pedir dados; selecione-a novamente para pedidos de seguimento, se necessário. Os administradores do espaço de trabalho controlam o acesso a estas definições. Consulte as instruções da OpenAI para o modo de programador.

Escolher permissões

Inicie sessão no WaypointGuru na janela do navegador aberta pelo assistente. Verifique a conta e o assistente apresentados antes de aprovar. Poderá ter de iniciar sessão mesmo que já tenha sessão iniciada na app móvel.

O ecrã de consentimento oferece estas categorias de leitura:

Categoria	O que o assistente pode ler
Viagens	Detalhes das viagens guardadas e das rotas diárias nelas contidas, incluindo os dados do dia necessários para os mapas. Não concede acesso a rotas autónomas não relacionadas nem à sua coleção completa de favoritos.
Rotas	Rotas guardadas disponíveis para a sua conta, incluindo procura por nome, dados completos da rota e mapas.
Favoritos	Os seus locais favoritos, incluindo pesquisas por etiqueta, pesquisas por proximidade e detalhes completos.

Para um documento de viagem, comece apenas com Viagens. Adicione as outras categorias apenas quando quiser que o assistente as utilize. Desmarque as categorias indesejadas e escolha Aprovar seleção, ou aprove todas as categorias pedidas. Escolha Cancelar para cancelar.

A permissão abrange cada categoria aprovada, incluindo itens guardados mais tarde e itens partilhados aos quais a sua conta normalmente pode aceder. Não está limitada a uma única viagem nem a uma única conversa. As restrições existentes de partilha, privacidade e subscrição continuam a aplicar-se. Fornecer uma ligação não as contorna.

O acesso é só de leitura: o assistente não pode editar, eliminar nem publicar dados do WaypointGuru. Ainda assim, o acesso de leitura envia dados para o fornecedor do assistente, cujas próprias definições de armazenamento e privacidade se aplicam. O acesso é renovado automaticamente enquanto a ligação permanecer válida; em utilização normal, não deverá ser necessária aprovação repetida. Após um longo período sem utilização, poderá ter de voltar a ligar.

Pedir um documento de viagem

Experimente isto com o WaypointGuru ativado na sua conversa:

Usa o WaypointGuru para encontrar a minha viagem guardada chamada “Coastal holiday”. Cria um documento com os detalhes da viagem e uma secção para cada dia. Inclui um mapa do WaypointGuru para cada dia disponível e escreve uma legenda de paragens a partir dos detalhes das paragens guardadas. Identifica dias de descanso e rotas indisponíveis. Mantém as estatísticas guardadas separadas das estatísticas recalculadas e diz-me se não foi possível obter algum dado ou imagem.

Também pode fornecer uma ligação completa para uma viagem guardada ou rota guardada à qual a sua conta tenha acesso. As ligações encurtadas que contêm uma rota exportada e as rotas não guardadas não são suportadas.

Peça ao assistente para terminar de obter todas as páginas e todos os blocos do instantâneo antes de afirmar que um documento está completo. As viagens e as rotas são capturadas a partir de dados guardados para um instantâneo que dura até 24 horas. As edições posteriores não alteram essa captura, e as edições não guardadas ficam excluídas. Para incluir alterações recentemente guardadas ou recuperar uma captura expirada, peça um instantâneo novo e mapas novos.

Por predefinição, os mapas são fornecidos em WebP, tamanho completo, estilo padrão e cores por dia. JPEG e PNG também são suportados, assim como tamanho de pré-visualização, estilo satélite e cores noturnas. Peça PNG se a ferramenta de documentos não conseguir incorporar WebP. Mantenha visíveis a marca WaypointGuru e a atribuição ao fornecedor do mapa. O assistente escreve o texto envolvente e a legenda de paragens.

O WaypointGuru calcula automaticamente distâncias e durações de condução para rotas capturadas e dias de viagem, incluindo rotas importadas sem estimativas guardadas. São utilizadas estimativas correspondentes do Google quando disponíveis, com estimativas do Valhalla identificadas como alternativa. As durações de condução excluem o tempo nas paragens. As estimativas guardadas mantêm-se separadas. Os detalhes de rotas e dias incluem um contorno simplificado da rota e os nomes das principais estradas quando o encaminhamento os fornece. O assistente pode pedir geometria detalhada para um troço ou um intervalo de distância quando precisar de inspecionar uma secção específica.

Os mapas chegam normalmente como imagens MCP e referências protegidas de recursos. Para uma ferramenta de documentos que precise de um URL de imagem, peça ao assistente para solicitar delivery: "url". Para o Google Docs, peça também format: "png" ou "jpeg"; WebP continua a ser o formato predefinido quando nenhum formato é especificado.

As ligações de transferência funcionam durante 15 minutos, ou até o instantâneo guardado expirar se isso acontecer antes. Qualquer pessoa que tenha a ligação pode obter essa imagem enquanto a ligação do assistente e o seu acesso permanecerem válidos. Trate a ligação como privada. Desligar o assistente ou perder acesso ao recurso bloqueia transferências posteriores, mas não pode remover cópias já inseridas num documento. Se uma ligação expirar antes da inserção, peça ao assistente uma nova. Se a incorporação continuar a falhar, peça-lhe para indicar os mapas em falta em vez de afirmar que teve sucesso.

Desligar ou alterar o acesso

Na app web do WaypointGuru, abra Definições do WaypointGuru > Conta de utilizador > Apps ligadas.
Reveja o nome do assistente, as categorias aprovadas e a informação da última utilização.
Escolha Desligar para uma ligação, ou Desligar tudo para revogar todas as ligações de assistentes dessa conta.

Nas versões móveis que incluem a transferência para o navegador, Apps ligadas no menu da conta abre estas definições num navegador. Inicie sessão aí se tal lhe for pedido.

Desligar interrompe leituras de dados subsequentes, obtenção de mapas e renovação automática, incluindo pedidos que utilizem credenciais que ainda não expiraram. Não pode recuperar texto, imagens ou documentos já transferidos pelo assistente. Faça a gestão desse conteúdo separadamente com o fornecedor.

Para alterar as categorias aprovadas, desligue a ligação antiga e volte a ligar com novo consentimento. Também pode remover o conector, a app ou o plugin no Claude ou no ChatGPT. Desativá-lo numa conversa não revoga a respetiva permissão no WaypointGuru; utilize os controlos de desligar do WaypointGuru para revogar o acesso.

Resolução de problemas

Problema	O que tentar
Não existe opção para adicionar uma ligação	Verifique a elegibilidade da conta e as permissões do administrador do espaço de trabalho nas instruções do fornecedor acima.
A configuração ou o registo da ligação falha	Verifique se o URL do servidor é `https://waypoint.guru/mcp`. Selecione OAuth com registo automático/DCR. Não escolha CIMD nem a identidade publicada do Claude.
O início de sessão termina, mas o consentimento não aparece	Regresse à janela da ligação pendente. Utilize o respetivo controlo de repetição para um erro temporário. Se o pedido tiver expirado ou sido cancelado, inicie uma nova ligação a partir do assistente.
Aparece a conta errada	Cancele o consentimento. Inicie sessão na conta WaypointGuru pretendida nesse navegador e recomece.
Falta uma ferramenta ou a permissão é recusada	Verifique as categorias em Apps ligadas e as ferramentas ativadas do assistente. Volte a ligar com a categoria necessária, se preciso. Só Viagens exclui deliberadamente rotas não relacionadas e o acesso completo a favoritos.
Uma viagem, rota ou ligação partilhada não está disponível	Guarde primeiro as alterações e confirme que a mesma conta consegue abrir o item no WaypointGuru. Verifique o acesso de partilha e subscrição. Itens privados, eliminados e inacessíveis podem todos parecer indisponíveis.
Os resultados parecem incompletos	Peça ao assistente para continuar a paginação e ler todos os blocos do instantâneo. Uma página de pesquisa vazia pode ainda ter mais páginas.
Um instantâneo expirou	Peça uma nova captura. As capturas antigas expiram ao fim de 24 horas e também deixam de poder ser utilizadas quando o acesso é revogado.
Um mapa está pendente ou falha temporariamente	Siga o atraso de repetição devolvido e reutilize a mesma captura. Evite iniciar repetidamente novas capturas.
Um mapa atinge um limite de quota ou de tamanho	Aguarde pelo tempo de repetição de quota indicado. Voltar a ligar não repõe a quota. Um resultado de limite de tamanho não pode ser resolvido repetindo a mesma captura; comunique-o ou utilize uma rota guardada mais pequena.
Um mapa não pode ser incorporado	Para ferramentas de documentos que exigem um URL, peça `delivery: "url"`; para o Google Docs, escolha PNG ou JPEG. Peça uma ligação nova se o prazo de 15 minutos já tiver passado. Trate as ligações de transferência como privadas e indique os mapas em falta se a incorporação continuar a falhar.
O assistente continua a pedir para iniciar sessão	Volte a ligar depois de verificar Apps ligadas. A renovação pode falhar após desligar ou após um longo período de inatividade. Pedidos repetidos durante uma ligação ativa devem ser comunicados.

Para obter ajuda, envie um e-mail para support@waypoint.guru com a data, o assistente, o plano da conta/tipo de espaço de trabalho, a etapa de configuração e o erro visível. Não inclua palavras-passe, tokens, ligações de autorização nem conteúdos privados de viagens.