Koko 连接器

最后更新：2026年8月13日

Koko 可以作为应用连接到 Claude 和 ChatGPT，让你在对话中规划的行程保存到你的 Koko 账号里，打开成地图，分享给同行的人，并在之后从同一段对话继续编辑。本页介绍如何设置、每个工具的作用、助手能访问和不能访问的内容，以及相关限制。

设置

你需要一个免费的 Koko 账号。请先在 kokotravel.ai 注册，也可以在连接流程中创建账号。

服务器详情

MCP 端点： https://kokotravel.ai/mcp
传输：可流式 HTTP（无状态 JSON-RPC）
身份验证：使用 PKCE 和动态客户端注册的 OAuth 2.1。无需粘贴客户端 ID 或 API key。

在 Claude 中

打开 Settings → Connectors，从目录添加 Koko，或使用上面的端点将其添加为自定义连接器。
点击 Connect。Koko 的登录页面会打开。
使用 Google 登录，或使用邮箱和六位验证码登录，或使用你的 Koko 用户名和密码登录。然后授予访问权限。

在 ChatGPT 中

从应用目录添加 Koko，或使用上面的端点将其添加为连接器。
点击 Connect，并以同样的方式登录 Koko。

在 Claude Code 或其他 MCP 客户端中

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

然后运行 /mcp，并在浏览器中完成登录。

连接器能做什么

共六个工具，全部仅限于你登录的账号范围。只读工具无需每次确认即可运行；写入工具会更改你保存的内容，而 update_koko 会完整替换一个列表，所以 Claude 会在运行前先询问你。

send_to_koko 将列表或计划保存到 Koko 写入

根据对话中描述的地点，在你的账号中创建新的列表或计划。一组不含时间安排的地点会成为一个列表；按天分组并带有时间的地点会成为一个计划。Koko 会为每个地点进行地理编码，然后在后台补全评分、营业时间和照片。视图链接会立即返回。

my_koko 我的列表 & 计划 只读

列出你账号中已有的内容：标题、类型、地点数量和 id。账号中的其他内容不会暴露。

get_koko 打开列表或计划进行编辑 只读

以可编辑结构返回一个列表或计划，方便助手修改后将新版本推送回去。

check_koko_status 检查构建进度 只读

报告构建进展到哪一步：已接收、定位中、补充信息中、已就绪。刚保存后很有用，因为图钉会先出现，照片随后补上。

update_koko 更新列表或计划 全量替换

用新版本替换现有列表或计划的内容。替换内容中遗漏的任何项目都会被移除，因此这会被视为破坏性操作，并会先提示你确认。id 和分享链接保持不变，所以你已分享给他人的内容会显示更新后的版本。

refresh_details 刷新评分 & 照片 写入

为现有列表重新拉取评分、评价、营业时间和照片。这个操作会让 Koko 按地点产生费用，因此会先估算成本，只有在你确认后才会执行。

合作伙伴工具（认证创作者）

对于在 Discover 上发布内容的合作伙伴计划认证创作者，还会多开放 8 个工具。在其他账号上调用时，它们只会回复“不是认证创作者”，不做任何改动。每个工具都只在你自己的店铺范围内生效。

creator_profile 查看我的创作者资料 只读

读取你的店铺资料：名称、标签、一句话简介、个人简介、所在地、链接、社交账号、默认价格，以及是否可被发现。

update_creator_profile 更新我的创作者资料 写入

修改上面这些字段。只发送需要改动的部分；标签会整组替换。用户名永远无法更改，因为它就是你的公开 URL。

my_listings 我的上架内容 只读

你名下的每一个列表和计划，附带是否已上架 Discover、价格档位、分享链接、近 30 天浏览量，以及累计购买数和收入。

set_listing 上架到 Discover / 从 Discover 下架 写入

把你的某个列表或计划按标准价格档位（免费、$1、$2、$5、$10）放到公开的 Discover 展架上，或者把它撤下来。撤下时价格一定会被清空。

creator_stats 创作者数据 只读

7 天、30 天或 90 天内的浏览量、独立访客、购买数和收入，可以看整个店铺，也可以看单个上架内容，返回总计和每日走势。

create_coupons 生成优惠码 写入

为付费上架内容生成优惠码：1 个或 50 个都行，可以是一次性使用，也可以是一个码供很多人使用。优惠码指定的是买家实际支付的更低档位（默认免费），而不是折扣百分比。

coupons 某个上架内容的优惠码 只读

返回你某个上架内容上的所有优惠码，有效的和已停用的都在内，附带使用次数和使用者。

disable_coupon 停用优惠码 写入

让某个码不能再兑换。使用记录会保留。

示例提示词

“帮我列一个东京涩谷三家知名拉面店的列表：Ichiran Shibuya、Nagi Golden Gai 和 Hakata Ippudo Shibuya。保存到 Koko，命名为‘Shibuya Ramen’。”

使用 send_to_koko。你会收到一个查看链接。

“规划东京浅草一日游：09:00 去浅草寺，12:00 在 Daikokuya Tempura 吃午餐，14:00 去东京晴空塔。保存到 Koko，命名为‘Asakusa Day’。”

使用 send_to_koko；由于各站点带有时间，因此保存为行程而不是列表。

“我在 Koko 里保存了哪些内容？”

使用 my_koko。

“我的 Shibuya Ramen 列表准备好了吗？”

使用 check_koko_status。

“在我的 Shibuya Ramen 列表里，删掉 Hakata Ippudo，改加 Afuri Ebisu。”

先使用 get_koko，再使用 update_koko。链接不变，内容会更新。

助手可以和不可以访问的内容

可以：创建、读取和更新你已登录的 Koko 账号中的列表和行程。
不可以：查看其他用户的内容、删除你的账号、修改你的登录信息，或将任何内容公开发布。发布到 Koko 的公共 Discover 展架仅限 Koko 自有运营账号；普通账号提出此请求时，内容会改为私密保存，回复中也会说明这一点。
已保存内容的隐私：通过连接器创建的列表和行程都是私密的。查看链接只有已登录 Koko 网页应用的你本人可以打开。分享是你在应用中另行主动执行的步骤。
Koko 会收到什么：只有助手代表你发起的请求，例如要保存的地点名称列表。你的对话会留在助手提供方。完整说明见隐私政策。

限制

工具调用会受到速率限制，约为每位用户每分钟 30 次。超过后会收到带有 Retry-After 标头的 429。
保存内容会在后台构建，并在负载较高时排队。较大的行程大约需要一分钟才能完成照片和评分的补全。
连接器是免费的，它做的任何事都不会花钱。Koko 的核心功能同样免费；部分创作者会在 App 的 Discover 展架里以 App Store 内购的形式出售自己的列表，但无论哪种情况，支付信息都不会经过 Koko。普通账号的使用上限见服务条款。
Koko 是由小团队构建的抢先体验预览版。地点详情来自第三方，可能已经过时；出行前请自行确认重要信息。

断开连接

请在你的助手自己的连接器设置中断开 Koko。这样会立即撤销其访问令牌，Koko 也会停止接受代表你发起的请求。你的列表和行程仍会保留在你的 Koko 账号中。若也要删除这些内容，请在 FAQ 的账号删除部分删除你的账号。

支持

每条消息都会由真人阅读。请发送邮件至 [email protected]，说明你向助手提出了什么请求，以及返回了什么结果。另请参阅 FAQ、隐私政策和条款。