TravelPanda Connect

和你的 AI 助手,一起规划中国之旅。

在对话中查看已保存的行程、规划新旅程或预览调整,再用同一个账号回到 TravelPanda App 继续使用。

让你的 AI 助手帮你连接。旅行计划保存在同一个账号中,出行时随时回到 TravelPanda App 查看。

同一个账号,连接由你掌控。

  1. 使用你的 TravelPanda 账号

    使用与 App 相同的方式登录,也可以直接在官网注册。无需先安装 App,就能开始规划旅程。

  2. 让 AI 帮你连接

    把下方的接入说明发给助手,按照可用方式完成设置,再到浏览器中的 TravelPanda 页面登录。

  3. 确认权限,再开始对话

    连接前核对应用名称、访问权限与累计竹子币额度,之后就可以告诉助手你想做什么。你可以随时管理或断开连接。

发一句话,就能开始

把下面这段话复制给你正在使用的 AI 助手,让它阅读官方说明,帮你选择可用的接入方式。

复制这段话,发给你的 AI 助手

请阅读 https://github.com/yuri-cong/travelpanda-connect 的官方说明,按照当前 AI 助手支持的方式,帮我安装或连接 TravelPanda,并引导我完成登录。连接完成后,请告诉我可以开始使用了。需要我操作时,请一步一步告诉我怎么做。

需要我手动设置吗?

有些助手可以代你安装,有些会引导你在设置中添加连接。把上面的文字发给助手,跟着它的提示操作即可。登录和权限确认由你在浏览器中完成。

想自己在 Codex 中设置?

安装 TravelPanda 插件

如果你的 Codex 版本支持插件,在终端运行下面两行即可安装,无需 GitHub 账号。随后按照助手的提示登录。

codex plugin marketplace add https://github.com/yuri-cong/travelpanda-connect
codex plugin add travelpanda@travelpanda-connect

高级选项:不安装插件,直接连接

1. 添加连接配置

打开用户目录中的 .codex/config.toml,保留原有设置,加入以下内容。如果已有 travelpanda 配置,请更新原条目;如果已通过 TravelPanda 插件连接,请直接使用该连接,无需重复添加。

[mcp_servers.travelpanda]
url = "https://api-sg.travelpanda.ai/agent/mcp"
oauth_resource = "https://api-sg.travelpanda.ai/agent/mcp"
scopes = ["account:read", "trips:read", "trips:write", "bamboo:spend"]

[mcp_servers.travelpanda.oauth]
client_id = "travelpanda-codex"
callback_url = "http://127.0.0.1:5555/callback"
callback_port = 5555

2. 登录并授权

在同一台电脑的终端运行以下命令,在随后打开的浏览器中登录 TravelPanda,选择访问权限和这条连接的累计竹子币额度。无需提供 API 密钥。

codex mcp login travelpanda

Codex 接入指南

连接后就可以开始使用了。告诉助手你想做什么,无论是规划第一次旅行,还是继续已有的行程。

清楚了解你授予的权限

读取账号与行程

助手可读取当前连接账号的余额、会员权益与已保存行程。只读权限不能生成或修改行程。

创建行程或生成修改预览

生成行程会使用竹子币,并受你为这条连接设置的累计额度限制。开始时会暂时预留一笔竹子币,完成后按实际用量结算,多余预留会释放;预留金额不是固定总价,也不是单次行程的消费上限。

由你决定是否应用修改

生成修改预览会消耗竹子币,即使最终不采纳也会计费。应用已有预览需要你确认,不会再次生成或收费;发生版本冲突时,须先核对更新后的行程。

从一个简单的需求开始

行程规划需要网络、相应权限与可用余额。此连接不提供酒店、交通或门票预订。出行前请核实开放时间、可用性及旅行信息。

了解信息如何共享,以及你的选择

本说明补充 TravelPanda 隐私政策中的 AI 助手接入事项。TravelPanda 接收助手发送的旅行需求与工具请求,并向该助手提供商返回授权范围内的账号信息、行程内容、任务结果与用量信息;助手提供商按其自身隐私政策处理这些信息。

TravelPanda 通过云服务及相关 AI、旅行数据提供商处理信息,用于生成、保存和恢复行程。请仅提供任务所需的旅行信息,不要发送密码、银行卡信息或身份证件。

为安全、限流、用量核对和故障恢复,TravelPanda 记录请求与任务编号、工具名称、结果、时间与用量,并使用哈希化账号和连接标识。这类工具审计记录不包含原始提示词、行程正文、邮箱或访问令牌;这不代表服务交付所存储的全部数据。

已保存行程会保留在账号内,直到被删除。临时任务数据和授权记录按服务的保留及到期机制处理;恢复、争议处理或法律义务所需的安全与交易记录可能继续保留。数据请求方式见隐私政策,具体保留问题可联系客服。

断开连接会阻止后续访问和令牌刷新,不会删除账号、清除助手已收到的信息,也不会自动取消或退还已受理的任务。你可在下方管理连接,并通过账号支持网站申请注销。

遇到问题时

权限或余额暂不可用

让助手解释返回的状态,并检查权限及连接累计额度。余额未知不等于余额为零,可在服务恢复后重试查询。

请求中断

让助手查询原任务状态。在结果或扣费尚未明确时,不要重新发起相同的生成任务。

助手无法连接

让它先查看官方说明中支持的接入方式。如果助手不能自行安装,可以按已支持平台的手动步骤操作;仍无法连接时,请向客服提供错误信息,不要发送密码或令牌。

[email protected]