连接 Claude 或 ChatGPT

连接 Claude 或 ChatGPT，以读取你已保存的行程、路线和收藏地点。之后，你可以让助手准备带有每日地图的行程文档。助手会使用它自己的文档工具创建文档；WaypointGuru 则提供已保存的数据和带品牌标识的地图图像。

开始之前

你需要一个 WaypointGuru 账户、一些已保存的数据，以及一个允许自定义远程 MCP 连接的助手账户。在受管理的工作区中，可能需要管理员启用或添加该连接。创建文档还要求该助手具备合适的文档和图像工具。

使用此 MCP 服务器 URL：

https://waypoint.guru/mcp

选择 OAuth 身份验证，并使用 automatic registration（也称为 dynamic client registration 或 DCR）。WaypointGuru 不需要 API 密钥、个人访问令牌、客户端密钥或自定义授权请求头。请使用自动注册，而不要使用 Client ID Metadata Documents (CIMD)。

在网页上设置 Claude

打开 Customize > Connectors，然后选择 + Add > Add custom connector。如果是受管理的工作区，其所有者可能需要先在 Organization settings > Connectors 中添加网页连接器。
将其命名为 WaypointGuru，并在 MCP 服务器 URL 中输入 https://waypoint.guru/mcp。
继续完成身份验证设置。为 OAuth 客户端选择 Sign in now 和 Register automatically。请使用自动注册，而不是使用 Claude 已发布的身份。
完成连接器添加；如果出现提示，请选择 Connect。然后完成下方的 WaypointGuru 登录和权限步骤。
在对话中，打开 + > Connectors 并启用 WaypointGuru。

菜单标签和可用资格可能会变化。如果你的账户显示的布局不同，请参阅 Claude 的自定义连接器说明。

在网页上设置 ChatGPT

ChatGPT 目前提供两种设置布局说明。请使用你账户中可用的那一种。

对于 Plugins 布局：

打开 Plugins，选择 + > Add custom MCP server，并将其命名为 WaypointGuru。
在 Connection 下输入 https://waypoint.guru/mcp。选择 OAuth，配置 DCR，并将静态客户端凭据留空。
查看警告，选择 Create as a plugin，并安装生成的插件。出现提示时，完成 WaypointGuru 登录和授权同意。
在聊天中，输入 @，然后在请求其读取你的数据时选择 WaypointGuru。

请参阅 OpenAI 的自定义 MCP 服务器说明。

对于 Apps / developer mode 布局，如果允许，请启用 Settings > Apps > Advanced settings > Developer mode。使用相同的 URL 和 OAuth/DCR 设置创建一个应用，扫描其工具，完成登录，并完成创建。在聊天中请求数据时选择该应用；如有需要，在后续请求时再次选择它。工作区管理员控制这些设置的访问权限。请参阅 OpenAI 的开发者模式说明。

选择权限

在助手打开的浏览器窗口中登录 WaypointGuru。批准前，请检查显示的账户和助手。即使你已经登录移动应用，仍可能需要再次登录。

授权同意页面提供以下读取类别：

类别	助手可以读取的内容
行程	已保存的行程详情及其中包含的每日路线，包括生成地图所需的每日数据。此项不会授予对无关独立路线或你完整收藏夹的访问权限。
路线	你的账户可用的已保存路线，包括按名称发现、完整路线数据和地图。
收藏夹	你的收藏地点，包括标签搜索、附近搜索和完整详情。

对于行程文档，建议先只选择行程。只有在你希望助手使用其他类别时，再添加它们。取消勾选不需要的类别，然后选择 批准所选项，或者批准所有请求的类别。选择取消可取消。

权限会覆盖每个已批准的类别，包括以后保存的项目以及你的账户平常可以访问的共享项目。它并不局限于某一个行程或某一次对话。现有的共享、隐私和订阅限制仍然适用。提供链接并不能绕过这些限制。

该访问权限为只读：助手无法编辑、删除或发布 WaypointGuru 数据。尽管如此，读取权限仍会将数据发送给助手提供方，后者自身的存储和隐私设置也会适用。只要连接保持有效，访问权限就会自动续期；正常使用时通常不需要反复批准。长时间未使用后，你可能需要重新连接。

请求生成行程文档

在对话中启用 WaypointGuru 后，可以尝试这样说：

使用 WaypointGuru 查找我已保存、名为“Coastal holiday”的行程。创建一份包含行程详情的文档，并为每一天添加一个章节。为每个可用日期包含一张 WaypointGuru 地图，并根据已保存的途经点详情编写停靠点图例。标明休息日和不可用路线。将已保存的统计数据与重新计算的统计数据分开，如果有任何数据或图像无法获取，请告诉我。

你也可以提供你的账户有权访问的完整已保存行程或已保存路线链接。不支持包含已导出路线的短链接，也不支持未保存的路线。

请让助手在声明文档完成之前，先完成所有页面和快照分块的获取。行程和路线会从已保存数据中捕获到一个最长保留 24 小时的快照中。之后的编辑不会改变该次捕获，未保存的编辑也不会包含在内。若要包含新保存的更改，或恢复已过期的捕获，请请求新的快照和新的地图。

地图默认使用 WebP、完整尺寸、标准样式和每日颜色。也支持 JPEG 和 PNG，以及预览尺寸、卫星样式和夜间颜色。如果文档工具无法嵌入 WebP，请要求使用 PNG。请保持 WaypointGuru 品牌标识和地图提供方署名可见。周边说明文字和停靠点图例由助手撰写。

WaypointGuru 会自动为已捕获的路线和行程日程计算驾驶距离和时长，包括那些没有已保存估算值的导入路线。若有可用数据，则优先使用匹配的 Google 估算；Valhalla 估算会被标识为后备方案。驾驶时长不包含停靠时间。已保存的估算值会保持独立。路线和每日详情还包括简化的路线轮廓以及路由提供时的主要道路名称。当助手需要检查特定路段时，它可以请求某一段行程或某一距离范围的详细几何数据。

地图通常会以 MCP 图像和受保护资源引用的形式提供。如果文档工具需要图像 URL，请让助手请求 delivery: "url"。对于 Google Docs，还请一并请求 format: "png" 或 "jpeg"；如果未指定格式，默认仍为 WebP。

下载链接可在 15 分钟内使用；如果保存的快照更早过期，则以快照过期时间为准。只要助手的连接和你的访问权限仍然有效，任何持有该链接的人都可以获取该图像。请将该链接视为私密信息。断开助手连接或失去资源访问权限会阻止后续下载，但无法移除已插入文档中的副本。如果链接在插入前就已过期，请让助手提供一个新的链接。如果嵌入仍然失败，请让它报告缺失的地图，而不要声称已经成功。

断开连接或更改访问权限

在 WaypointGuru 网页应用中，打开 WaypointGuru 设置 > 用户账户 > 已连接的应用。
查看助手名称、已批准的类别以及最后使用信息。
对单个连接选择 断开连接，或选择 全部断开连接 以撤销该账户的所有助手连接。

在包含浏览器切换功能的移动版本中，账户菜单中的 已连接的应用 会在浏览器中打开这些设置。如有提示，请在那里登录。

断开连接会停止后续的数据读取、地图获取和自动续期，包括那些使用尚未过期凭据发起的请求。它无法收回助手已经下载的文本、图像或文档。请在提供方处单独管理这些内容。

若要更改已批准的类别，请先断开旧连接，再通过新的授权同意重新连接。你也可以在 Claude 或 ChatGPT 中移除该连接器、应用或插件。仅在某一次对话中将其关闭，并不会撤销它在 WaypointGuru 中的权限；要撤销访问权限，请使用 WaypointGuru 的断开连接控制。

故障排除

问题	可尝试的做法
没有添加连接的选项	请根据上面的提供方说明，检查账户资格和工作区管理员权限。
连接设置或注册失败	检查服务器 URL 是否为 `https://waypoint.guru/mcp`。选择带自动注册/DCR 的 OAuth。不要选择 CIMD，也不要选择 Claude 已发布的身份。
登录完成但未出现授权同意页面	返回待处理的连接窗口。若是临时错误，请使用其中的重试控件。如果请求已过期或已取消，请从助手重新发起新连接。
显示了错误的账户	取消授权同意。在该浏览器中登录目标 WaypointGuru 账户后重新开始。
某个工具缺失或权限被拒绝	检查“已连接的应用”中的类别以及助手已启用的工具。如有需要，使用所需类别重新连接。仅选择“行程”时，按设计就不会包含无关路线和完整收藏夹访问权限。
某个行程、路线或共享链接不可用	先保存更改，并检查同一账户能否在 WaypointGuru 中打开该项目。检查共享和订阅访问权限。私有、已删除和无权访问的项目都可能显示为不可用。
结果看起来不完整	请让助手继续分页并读取所有快照分块。即使某个搜索结果页为空，仍可能还有后续页面。
快照已过期	请求重新捕获。旧快照会在 24 小时后过期，在访问权限被撤销后也会变得不可用。
地图处于等待中或暂时失败	按返回的重试延迟时间操作，并复用同一次捕获。避免反复发起新的捕获。
地图触及配额或大小限制	等待所报告的配额重试时间。重新连接不会重置配额。对于大小限制结果，反复重试同一次捕获无法解决；请报告该问题或改用更小的已保存路线。
地图无法嵌入	对于需要 URL 的文档工具，请请求 `delivery: "url"`；对于 Google Docs，请选择 PNG 或 JPEG。如果 15 分钟有效期已过，请请求新的链接。请将下载链接视为私密信息；如果嵌入仍失败，请报告缺失的地图。
助手不断要求登录	检查“已连接的应用”后重新连接。断开连接或长时间不活动后，续期可能失败。如果在连接仍有效时反复出现提示，则应报告该问题。

如需帮助，请发送电子邮件至 support@waypoint.guru，并附上日期、助手名称、账户套餐/工作区类型、设置步骤以及可见错误。请不要提供密码、令牌、授权链接和私密行程内容。