連接 Claude 或 ChatGPT

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

開始之前

您需要有 WaypointGuru 帳戶、一些已儲存的資料，以及允許自訂遠端 MCP 連線的助理帳戶。在受管理的工作區中，可能需要由管理員啟用或新增此連線。建立文件也需要該助理具備適合的文件與影像工具。

請使用這個 MCP 伺服器 URL：

https://waypoint.guru/mcp

請選擇 OAuth 驗證，並使用 automatic registration（也稱為 dynamic client registration 或 DCR）。WaypointGuru 不需要 API 金鑰、個人存取權杖、用戶端密鑰或自訂授權標頭。請使用 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 用戶端，選擇 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，並將靜態用戶端憑證留空。
檢查警告內容，選擇 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。核准前，請確認顯示的帳戶與助理是否正確。即使您已在行動 app 中登入，仍可能需要再次登入。

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

類別	助理可讀取的內容
行程	已儲存的行程詳細資料，以及其中包含的每日路線，包括地圖所需的每日資料。這不會授予與該行程無關的獨立路線或您完整最愛集合的存取權。
路線	您帳戶可用的已儲存路線，包括依名稱探索、完整路線資料和地圖。
最愛	您的最愛地點，包括標籤搜尋、鄰近搜尋和完整詳細資料。

若要製作行程文件，請先只選行程。只有在您希望助理使用其他類別時，再加入它們。取消勾選不需要的類別，然後選擇 核准所選項目，或核准所有要求的類別。選擇取消可取消。

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

此存取為唯讀：助理無法編輯、刪除或發佈 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 網頁 app 中，開啟 WaypointGuru 設定 > 使用者帳戶 > 已連接的應用程式。
檢查助理名稱、已核准的類別與上次使用資訊。
針對單一連線選擇 中斷連線，或選擇 全部中斷連線 以撤銷該帳戶所有助理連線。

在包含瀏覽器交接功能的行動版本中，帳戶選單內的 已連接的應用程式 會在瀏覽器中開啟這些設定。如有提示，請在那裡登入。

中斷連線會停止後續資料讀取、地圖擷取與自動續期，包括使用尚未過期憑證的要求。它無法收回助理已下載的文字、影像或文件。請另外在供應商端管理這些內容。

若要變更已核准的類別，請中斷舊連線，然後以新的同意重新連線。您也可以在 Claude 或 ChatGPT 中移除連接器、app 或外掛。對單一對話將其關閉，並不會撤銷其 WaypointGuru 權限；若要撤銷存取權，請使用 WaypointGuru 的中斷連線控制項。

疑難排解

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

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