連接 Claude 或 ChatGPT

連接 Claude 或 ChatGPT，以讀取你已儲存的行程、路線和最愛地點。之後你可以要求助理準備包含每日地圖的行程文件。助理會使用自己的文件工具建立文件；WaypointGuru 則提供已儲存資料及品牌地圖圖片。

開始之前

你需要有 WaypointGuru 帳戶、一些已儲存資料，以及一個允許自訂遠端 MCP 連接的助理帳戶。如果你使用受管理的工作區，可能需要由管理員啟用或新增該連接。建立文件亦需要該助理具備合適的文件和圖片工具。

請使用以下 MCP 伺服器 URL：

https://waypoint.guru/mcp

選擇 OAuth 驗證，並使用 automatic registration（亦稱 dynamic client registration 或 DCR）。WaypointGuru 不需要 API 金鑰、個人存取權杖、client secret，或自訂授權標頭。請使用 automatic registration，而不要使用 Client ID Metadata Documents (CIMD)。

在網頁版設定 Claude

開啟 Customize > Connectors，然後選擇 + Add > Add custom connector。如屬受管理工作區，其擁有者可能需先在 Organization settings > Connectors 中新增網頁連接器。
將它命名為 WaypointGuru，並在 MCP 伺服器 URL 輸入 https://waypoint.guru/mcp。
繼續完成驗證設定。為 OAuth client 選擇 Sign in now 及 Register automatically。請使用 automatic registration，而不要使用 Claude 已發佈的身分。
完成新增連接器，如有提示請選擇 Connect。然後完成下方的 WaypointGuru 登入及權限步驟。
在對話中，開啟 + > Connectors 並啟用 WaypointGuru。

選單標籤及適用資格可能會變更。如果你的帳戶顯示不同版面，請參閱 Claude 的自訂連接器指示。

在網頁版設定 ChatGPT

ChatGPT 目前提供兩種設定版面說明。請使用你帳戶中可用的那一種。

如使用 Plugins 版面：

開啟 Plugins，選擇 + > Add custom MCP server，並將其命名為 WaypointGuru。
在 Connection 下輸入 https://waypoint.guru/mcp。選擇 OAuth、設定 DCR，並將靜態 client 憑證留空。
檢視警告後，選擇 Create as a plugin，並安裝產生的外掛。當系統提示時，完成 WaypointGuru 登入及同意授權。
在聊天中輸入 @，並在要求它讀取你的資料時選擇 WaypointGuru。

請參閱 OpenAI 的自訂 MCP 伺服器指示。

如使用 Apps / developer mode 版面，若獲准，請先啟用 Settings > Apps > Advanced settings > Developer mode。使用相同的 URL 和 OAuth/DCR 設定建立 app，掃描其工具，完成登入，然後完成建立。當你要求資料時，在聊天中選擇該 app；如有需要，後續要求時請再次選擇。工作區管理員可控制這些設定的存取權。請參閱 OpenAI 的 developer mode 指示。

選擇權限

在助理開啟的瀏覽器視窗中登入 WaypointGuru。批准前請檢查顯示的帳戶及助理。即使你已在手機應用程式中登入，仍可能需要再次登入。

同意畫面提供以下讀取類別：

類別	助理可讀取的內容
行程	已儲存的行程詳情及其中包含的每日路線，包括地圖所需的每日資料。這不會授予存取無關的獨立路線或你完整最愛收藏的權限。
路線	你的帳戶可用的已儲存路線，包括按名稱尋找、完整路線資料及地圖。
最愛	你的最愛地點，包括標籤搜尋、附近搜尋及完整詳情。

如要建立行程文件，請先只選用行程。只有在你想讓助理使用其他類別時，才加入它們。取消勾選不需要的類別，然後選擇 批准所選項目，或批准所有要求的類別。選擇取消可取消。

權限會涵蓋每個已批准的類別，包括之後儲存的項目，以及你的帳戶平常可存取的共享項目。它不會只限於單一行程或單一對話。現有的分享、私隱及訂閱限制仍然適用。提供連結亦不會繞過這些限制。

此存取權為唯讀：助理不能編輯、刪除或發佈 WaypointGuru 資料。不過，讀取權限仍會將資料傳送至助理供應商，而其本身的儲存及私隱設定亦會適用。只要連接仍然有效，存取權便會自動續期；一般使用情況下不應需要重複批准。若長時間未有使用，你可能需要重新連接。

要求建立行程文件

在對話中啟用 WaypointGuru 後，可嘗試這樣要求：

使用 WaypointGuru 找出我已儲存、名為「Coastal holiday」的行程。建立一份包含行程詳情及每天專屬章節的文件。為每個可用日子加入 WaypointGuru 地圖，並根據已儲存的途經點詳情撰寫停靠點圖例。請識別休息日及不可用的路線。將已儲存統計資料與重新計算的統計資料分開，並告訴我是否有任何資料或圖片無法取得。

你亦可以提供你的帳戶可存取的完整已儲存行程或已儲存路線連結。不支援包含已匯出路線的短連結及未儲存路線。

請要求助理在聲稱文件已完成前，先完成擷取所有頁面和 snapshot 區塊。行程和路線會從已儲存資料擷取成可維持最多 24 小時的 snapshot。之後的編輯不會更改該擷取內容，而未儲存的編輯亦不會包括在內。如要納入新近儲存的變更，或恢復已過期的擷取內容，請要求新的 snapshot 及新的地圖。

地圖預設為 WebP、完整尺寸、標準樣式及每日色彩。亦支援 JPEG 和 PNG，以及預覽尺寸、衛星樣式和夜間色彩。如文件工具無法嵌入 WebP，請要求使用 PNG。請保留 WaypointGuru 品牌標示及地圖供應商出處。助理會撰寫周邊文字及停靠點圖例。

WaypointGuru 會自動計算已擷取路線及行程日子的行車距離和時間，包括沒有已儲存估算的匯入路線。可用時會使用相符的 Google 估算；Valhalla 估算則會標示為備用結果。行車時間不包括停靠時間。已儲存估算會保持分開。路線及每日詳情亦包括簡化路線輪廓，以及在路由提供時的主要道路名稱。當助理需要檢視特定路段時，可以要求某一段或某個距離範圍的詳細幾何資料。

地圖通常會以 MCP 圖片及受保護資源參照的形式提供。如文件工具需要圖片 URL，請要求助理請求 delivery: "url"。如用於 Google Docs，亦請要求 format: "png" 或 "jpeg"；如未指定格式，預設仍為 WebP。

下載連結可使用 15 分鐘，或如較早則至已儲存 snapshot 過期為止。任何持有該連結的人，都可以在助理連接及你的存取權仍然有效時擷取該圖片。請將該連結視為私人資料。中斷助理連接或失去資源存取權，會阻止之後的下載，但無法移除已插入文件中的副本。如連結在插入前已過期，請要求助理提供新的連結。如仍然無法嵌入，請要求它回報缺少的地圖，而不要聲稱成功。

中斷連接或更改存取權

在 WaypointGuru 網頁應用程式中，開啟 WaypointGuru 設定 > 使用者帳戶 > 已連接的應用程式。
檢查助理名稱、已批准類別及最後使用資訊。
如只想中斷單一連接，請選擇 中斷連接；如要撤銷該帳戶的所有助理連接，請選擇 全部中斷連接。

在包含瀏覽器交接功能的手機版中，帳戶選單內的 已連接的應用程式 會在瀏覽器開啟這些設定。如系統要求，請在該處登入。

中斷連接後，將停止之後的資料讀取、地圖擷取及自動續期，包括使用尚未過期憑證的請求。這無法收回助理已下載的文字、圖片或文件。請另行透過供應商管理該等內容。

如要更改已批准的類別，請先中斷舊連接，然後以新的同意重新連接。你亦可以在 Claude 或 ChatGPT 中移除 connector、app 或 plugin。就單一對話將其關閉，並不會撤銷其 WaypointGuru 權限；請使用 WaypointGuru 的中斷連接控制來撤銷存取權。

疑難排解

問題	可嘗試的方法
沒有新增連接的選項	依照上方供應商指示，檢查帳戶是否符合資格，以及工作區管理員權限。
連接設定或註冊失敗	檢查伺服器 URL 是否為 `https://waypoint.guru/mcp`。選擇使用 automatic registration/DCR 的 OAuth。不要選擇 CIMD 或 Claude 已發佈的身分。
登入完成但未顯示同意畫面	返回待處理的連接視窗。如屬暫時性錯誤，請使用其重試控制。如請求已過期或被取消，請從助理重新開始新的連接。
顯示了錯誤帳戶	取消同意。請在該瀏覽器登入正確的 WaypointGuru 帳戶，然後重新開始。
缺少工具或權限遭拒	檢查「已連接的應用程式」中的類別，以及助理已啟用的工具。如有需要，使用所需類別重新連接。只授予「行程」本身，會刻意排除無關路線及完整最愛存取權。
某個行程、路線或共享連結不可用	先儲存變更，並檢查同一帳戶能否在 WaypointGuru 中開啟該項目。檢查分享及訂閱存取權。私人、已刪除及不可存取的項目都可能顯示為不可用。
結果似乎不完整	要求助理繼續處理分頁，並讀取所有 snapshot 區塊。即使搜尋頁面為空，仍可能有更多頁面。
snapshot 已過期	請求新的擷取。舊擷取內容會在 24 小時後過期，並且在存取權被撤銷後亦會失效。
地圖處於待處理狀態或暫時失敗	按照返回的重試延遲時間，並重用相同擷取內容。避免重複開始新的擷取。
地圖遇到配額或大小限制	等候所報告的配額重試時間。重新連接不會重設配額。對於大小限制結果，重複重試同一擷取內容無法解決；請回報問題或改用較小的已儲存路線。
地圖無法嵌入	對於需要 URL 的文件工具，請要求 `delivery: "url"`；對於 Google Docs，請選用 PNG 或 JPEG。如其 15 分鐘有效期已過，請要求新的連結。請將下載連結視為私人資料，如仍然無法嵌入，請回報缺少的地圖。
助理不斷要求登入	檢查「已連接的應用程式」後重新連接。中斷連接或長時間未使用後，續期可能會失敗。在連接仍然有效時反覆出現提示，應予以回報。

如需協助，請電郵至 support@waypoint.guru，並提供日期、助理、帳戶方案／工作區類型、設定步驟及可見錯誤。請勿提供密碼、權杖、授權連結及私人行程內容。