摘要
Tookan (Jungleworks) 交付和现场劳动力管理:创建、编辑、分配和跟踪取件、交付、预约和现场任务,更新其状态,查看代理及其位置和状态、团队和客户。一个 API 密钥。
引导式设置
2 分钟将 Tookan 连接到 Claude、ChatGPT 或 Copilot
开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 Tookan,再把你的 MCP URL 添加到你的 AI 助手。无需代码,也无需自行运行服务器。
无需信用卡 · 7 天试用 · 提供自托管方案
试试这样问
Tookan 的示例提示
点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。
Claude 是 AI,可能会出错。请核对回答。
💡 不需要安装?直接使用 cloud.anythingmcp.com。 登录,点击 Connectors → Tookan,粘贴你的凭据,生成一个 MCP API 密钥,完成。无需 Docker,无需
git clone,无需本地服务器。
Tookan
Tookan (Jungleworks) 交付和现场劳动力管理:创建、编辑、分配和跟踪取件、交付、预约和现场任务,更新其状态,查看代理及其位置和状态、团队和客户。一个 API 密钥。
设置
设置大约需要 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 会将状态设置为 9(已取消),使用 tookan_update_task_status。如果 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。
前提条件:TOOKAN_API_KEY
本地安装连接器
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
打开 http://localhost:3000/connectors/store,选择 Tookan 并粘贴前提条件下列出的环境变量。
可用工具
| 工具 | 功能 |
|---|---|
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(创建时的 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 分配给市中心团队最近的可用代理并通知他们。”
下一步
这份指南对你有帮助吗?