将 Motive MCP 连接到 Cursor：车队与 HOS

💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Motive、粘贴凭证、生成 MCP API key，即可完成。无 Docker、无 git clone、无本地服务器。

Motive + Cursor

让你的 AI 读取你的 Motive 车队数据：每辆卡车和每位司机的位置、Hours of Service 剩余时间和违规、检查报告、安全事件、故障码、IFTA 里程和加油记录。只读，使用公司 API key。

前提条件

完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:

MOTIVE_API_KEY

步骤 1 — 获取凭证

设置大约需要 3 分钟。你需要 Motive（原 KeepTruckin）的管理员角色，才能在 Motive 控制台中创建公司 API key。

1. 在 Motive 控制台中打开 Admin → Developers → API Access，创建一个公司 API key（company API key）。为它授予 read（读取）权限，以及 AI 需要查看的数据的权限范围：车辆、位置、用户、HOS、IFTA、燃油、检查、安全事件、故障码、资产和分组。也可以把 key 限定在部分分组；这样 AI 只能看到这些分组。
2. 完整的 key 只显示一次，请在该对话框中复制它，然后粘贴到 MOTIVE_API_KEY：只粘贴 key 本身，不带空格，也不带 X-Api-Key 之类的请求头名称。AnythingMCP 会以 X-Api-Key 请求头发送它。
3. 安装连接器，用 motive_list_vehicles 检查连接。

Cloud 和自托管的方式相同：API key 是唯一的设置。

key 会过期且无法编辑：key 会按创建时选择的期限过期，Motive 会提前一周提醒管理员。权限范围之后无法更改：需要更多数据时，请创建新的 key 并粘贴到 MOTIVE_API_KEY。

ID：车辆、用户和资产都有 Motive 数字 ID。调度员使用的车号（“Truck 12”）是车辆的 number 字段；motive_lookup_vehicle 可以把它转换为 ID。司机是角色为 driver 的用户。

日期、时区和单位：日期筛选使用 YYYY-MM-DD，大多数报表默认覆盖最近 7 天；updated_after 接受 ISO 8601 时间戳。大多数工具允许 AI 选择时间戳的时区（以 X-Time-Zone 发送，例如 America/New_York），以及公制或英制单位（以 X-Metric-Units 发送：公里和升，或英里和加仑）。如果时区和单位很重要，请在提示中写明。motive_list_available_time 中的 Hours of Service 时长以秒为单位。

分页：列表默认每页 25 条，最多 100 条（per_page），通过 page_no 翻页。每个响应都带有包含 per_page、page_no 和 total 的 pagination；只要还有未看到的记录，AI 就会请求下一页。

位置历史：motive_get_vehicle_location_history 读取一辆车最多 3 个月的轨迹；时间范围短一些，回答更易读。Motive 在这个接口上最多接受 10 个并发请求。

部分数据需要相应硬件或套餐：AI 行车记录仪的安全事件（使用手机、安全带、跟车过近等）、通过 Vehicle Gateway 获取的位置（motive_list_vehicle_gateway_locations；装有其他 ELD 的车辆通过 motive_list_vehicle_locations 获取），以及装有资产网关（asset gateway）的挂车位置。

不支持欧盟账号：连接器调用 https://api.gomotive.com；Motive 欧盟平台上的账号使用另一个主机。

常见错误：401 表示 Motive 拒绝了 key：没有完整复制、已过期或已撤销，或者连同请求头名称 X-Api-Key 一起粘贴了。403 表示 key 有效，但缺少该数据的权限范围：请创建带有该权限范围的新 key。404 表示没有该 ID 的记录：请使用数字 ID，而不是车号或司机姓名。Motive 对该 key 限流时，请等一分钟，少请求几页后再试。

可读取的内容：车辆，包括 VIN、品牌、型号、车牌、燃油类型、ELD 设备和司机；每辆车和每位司机的当前位置，以及一辆车在某段时间内的行驶路线；司机、车队用户和管理员；Hours of Service 剩余时间（谁今天还能开车、还能开多久）、每日日志和违规；按州或省统计的 IFTA 行程和里程；加油记录；检查报告（DVIR）及其缺陷；安全事件，包括辅导状态和媒体链接；发动机故障码；驾驶时段，包括个人用车（personal conveyance）、场内移车（yard move）和未识别驾驶；挂车和其他资产及其最后位置；以及车队划分的分组。

只读：所有工具都只读取，安装时没有默认关闭的工具。Motive 中的任何内容都不会被更改：不包含创建或编辑车辆、用户、分组、地理围栏、加油记录或检查报告，也不包含给司机发消息、派车和发动机防盗锁止指令。

步骤 2 — 安装 adapter

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

步骤 3 — 在 Cursor 中添加连接器

你的服务器 URL： 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器，复制它的 URL（https://cloud.anythingmcp.com/mcp/…）。本指南中出现 YOUR_SERVER_ID 的地方都用它替换。

Cursor 从 ~/.cursor/mcp.json 读取 MCP 服务器。添加以下条目：

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. 在 AnythingMCP 的 MCP Servers → 你的服务器 → API keys 中创建 MCP API 密钥，并用它替换 YOUR_MCP_API_KEY。
2. 保存文件并重启 Cursor。
3. 打开 Cursor → Settings → MCP，确认 anythingmcp 已列出并处于已连接状态。
4. 开始对话 — 智能体现在可以调用 Motive 的工具。

可用工具

示例提示

• “Truck 12 现在在哪里？谁在开？”
• “哪些司机今天还能开车？还能开多久？”
• “上周哪些司机有急刹车或使用手机的事件？”
• “哪些车辆有带缺陷的检查报告或未关闭的故障码？”
• “为 IFTA 申报，上个季度每辆卡车在各州分别行驶了多少英里？”

FAQ

Cursor 免费套餐支持自定义 MCP 服务器吗？ 支持 — Hobby、Pro 和 Business 套餐均可使用 MCP。

下一步

• 连接器主页
• 连接到 Claude