Road User Tools エージェント & API プラットフォーム

概要とクイックスタート

REST または MCP を通じて、Road User Tools の道路・車両・移動の計算をアプリ、自動化、AI エージェントに組み込めます。

REST または MCP を選択してください

どちらのインターフェイスも同じ計算エンジンと権限モデルを使用します。各リクエストを制御するアプリケーションやスクリプトには、API キーを使用した REST をご利用ください。AI アシスタントやエージェントが利用可能なツールを検出し、そのスキーマを理解し、適切な計算を自ら選択する場合は、MCP をご利用ください。

REST API

バージョン管理された直接リクエスト

アプリケーション、サービス、自動化、スクリプトから道路・車両・移動の計算を呼び出します。

https://roaduser.tools/api/v1

MCP サーバー

AIエージェント用ツール

MCP 互換エージェントが利用可能な機能を検出し、適切な計算を選択できるようにします。

https://roaduser.tools/mcp

認証

2 つのサインイン方法で同じ計算エンジンを利用できます。対話型の AI クライアントは MCP サーバーに接続し、ブラウザで OAuth によりアクセスを認可します。アプリケーション、サービス、スクリプト、手動の連携では、Bearer トークンとして送信する Road User Tools API キーを使用します。キーは無料で作成でき、いつでもローテーションまたは取り消しができます。

API キーを作成する

Authorizationヘッダーhttp

Authorization: Bearer rut_live_...

REST クイックスタート

API キーを使用して、バージョン管理された REST エンドポイントに JSON リクエストを送信します。応答は一貫したものを使用しますok, data, そしてerrorすべての計算ツールにわたる構造。

所要時間を計算するshell

curl -X POST https://roaduser.tools/api/v1/journey-time \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "distance": { "value": 250, "unit": "km" },
    "speed": { "value": 100, "unit": "kmh" }
  }'

MCP クイックスタート

対応する AI クライアントにサーバー URL を追加し、Road User Tools の認可ページが開いたらブラウザでアクセスを承認します。クライアントはサインインの設定と利用可能なツールを自動的に検出するため、コピーするキーやトークンはありません。

サーバー URLhttp

https://roaduser.tools/mcp

ステップバイステップのセットアップガイド

代替方法: API キーを使用した手動構成

ブラウザ認可のないクライアントや、プログラムによる連携では、代わりに API キーを送信できます:

MCP クライアント構成json

{
  "mcpServers": {
    "roaduser-tools": {
      "url": "https://roaduser.tools/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

REST 応答フォーマット

REST 応答が成功すると、次の計算結果が返されます。data. 検証とリクエストが失敗すると、人間が判読できるメッセージとともに、機械が判読できる安定したエラーコードが返されます。

JSON

{
  "ok": true,
  "data": {
    "totalHours": 2.5,
    "formatted": "2:30:00"
  }
}

{
  "ok": false,
  "error": {
    "code": "invalid_request",
    "message": "Invalid journey time input."
  }
}