概要
AI で Motive のフリートを読み取ります。すべてのトラックとドライバーの現在地、Hours of Service の残り時間と違反、点検レポート、安全イベント、故障コード、IFTA の走行距離、燃料購入を扱います。読み取り専用で、会社の API キーを使います。
ガイド付きセットアップ
Motive を Meta Muse に 2 分で接続
AnythingMCP Cloud の無料トライアルを始め、ガイド付きセットアップで Motive を接続して、MCP URL を Meta Muse に追加します。コードもサーバーの運用も不要です。
クレジットカード不要 · 7日間の試用 · セルフホストの選択肢あり
こう聞いてみよう
Motive のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Motive をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も
git cloneもローカルサーバーも不要。
Motive + Meta Muse
AI で Motive のフリートを読み取ります。すべてのトラックとドライバーの現在地、Hours of Service の残り時間と違反、点検レポート、安全イベント、故障コード、IFTA の走行距離、燃料購入を扱います。読み取り専用で、会社の API キーを使います。
前提条件
完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:
MOTIVE_API_KEY
ステップ 1 — 認証情報を取得
セットアップは約 3 分です。Motive のダッシュボードで会社の API キーを作成するため、Motive（旧 KeepTruckin）の管理者ロールが必要です。
- Motive のダッシュボードで Admin → Developers → API Access を開き、会社の API キー（company API key）を作成します。read（読み取り）アクセスと、AI に見せたいデータのスコープを付与します: 車両、位置情報、ユーザー、HOS、IFTA、燃料、点検、安全イベント、故障コード、アセット、グループ。キーを一部のグループに限定することもでき、その場合 AI はそのグループだけを参照します。
- キー全体は一度しか表示されないため、その画面でキーをコピーし、
MOTIVE_API_KEYに貼り付けます。貼り付けるのはキーだけで、スペースやX-Api-Keyなどのヘッダー名は含めません。AnythingMCP はキーをX-Api-Keyヘッダーとして送信します。 - コネクターをインストールし、
motive_list_vehiclesで接続を確認してください。
Cloud とセルフホストは同じ手順です: 設定は API キーだけです。
キーには有効期限があり、編集できません: キーは作成時に選んだスケジュールで期限切れになり、Motive はその 1 週間前に管理者へ通知します。スコープは後から変更できません。より多くのデータが必要な場合は新しいキーを作成し、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 の時間は秒単位です。
ページ送り: 一覧は既定で 1 ページ 25 件、最大 100 件（per_page）で、page_no でページ送りします。各レスポンスには per_page、page_no、total を含む pagination があり、まだ見ていないレコードが残っている間、AI は次のページを取得します。
位置履歴: motive_get_vehicle_location_history は 1 台の車両を最大 3 か月分読み取ります。読みやすい回答にするため、期間は短くしてください。このエンドポイントで Motive が受け付ける同時リクエストは最大 10 件です。
ハードウェアやプランが必要なデータ: AI ダッシュカムの安全イベント（携帯電話の使用、シートベルト、車間距離不足など）、Vehicle Gateway による位置情報（motive_list_vehicle_gateway_locations。他の ELD を搭載した車両は motive_list_vehicle_locations で取得します）、アセットゲートウェイを付けたトレーラーの位置情報です。
EU のアカウントは対象外です: コネクターは https://api.gomotive.com を呼び出します。Motive の EU プラットフォームのアカウントは別のホストを使います。
よくあるエラー: 401 は Motive がキーを拒否したことを示します。キーが完全にコピーされていない、期限切れか取り消し済み、または X-Api-Key というヘッダー名ごと貼り付けられている場合です。403 はキーは有効でも、そのデータのスコープがないことを示します。そのスコープを付けた新しいキーを作成してください。404 はその ID のレコードがないことを示します。車両番号やドライバー名ではなく、数値 ID を使ってください。Motive がキーのリクエストを制限している場合は、1 分待ち、取得するページを減らしてから再試行してください。
読み取れるデータ: VIN、メーカー、モデル、ナンバープレート、燃料の種類、ELD デバイス、ドライバーを含む車両、すべての車両とドライバーの現在地と、期間内の車両の走行ルート、ドライバー、フリートユーザー、管理者、Hours of Service の残り時間（今日まだ運転できる人とその時間）、日次ログと違反、米国の州やカナダの州ごとの IFTA トリップと走行距離、燃料購入、欠陥を含む点検レポート（DVIR）、コーチングの状況とメディアのリンクを含む安全イベント、エンジンの故障コード、私用運転（personal conveyance）、構内移動（yard move）、未特定の運転を含む運転区間、トレーラーなどのアセットとその最終位置、そしてフリートを分けるグループです。
読み取り専用: すべてのツールは読み取りだけを行い、インストール時にオフになっているツールはありません。Motive の内容は何も変更されません。車両、ユーザー、グループ、ジオフェンス、燃料購入、点検レポートの作成や編集、ドライバーへのメッセージ、配車指示、エンジンイモビライザーのコマンドは含まれていません。
ステップ 2 — アダプターをインストール
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 — Muse にコネクタを追加
サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（
https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドでYOUR_SERVER_IDと表示されている箇所に使ってください。
Muse はリモート MCP サーバーをカスタムコネクタとして追加し、OAuth でサインインします。
- Muse で Settings → Connectors を開き、Add custom connector を選びます。
- MCP サーバーの URL
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDを貼り付けます。 - Muse が AnythingMCP のサインインページを開きます。サインインしてアクセスを承認します。
- チャットで、
Motiveのツールが必要になる依頼を Muse にしてみましょう。
チャットから設定することもできます（Web、iOS・Android アプリ、WhatsApp）。Muse に次のメッセージを送ってください:
Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth
セルフホストの場合は、https://cloud.anythingmcp.com の代わりにインスタンスの公開 HTTPS アドレスを使ってください。Muse は Meta のクラウドから接続するため、localhost は使えません。
利用可能なツール
| Tool | What it does |
|---|---|
motive_list_vehicles | List the company vehicles in Motive: id, number (the fleet unit name), status, VIN, make, model, year, license plate, fuel type, IFTA flag… |
motive_get_vehicle | Read one vehicle by its Motive id: number, status, VIN, make, model, year, plate, fuel type, groups, ELD device and assigned driver |
motive_lookup_vehicle | Find a vehicle by its fleet unit number (the "number" shown in the Motive dashboard, for example "Truck 12") and return its full record… |
motive_list_vehicle_locations | Current location of every vehicle (v2): for each vehicle its id, number, VIN and current_location with latitude, longitude, a place… |
motive_list_vehicle_gateway_locations | Current location of vehicles fitted with the Motive Vehicle Gateway (v3), with richer telemetry than v2 and, on request, the auxiliary… |
motive_get_vehicle_location_history | Location breadcrumbs of one vehicle between two dates (v2): each point with latitude, longitude, description, located_at, speed, bearing… |
motive_list_driver_locations | Drivers with their last known location and the vehicle they are in: user id, name, current_location (lat, lon, description, located_at) and… |
motive_list_users | List the users of the Motive account (drivers, fleet users and admins): id, first and last name, email, phone, role, status, duty status… |
motive_get_user | Read one user (driver or fleet user) by Motive id: name, contact details, role, status, duty status, licence, cycle and exceptions settings |
motive_list_available_time | Hours of Service clocks per driver: current duty status and the time still available on the drive, shift, cycle and break clocks (in… |
motive_list_hos_logs | Daily Hours of Service logs (records of duty status) of the drivers: per driver and day the duty status events with start time and… |
motive_list_hos_violations | Hours of Service violations of the drivers, for example exceeding the 11-hour drive or 14-hour shift limit or a missed 30-minute break… |
motive_list_ifta_trips | IFTA trip report: distance driven per vehicle and jurisdiction (state or province) with dates, start and end odometer and location |
motive_get_ifta_mileage_summary | IFTA mileage summary: total distance per vehicle and jurisdiction over a period (default the last 7 days), the figure that goes on a… |
motive_list_fuel_purchases | Fuel purchases recorded in Motive (entered by drivers, imported or from a fuel card integration): date, vehicle, driver, jurisdiction, fuel… |
motive_list_inspection_reports | Driver vehicle inspection reports (DVIRs, v2) for vehicles and trailers: date, driver, vehicle or asset, inspection type, location… |
motive_list_driver_performance_events | Safety events detected by Motive (v2): harsh acceleration, braking and cornering, crashes, and with AI dashcams events such as cell phone… |
motive_list_fault_codes | Engine fault codes (diagnostic trouble codes) reported by the vehicles: code, label, description, source, status (open or closed), type… |
motive_list_driving_periods | Driving periods of the vehicles: each stretch of driving with start and end time, duration, distance, origin and destination, vehicle and… |
motive_list_assets | List the non-powered assets (trailers, containers, equipment): id, name, type, status, make, model, year, VIN, plate, groups and the asset… |
motive_list_asset_locations | Last known location of the assets that carry a Motive asset gateway: asset id and name, latitude, longitude, place description, located_at… |
motive_list_groups | List the groups of the account (the way the fleet is split into terminals, regions or teams): id, name, parent group, status and member… |
プロンプトの例
- 「Truck 12 は今どこにいて、誰が運転していますか。」
- 「今日まだ運転できるドライバーは誰で、あと何時間運転できますか。」
- 「先週、急ブレーキや携帯電話使用のイベントがあったドライバーは誰ですか。」
- 「欠陥のある点検レポートや未解決の故障コードがある車両はどれですか。」
- 「IFTA 申告用に、前四半期に各トラックが州ごとに走行したマイル数を出してください。」
FAQ
Muse はどこで使えますか? Meta は現在、Muse を米国とカナダで提供しています。Web、iOS・Android アプリ、WhatsApp で利用できます。
Meta はこのコネクタを審査しますか? いいえ。Meta はカスタムコネクタを審査しません。Muse に見えるのは、AnythingMCP でこの MCP サーバーに対して有効にしたツールだけです。コネクタはいつでも Settings → Connectors で切断できます。
次のステップ
このガイドは役に立ちましたか?