概要
AI で Motive のフリートを読み取ります。すべてのトラックとドライバーの現在地、Hours of Service の残り時間と違反、点検レポート、安全イベント、故障コード、IFTA の走行距離、燃料購入を扱います。読み取り専用で、会社の API キーを使います。
ガイド付きセットアップ
Motive を Microsoft Copilot に 2 分で接続
AnythingMCP Cloud の無料トライアルを始め、ガイド付きセットアップで Motive を接続して、MCP URL を Microsoft Copilot に追加します。コードもサーバーの運用も不要です。
クレジットカード不要 · 7日間の試用 · セルフホストの選択肢あり
こう聞いてみよう
Motive のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Motive をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も
git cloneもローカルサーバーも不要。
Motive + Microsoft Copilot
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 — Microsoft Copilot にコネクタを追加
サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（
https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドでYOUR_SERVER_IDと表示されている箇所に使ってください。
Microsoft Copilot は、Copilot Studio で作成したエージェントを通じて MCP サーバーを使います。AnythingMCP をツールとしてエージェントに追加し、そのエージェントを Microsoft 365 Copilot と Teams に公開します。Copilot Studio は Microsoft のクラウドから Streamable HTTP で接続し、AnythingMCP はこれに対応しています。
- Copilot Studio でエージェントを開き（または新規作成し）、Tools で Add a tool → New tool → Model Context Protocol を選びます。
- Server name（例:
AnythingMCP）、コネクタでできることを説明する Server description、Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDを入力します。Copilot Studio はこの説明をもとに、いつサーバーを呼び出すかを判断します。 - 認証で API key を選び、Type を Header、ヘッダー名を
X-API-Keyにして Create を選びます。 - Add tool で Create a new connection を選び、AnythingMCP の MCP API キー（MCP Servers → 対象のサーバー → API keys）を貼り付けて Add to agent を選びます。
- エージェントの Test ウィンドウで試します。
Motiveのツールが必要になる依頼をしてみましょう。 - Publish を選び、Channels → Microsoft 365 and Microsoft Teams で Make agent available in Microsoft Copilot を選択したまま Add channel を選びます。See agent in Teams で自分用にインストールされます。Microsoft 365 Copilot では @ を入力してエージェントを選びます。
ユーザーごとにサインインさせたい場合は、API キーの代わりに OAuth 2.0 → Dynamic discovery を選びます。各ユーザーは、エージェントが初めて呼び出すときに AnythingMCP にサインインします。
セルフホストの場合は、https://cloud.anythingmcp.com の代わりにインスタンスの公開 HTTPS アドレスを使ってください。Copilot Studio は Microsoft のクラウドから接続するため、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
どの Copilot が対象ですか? 職場で使う Microsoft 365 Copilot で、Copilot Studio のエージェントを通じて利用します。個人アカウント向けの Microsoft Copilot アプリでは、独自の MCP サーバーを追加できません。
何が必要ですか? エージェントを作成するために、Copilot Studio を利用できる職場アカウント（ライセンスまたは試用版）が必要です。Microsoft 365 Copilot や Teams でエージェントを使う人には、エージェントへのアクセス権が必要です。共有するか、管理者に組織向けに公開してもらってください。組織が Power Platform コネクタにデータ ポリシーを適用している場合は、MCP サーバーにも適用されます。
エージェントがツールを呼び出しません。 ヘッダー名が正確に X-API-Key であること、キーが URL と同じ MCP サーバーのものであることを確認し、Server description を具体的に書いてください。Copilot Studio はこの説明をもとにサーバーを呼び出すかどうかを判断します。変更のたびにエージェントを再公開し、開いているチャットでは "start over" と入力すると新しいバージョンになります。
次のステップ
このガイドは役に立ちましたか?