Koko connector

最後更新：2026 年 8 月 13 日

Koko 會以 app 的形式連接到 Claude 和 ChatGPT，讓你在對話中規劃的旅程可以儲存到你的 Koko 帳號、在地圖上開啟、分享給同行的人，之後也能從同一段對話繼續編輯。本頁說明設定方式、各工具的功能、助理能與不能存取的範圍，以及使用限制。

設定方式

你需要一個免費 Koko 帳號。請先到 kokotravel.ai 註冊，或在連線流程中建立帳號。

伺服器詳細資料

MCP 端點： https://kokotravel.ai/mcp
Transport: 可串流 HTTP（無狀態 JSON-RPC）
Authentication: OAuth 2.1 搭配 PKCE 與動態用戶端註冊。沒有需要貼上的用戶端 ID 或 API 金鑰。

在 Claude

開啟 設定 → 連接器，從目錄加入 Koko，或使用上方 endpoint 將它新增為自訂 connector。
點選連線。Koko 的登入頁會開啟。
使用 Google 登入，或以 email 與六位數驗證碼登入，或使用你的 Koko 使用者名稱與密碼登入。接著授予存取權。

在 ChatGPT

從 app 目錄加入 Koko，或使用上方 endpoint 將它新增為 connector。
點選連線，並用相同方式登入 Koko。

在 Claude Code 或其他 MCP 用戶端

claude mcp add --transport http koko https://kokotravel.ai/mcp

接著執行 /mcp，並在瀏覽器中完成登入。

connector 可以做什麼

共有六個工具，全部都只限於你登入的帳號範圍。讀取工具每次執行時不一定需要提示；寫入工具會變更你儲存的內容，而 update_koko 會完整取代一份清單，所以 Claude 會在執行前先詢問你。

send_to_koko 將清單或行程儲存到 Koko 寫入

依照對話中描述的地點，在你的帳號中建立新的清單或行程。單純的一組地點會變成清單；依日期分組且含時間的地點會變成行程。Koko 會為每個地點進行地理編碼，並在背景補上評分、營業時間與照片。會立即回傳檢視連結。

my_koko 我的清單 & 行程 唯讀

列出你的帳號中已有的內容：標題、類型、地點數量與 id。你帳號中的其他內容不會被公開。

get_koko 開啟清單或行程以編輯 唯讀

以可編輯的結構回傳一份清單或行程，讓助理可以修改並推送新版回去。

check_koko_status 檢查建立進度 唯讀

回報建立進度：已接收、定位中、補充資訊中、已就緒。儲存後立刻查看特別有用，因為地圖釘會先出現，照片會稍後補上。

update_koko 更新清單或行程 完整取代

用新版本取代既有清單或行程的內容。取代內容中未包含的任何項目都會被移除，因此這算是破壞性操作，會先提示你確認。id 與分享連結會維持不變，所以你已分享的人會看到更新後的內容。

refresh_details 重新整理評分 & 照片 寫入

為既有清單重新擷取評分、評論、營業時間與照片。這項操作會讓 Koko 依每個地點產生成本，所以會先估算，並只在你確認後才花費。

合作夥伴工具（認證創作者）

另外八個工具只對認證創作者開放，也就是在「探索」上發布內容的合作夥伴計畫成員。在其他帳號上，它們會回覆「不是認證創作者」，什麼都不會改。每一個工具都只作用在你自己的賣場範圍內。

creator_profile 我的創作者檔案 唯讀

讀取你的賣場檔案：名稱、標籤、一句話簡介、簡介、所在地、連結、社群帳號、預設價格，以及你是否公開可見。

update_creator_profile 更新我的創作者檔案 寫入

修改上述那些欄位。只要傳需要更動的部分；標籤會整組取代。帳號名稱永遠不能改，因為它就是你的公開 URL。

my_listings 我的上架內容 唯讀

你擁有的每一份清單和行程，包含是否已在「探索」上架、價格級距、分享連結、30 天瀏覽數，以及累計購買數與收入。

set_listing 在「探索」上架／下架 寫入

把你的某一份清單或行程放上公開的「探索」陳列架，價格從標準級距裡選（免費、$1、$2、$5、$10），或是把它下架。下架一定會一併清掉價格。

creator_stats 創作者數據 唯讀

7、30 或 90 天內的瀏覽數、不重複訪客、購買數和收入，可看整個賣場，也可看單一上架內容，提供總計與每日數列。

create_coupons 產生優惠碼 寫入

為付費的上架內容產生代碼：一組或五十組都行，可以是單次使用，也可以是一組代碼多人使用。優惠碼指定的是買家實際支付的較低價格級距（預設免費），而不是折扣百分比。

coupons 某項上架內容的優惠碼 唯讀

列出你某一項上架內容上的所有代碼，包含仍有效和已停用的，以及各被使用幾次、被誰使用。

disable_coupon 停用優惠碼 寫入

讓一組代碼無法再兌換。使用記錄會保留。

範例提示

「幫我做一份東京澀谷三間知名拉麵店的清單：Ichiran Shibuya、Nagi Golden Gai 和 Hakata Ippudo Shibuya。儲存到 Koko，名稱設為『澀谷拉麵』。」

使用 send_to_koko。你會收到一個檢視連結。

「幫我規劃東京淺草的一日行程：09:00 到淺草寺，12:00 到 Daikokuya Tempura 吃午餐，14:00 到東京晴空塔。儲存到 Koko，名稱設為『淺草一日遊』。」

使用 send_to_koko；因為各站點都有時間，所以會儲存成行程，而不是清單。

「我在 Koko 裡儲存了哪些內容？」

使用 my_koko。

「我的澀谷拉麵清單好了嗎？」

使用 check_koko_status。

「在我的澀谷拉麵清單裡，移除 Hakata Ippudo，改加 Afuri Ebisu。」

先使用 get_koko，再使用 update_koko。同一個連結，內容已更新。

助理可以與不能存取的內容

可以：建立、讀取及更新你登入的 Koko 帳號中的清單和行程。
不可以：查看其他使用者的內容、刪除你的帳號、變更你的登入資料，或將任何內容公開。發布到 Koko 公開的 Discover 欄位僅限 Koko 自有營運帳號；一般帳號提出這類要求時，內容會改為私下儲存，回覆也會告知你。
儲存內容的隱私：透過 connector 建立的清單和行程都是私密的。檢視連結只會在你已登入 Koko 網頁 App 時為你顯示。分享是你在 App 中另外主動執行的步驟。
Koko 會收到什麼：只有助理代表你發出的請求，例如要儲存的地點名稱清單。你的對話會留在助理的供應商那裡。完整詳情請見隱私權政策。

限制

工具呼叫有速率限制，大約是每位使用者每分鐘 30 次。超過後會收到帶有 Retry-After 標頭的 429。
儲存內容會在背景建立，負載較高時會排入佇列。大型行程大約需要一分鐘，照片和評分才會全部完成。
connector 是免費的，它做的任何事都不會花到你的錢。Koko 的核心功能也是免費；部分創作者會在 App 的「探索」陳列架上販售清單，透過 App Store 購買，但無論如何，付款資料都不會經過 Koko。一般帳號的使用限制寫在服務條款裡。
Koko 是由小團隊打造的早期預覽版。地點資訊來自第三方，可能已過期；出發前請確認重要資訊。

中斷連線

請從你所使用助理的 connector 設定中斷 Koko 連線。這會立即撤銷它的 access token，Koko 也會停止接受代表你發出的請求。你的清單和行程會留在你的 Koko 帳號中。若也想移除這些內容，請到 FAQ 的帳號刪除章節刪除你的帳號。

支援

每一則訊息都會由真人閱讀。請寄信到 [email protected]，附上你問助理的內容，以及助理回覆了什麼。也可參考 FAQ、隱私權政策和服務條款。