Conectar Claude ou ChatGPT

Conecte o Claude ou o ChatGPT para ler suas viagens, rotas e lugares favoritos salvos. Depois, você pode pedir ao assistente para preparar um documento de viagem com mapas diários. O assistente cria o documento usando as próprias ferramentas de documentos; o WaypointGuru fornece os dados salvos e as imagens de mapa com a marca.

Antes de começar

Você precisa de uma conta WaypointGuru, alguns dados salvos e uma conta de assistente que permita conexões MCP remotas personalizadas. Em um workspace gerenciado, um administrador pode precisar ativar ou adicionar a conexão. A criação de documentos também exige ferramentas adequadas de documentos e imagens nesse assistente.

Use esta URL do servidor MCP:

https://waypoint.guru/mcp

Escolha a autenticação OAuth com registro automático (também chamado de registro dinâmico de cliente ou DCR). O WaypointGuru não exige chave de API, token de acesso pessoal, segredo do cliente nem cabeçalho de autorização personalizado. Use registro automático em vez de Client ID Metadata Documents (CIMD).

Configurar o Claude na web

Abra Customize > Connectors e depois + Add > Add custom connector. Em um workspace gerenciado, o proprietário talvez precise primeiro adicionar um conector da web em Organization settings > Connectors.
Dê a ele o nome WaypointGuru e insira https://waypoint.guru/mcp como a URL do servidor MCP.
Continue pela configuração da autenticação. Escolha Sign in now e Register automatically para o cliente OAuth. Use o registro automático em vez da identidade publicada do Claude.
Conclua a adição do conector e escolha Connect se isso for solicitado. Complete as etapas de login e permissões do WaypointGuru abaixo.
Em uma conversa, abra + > Connectors e ative o WaypointGuru.

Os rótulos de menu e a elegibilidade podem mudar. Consulte as instruções de conector personalizado do Claude se sua conta mostrar um layout diferente.

Configurar o ChatGPT na web

No momento, o ChatGPT documenta dois layouts de configuração. Use o que estiver disponível na sua conta.

Para o layout Plugins:

Abra Plugins, selecione + > Add custom MCP server e dê a ele o nome WaypointGuru.
Insira https://waypoint.guru/mcp em Connection. Escolha OAuth, configure DCR e deixe vazias as credenciais estáticas do cliente.
Revise o aviso, escolha Create as a plugin e instale o plugin resultante. Conclua o login e o consentimento do WaypointGuru quando solicitado.
Em um chat, digite @ e selecione WaypointGuru ao pedir que ele leia seus dados.

Consulte as instruções de servidor MCP personalizado da OpenAI.

Para o layout Apps / developer mode, ative Settings > Apps > Advanced settings > Developer mode, se permitido. Crie um app usando a mesma URL e as mesmas configurações de OAuth/DCR, examine as ferramentas dele, conclua o login e finalize a criação. Selecione o app no chat ao solicitar dados; selecione-o novamente para solicitações de acompanhamento, se necessário. Os administradores do workspace controlam o acesso a essas configurações. Consulte as instruções do modo desenvolvedor da OpenAI.

Escolher permissões

Faça login no WaypointGuru na janela do navegador aberta pelo assistente. Verifique a conta e o assistente exibidos antes de aprovar. Talvez seja necessário fazer login mesmo que você já esteja conectado no app móvel.

A tela de consentimento oferece estas categorias de leitura:

Categoria	O que o assistente pode ler
Viagens	Detalhes das viagens salvas e das rotas diárias contidas nelas, incluindo os dados do dia necessários para os mapas. Isso não concede acesso a rotas avulsas não relacionadas nem à sua coleção completa de favoritos.
Rotas	Rotas salvas disponíveis para sua conta, incluindo descoberta por nome, dados completos da rota e mapas.
Favoritos	Seus lugares favoritos, incluindo pesquisas por tag, pesquisas por proximidade e detalhes completos.

Para um documento de viagem, comece apenas com Viagens. Adicione as outras categorias somente quando quiser que o assistente as use. Desmarque as categorias indesejadas e escolha Aprovar selecionados, ou aprove todas as categorias solicitadas. Escolha Cancelar para cancelar.

A permissão cobre cada categoria aprovada, incluindo itens salvos depois e itens compartilhados aos quais sua conta normalmente pode acessar. Ela não fica limitada a uma viagem nem a uma conversa. As restrições existentes de compartilhamento, privacidade e assinatura continuam valendo. Fornecer um link não as contorna.

O acesso é somente leitura: o assistente não pode editar, excluir nem publicar dados do WaypointGuru. Mesmo assim, o acesso de leitura envia dados ao provedor do assistente, cujas próprias configurações de armazenamento e privacidade se aplicam. O acesso é renovado automaticamente enquanto a conexão permanecer válida; o uso normal não deve exigir aprovações repetidas. Após um longo período sem uso, talvez seja necessário reconectar.

Pedir um documento de viagem

Experimente isto com o WaypointGuru ativado na sua conversa:

Use o WaypointGuru para encontrar minha viagem salva chamada “Coastal holiday”. Crie um documento com os detalhes da viagem e uma seção para cada dia. Inclua um mapa do WaypointGuru para cada dia disponível e escreva uma legenda de paradas a partir dos detalhes de waypoint salvos. Identifique dias de descanso e rotas indisponíveis. Mantenha as estatísticas salvas separadas das estatísticas recalculadas e me avise se algum dado ou imagem não puder ser recuperado.

Você também pode fornecer um link completo de viagem salva ou rota salva ao qual sua conta tenha acesso. Links encurtados contendo uma rota exportada e rotas não salvas não são compatíveis.

Peça ao assistente para terminar de recuperar todas as páginas e todos os blocos do snapshot antes de afirmar que um documento está completo. Viagens e rotas são capturadas dos dados salvos em um snapshot que dura até 24 horas. Edições posteriores não alteram essa captura, e edições não salvas ficam de fora. Para incluir alterações salvas recentemente ou recuperar uma captura expirada, peça um novo snapshot e novos mapas.

Por padrão, os mapas usam WebP, tamanho completo, estilo padrão e cores do dia. JPEG e PNG também são compatíveis, assim como tamanho de prévia, estilo satélite e cores noturnas. Peça PNG se a ferramenta de documentos não conseguir incorporar WebP. Mantenha visíveis a marca do WaypointGuru e a atribuição do provedor de mapas. O assistente escreve o texto ao redor e a legenda de paradas.

O WaypointGuru calcula automaticamente distâncias e durações de direção para rotas capturadas e dias da viagem, incluindo rotas importadas sem estimativas salvas. Estimativas correspondentes do Google são usadas quando disponíveis, com estimativas do Valhalla identificadas como alternativas. As durações de direção não incluem tempo nas paradas. As estimativas salvas permanecem separadas. Os detalhes da rota e do dia incluem um traçado simplificado da rota e nomes das principais estradas quando o roteamento os fornece. O assistente pode solicitar geometria detalhada para um trecho ou um intervalo de distância quando precisar inspecionar uma seção específica.

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

Os links de download funcionam por 15 minutos, ou até o snapshot salvo expirar, se isso acontecer antes. Qualquer pessoa com o link pode buscar essa imagem enquanto a conexão do assistente e o seu acesso permanecerem válidos. Trate o link como privado. Desconectar o assistente ou perder acesso ao recurso bloqueia novos downloads, mas não pode remover cópias já inseridas em um documento. Se um link expirar antes da inserção, peça ao assistente um novo. Se a incorporação ainda falhar, peça que ele informe os mapas ausentes em vez de afirmar sucesso.

Desconectar ou alterar o acesso

No app web do WaypointGuru, abra Configurações do WaypointGuru > Conta do usuário > Apps conectados.
Revise o nome do assistente, as categorias aprovadas e as informações de último uso.
Escolha Desconectar para uma conexão, ou Desconectar tudo para revogar todas as conexões de assistente dessa conta.

Nas versões móveis que incluem a transferência para o navegador, Apps conectados no menu da conta abre essas configurações em um navegador. Faça login lá se for solicitado.

Desconectar interrompe leituras de dados subsequentes, recuperação de mapas e renovação automática, incluindo solicitações que usam credenciais que ainda não expiraram. Isso não pode recuperar textos, imagens ou documentos já baixados pelo assistente. Gerencie esse conteúdo separadamente com o provedor.

Para alterar as categorias aprovadas, desconecte a conexão antiga e reconecte com um novo consentimento. Você também pode remover o conector, app ou plugin no Claude ou no ChatGPT. Desativá-lo para uma conversa não revoga a permissão dele no WaypointGuru; use os controles de desconexão do WaypointGuru para revogar o acesso.

Solução de problemas

Problema	O que tentar
Não há opção para adicionar uma conexão	Verifique a elegibilidade da conta e as permissões do administrador do workspace usando as instruções do provedor acima.
A configuração ou o registro da conexão falha	Verifique se a URL do servidor é `https://waypoint.guru/mcp`. Selecione OAuth com registro automático/DCR. Não escolha CIMD nem a identidade publicada do Claude.
O login termina, mas o consentimento não aparece	Volte para a janela da conexão pendente. Use o controle de nova tentativa dela em caso de erro temporário. Se a solicitação expirou ou foi cancelada, inicie uma nova conexão pelo assistente.
A conta errada aparece	Cancele o consentimento. Faça login na conta WaypointGuru correta nesse navegador e comece de novo.
Falta uma ferramenta ou a permissão é negada	Verifique as categorias em Apps conectados e as ferramentas ativadas do assistente. Reconecte com a categoria necessária, se preciso. Viagens por si só deliberadamente excluem rotas não relacionadas e acesso completo aos favoritos.
Uma viagem, rota ou link compartilhado não está disponível	Salve as alterações primeiro e verifique se a mesma conta consegue abrir o item no WaypointGuru. Verifique o acesso por compartilhamento e assinatura. Itens privados, excluídos e inacessíveis podem todos aparecer como indisponíveis.
Os resultados parecem incompletos	Peça ao assistente para continuar a paginação e ler todos os blocos do snapshot. Uma página de pesquisa vazia ainda pode ter mais páginas.
Um snapshot expirou	Solicite uma nova captura. Capturas antigas expiram após 24 horas e também se tornam inutilizáveis quando o acesso é revogado.
Um mapa fica pendente ou falha temporariamente	Siga o atraso de nova tentativa retornado e reutilize a mesma captura. Evite iniciar novas capturas repetidamente.
Um mapa atinge uma cota ou limite de tamanho	Aguarde o tempo de nova tentativa de cota informado. Reconectar não redefine a cota. Um resultado de limite de tamanho não pode ser corrigido repetindo a nova tentativa da mesma captura; informe isso ou use uma rota salva menor.
Um mapa não pode ser incorporado	Para ferramentas de documentos que exigem uma URL, solicite `delivery: "url"`; para o Google Docs, escolha PNG ou JPEG. Solicite um novo link se o prazo de 15 minutos já tiver passado. Trate links de download como privados e informe mapas ausentes se a incorporação ainda falhar.
O assistente continua pedindo para fazer login	Reconecte após verificar Apps conectados. A renovação pode falhar após desconexão ou inatividade prolongada. Solicitações repetidas durante uma conexão ativa devem ser relatadas.

Para obter ajuda, envie um e-mail para support@waypoint.guru com a data, o assistente, o plano da conta/tipo de workspace, a etapa da configuração e o erro visível. Não inclua senhas, tokens, links de autorização nem conteúdo privado de viagens.