摘要
Tookan (Jungleworks) 交付和现场劳动力管理:创建、编辑、分配和跟踪取件、交付、预约和现场任务,更新它们的状态,查看代理及其位置和状态、团队和客户。一个 API 密钥。
引导式设置
2 分钟将 Tookan 连接到 ChatGPT
开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 Tookan,再把你的 MCP URL 添加到 ChatGPT。无需代码,也无需自行运行服务器。
无需信用卡 · 7 天试用 · 提供自托管方案
ChatGPT 插件目录中的 AnythingMCP 插件可在 AnythingMCP Cloud 上回答有关企业数据库的问题(PostgreSQL、MySQL、SQL Server、Oracle、SAP HANA、SQLite、MongoDB,只读):打开插件页面 (在新标签页中打开)并点击 Install plugin。其他所有连接器都以自定义 MCP 服务器的方式添加到 ChatGPT,使用你的 AnythingMCP MCP URL。
试试这样问
Tookan 的示例提示
点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。
Claude 是 AI,可能会出错。请核对回答。
💡 没有安装?直接使用 cloud.anythingmcp.com。 登录,点击 Connectors → Tookan,粘贴你的凭据,生成一个 MCP API 密钥,完成。无需 Docker,无需
git clone,无需本地服务器。
Tookan + ChatGPT
Tookan (Jungleworks) 交付和现场劳动力管理:创建、编辑、分配和跟踪取件、交付、预约和现场任务,更新它们的状态,查看代理及其位置和状态、团队和客户。一个 API 密钥。
前提条件
查看连接器中的完整设置说明(在选择连接器时可在应用内商店中查看)。此连接器所需的环境变量为:
TOOKAN_API_KEY
第一步 — 获取凭据
设置大约需要 2 分钟。你需要一个在 app.tookanapp.com 的 Tookan 账户,并访问 Settings → API Keys。连接器需要一个 API 密钥。
- 登录 app.tookanapp.com,打开 Settings → API Keys。
- 在 V2 标签页中,将 API 密钥复制到
TOOKAN_API_KEY。如果列表为空,请先点击 Generate Key。 - 安装连接器。运行
tookan_list_teams检查连接:它会列出你的团队及其 ID。
云端和自托管的工作方式相同:密钥是相同的,并且没有重定向 URL 需要设置。
身份验证:每个 Tookan 调用都是带有 JSON 主体的 POST,连接器会将 api_key 添加到每个主体中。该密钥提供对账户的完全访问权限,因此请将其视为密码。
从哪里开始:使用 tookan_list_teams 获取团队 ID,使用 tookan_list_agents 获取代理及其状态,使用 tookan_list_tasks 获取一天的任务(需要任务类型、开始日期和结束日期),使用 tookan_get_task_details 获取单个任务。
读取内容:在最多 31 天的日期范围内读取一种类型的任务,使用 requested_page 分页;一次最多 100 个任务及其历史;按你自己的订单 ID 获取任务;属于一个订单的取件和交付;代理及其状态、个人资料、当前任务和最后已知位置;在某个点的半径内的代理(最多 100 公里);团队;按名称或电话获取客户。
写入内容:tookan_create_task、tookan_edit_task、tookan_update_task_status、tookan_assign_task、tookan_add_customer 和 tookan_edit_customer 已启用。使用 tookan_assign_task 时,notify 1 会提醒代理。
安装时关闭:tookan_delete_task(删除任务)和 tookan_delete_customer(删除客户)。这两者都无法恢复。要停止任务但保留它,AI 会使用 tookan_update_task_status 将状态设置为 9(已取消)。如果 AI 应该使用它们,请在连接器页面上启用它们;AI 会要求你确认每个更改。
任务种类:tookan_create_task 通过 layout_type、has_pickup 和 has_delivery 选择种类:取件 0, 1, 0;交付 0, 0, 1;取件和交付 0, 1, 1;预约 1, 0, 0;现场劳动力 2, 0, 0。在列表中,任务类型为 0 取件、1 交付、2 预约和 3 现场劳动力。
状态:任务状态为 0 已分配、1 已开始、2 成功、3 失败、4 进行中或已到达、6 未分配、7 已接受、8 已拒绝、9 已取消和 10 已删除。代理状态为 0 可用、1 离线和 2 忙碌。
时间:任务时间为当地时间,格式为 YYYY-MM-DD HH:MM:SS;列表过滤器采用 YYYY-MM-DD。timezone 是 UTC 偏移量(以分钟为单位),符号取反:印度 -330,中欧冬季 -60,夏季 -120,纽约冬季 300。答案使用 0000-00-00 00:00:00 表示空时间。
隐私:Tookan 在代理和客户的回答中包含的登录令牌和密码哈希在到达 AI 之前会被移除。
限制:Tookan 不发布速率限制,因此 AI 避免紧密循环,并使用日期和 ID 过滤器。
常见错误:Tookan 在主体中报告结果:status 100 表示缺少参数,101 表示无效的 API 密钥,201 表示拒绝的操作,原因在 message 中,404 表示执行错误。连接器将这些报告为失败的调用,并附上消息。
未涵盖:代理钱包交易、支付和费用估算(没有资金流动)、商户管理、地理围栏和 Webhook。
第二步 — 安装适配器
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
第三步 — 在 ChatGPT 中添加连接器
你的服务器 URL: 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器,复制它的 URL(
https://cloud.anythingmcp.com/mcp/…)。本指南中出现YOUR_SERVER_ID的地方都用它替换。
ChatGPT 在网页版的 Plugins 页面把 MCP 服务器添加为插件,仅付费套餐可用,不再需要开发者模式。在 Business 工作区中只有管理员和所有者可以添加;在 Enterprise 和 Edu 中,管理员可以授予 Create plugins with MCPs 权限。
- 前往 chatgpt.com/plugins,点击 Add,然后选择 Add custom MCP server。
- 填写名称,例如 Name:
Tookan。 - 在 Connection 下的 Server URL 中填入
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID,Authentication 保持为 OAuth。 - 选择 I understand and want to continue,然后点击 Create as a plugin。ChatGPT 提示时,登录 AnythingMCP 并允许访问。
- 在个人插件中安装这个新插件,然后在对话中输入 @ 并选择它。
可用工具
| 工具 | 功能 |
|---|---|
tookan_list_tasks | 列出在日期范围内(最多 31 天)的一种类型的任务:job_id、order_id、job_status(0 已分配、1 已开始、2 成功、3 失败、4 … |
tookan_get_task_details | 通过 ID 读取最多 100 个任务:状态、类型、代理、团队、客户、地址和坐标、计划、开始、到达和完成时间… |
tookan_get_tasks_by_order_id | 读取使用你自己的订单 ID 创建的任务(create 的 order_id 字段):与 tookan_get_task_details 相同的详细信息 |
tookan_get_related_tasks | 通过任务的 pickup_delivery_relationship 值读取属于一起的取件和交付任务 |
tookan_list_agents | 列出代理(司机、现场工作人员,在 API 中称为车队):fleet_id、姓名、用户名、电子邮件、电话、状态(0 可用、1 离线、2… |
tookan_get_agent_profile | 读取一个代理的个人资料和当前任务:姓名、联系方式、标签、交通工具、团队、状态、位置,以及分配给他们的工作 |
tookan_get_agent_location | 读取一个代理的最后已知经纬度 |
tookan_find_agents_nearby | 查找在某个点的半径内的代理(最多 100 公里),以及他们的距离和状态 |
tookan_list_teams | 列出团队:team_id、team_name、地址、坐标、标签、电池使用情况 |
tookan_list_customers | 列出客户:customer_id、姓名、电话、电子邮件、地址和坐标 |
tookan_find_customer_by_phone | 通过电话号码查找客户:customer_id、姓名、电子邮件、电话、地址和坐标 |
tookan_get_customer | 读取一个客户的个人资料:姓名、电话、电子邮件、地址、坐标和创建日期 |
tookan_create_task | 创建任务 |
tookan_edit_task | 更改现有任务:地址、时间、客户、描述、团队、代理、标签或自定义字段 |
tookan_update_task_status | 设置一个或多个任务的状态:0 已分配、1 已开始、2 成功、3 失败、4 进行中或已到达、6 未分配、7 已接受、8… |
tookan_assign_task | 将任务分配给团队的代理(或重新分配)。notify 1 会提醒代理 |
tookan_delete_task | 删除任务 |
tookan_add_customer | 将客户添加到 Tookan 客户列表 |
tookan_edit_customer | 通过 customer_id 更改客户的姓名、电话、电子邮件、地址或坐标 |
tookan_delete_customer | 删除客户 |
示例提示
- "今天还有哪些交付任务未分配?"
- "现在有哪些代理可用,哪些在离仓库 5 公里内?"
- "显示订单 10452 的取件和交付任务及其状态。"
- "为明天上午 10:00 创建一个送往 12 Market Street 的交付任务,客户电话为 +15551234567。"
- "将任务 98765 分配给市中心团队最近的可用代理并通知他们。"
常见问题
它可以删除任务吗? tookan_delete_task 存在,但在安装时已关闭。要停止任务并保留其历史,AI 会使用 tookan_update_task_status 将状态设置为 9(已取消)。
ChatGPT 免费套餐能用自定义 MCP 服务器吗? OpenAI 只为付费套餐提供自定义 MCP 服务器的说明,Free 套餐不在其列。
下一步
这份指南对你有帮助吗?