ホーム/ガイド/開発者向け
開発者向け

MCP ROOTEにAIアシスタントを接続する方法

サーバーURL、HTTP設定、初回検索、結果の読み取り、エラーのトラブルシューティングを含む、MCP ROOTEへのアシスタント接続方法を解説します。

By ROOTE·読了目安:7分
MCP ROOTEにAIアシスタントを接続する方法
ROOTEに接続して、最初の検索を始めましょう。

要点を数秒でまとめて

対応クライアントにhttps://mcp.roote.ai/mcpをStreamable HTTPのリモートサーバーとして追加します。ツールを確認し、住所検索や近隣検索をテスト。ステータスや返される制限を確認しましょう。

MCP ROOTEにAIアシスタントを接続するには、対応するMCP Streamable HTTPアプリケーションにリモートサーバーhttps://mcp.roote.ai/mcpを追加してください。サーバーは住所、モビリティ、近隣サービスの読み取りツールを公開しています。

このチュートリアルはROOTEが公開した設定とサーバー接続確認手順に沿っています。メニュー名はクライアントによって異なることがありますが、URL、通信方法、ツールのスキーマが確認すべき要素です。サーバーのtools/listはドキュメントより先に変わる可能性があるため、実際に公開されている機能を利用してください。

クライアントの対応可否を確認する

利用するアプリケーションはStreamable HTTPでのリモートMCPサーバーを受け入れられる必要があります。ローカルサーバーのみ対応のstdio限定クライアントは、このURLを実行可能なコマンドとして利用できません。また、アカウントがカスタムサーバーの追加を許可しているか確認してください。

フォームがある場合は、ROOTEを名前に、サーバーURLをアドレスに入力してください。mcpServers形式のファイルを受け入れる場合、ROOTEのドキュメントには最低限の設定例が示されています。

{
  "mcpServers": {
    "roote": { "url": "https://mcp.roote.ai/mcp" }
  }
}

ROOTE公式接続設定

匿名アクセスか認証アクセスを選ぶ

ドキュメントはAuthorizationヘッダーなしの匿名アクセスを想定しています。これはFreeプランの投影とAPI制限に従います。認証アクセスの場合、クライアントの安全な方法でBearerヘッダーにトークンを渡してください。

Authorization: Bearer YOUR_API_TOKEN

YOUR_API_TOKENはクライアントの安全設定内で置き換える場所です。トークンを会話や公開URL、記事に貼り付けないでください。不正または無効化されたトークンは匿名アクセスに自動変換されません。

ツールが利用可能か確認する

接続後、クライアントでサーバーツール一覧を開きます。ROOTEのドキュメントはinitialize、tools/list、tools/callの順を説明。対応クライアントは通常これらを自動的に実行します。サーバーが示すバージョンと能力を確認してください。

サーバーはgeocode、place_search、reverse_geocode、nearby、mobility_nearby、transit_nearby、transit_disruptions、services_nearbyの各ツールを提供しています。これらのツールが見当たらない場合は接続、探索の問題かサービスの変更が疑われます。常にサーバーから通知されるリストを確認してください。JourneyとDeparturesはまだ提供されていません。

最初の再現可能な検索を行う

まず明確な住所で始めます:「ROOTEを使ってフランス、パリ、リヴォリ通り10番地を検索し、候補と座標を示して」。ツールの結果を確認し、モデル生成の応答だけでなく内容を検証してください。

{
  "name": "geocode",
  "arguments": {
    "q": "10 rue de Rivoli, Paris",
    "language": "fr",
    "country": "FR"
  }
}

このブロックは呼び出しの名前と引数を示したもので、完全なHTTPリクエストではありません。クライアントがMCP呼び出しをラップします。複数の候補が返る場合は、適切なものを選択して周辺検索を行いましょう。

次に、ボルドーの参照地点周辺の通信も試せます。下記座標はテスト用でパリの住所からのものではありません。

{
  "name": "transit_nearby",
  "arguments": {
    "lat": 44.8416106,
    "lon": -0.5810938,
    "radius": 600,
    "modes": ["bus", "tram"],
    "limit": 10
  }
}

結論を出す前に結果を読む

ステータス、返されたエンティティ、カバレッジ、警告、適用された制限を確認してください。一部応答でも有用な情報が含まれる場合があります。空の検索結果は実際に交通機関がないことを証明しません。

テストの期待される結果は構造化レスポンスか明示的なエラーであり、特定の停留所数ではありません。データ提供元やカバレッジは変化しえます。停留所の検索は次の出発時刻を返しません。

接続エラーの解決

症状確認ポイント
ツールが検出されない正確なURL、リモート通信、クライアント許可設定
引数エラー型、許容値、仕様書のフィールド確認
認証エラーBearerの有効性とヘッダー設定
制限超過有効な制限、リトライ遅延、呼び出し頻度
結果が空または部分的座標、フィルター、検索半径、カバレッジ、警告

APIエラーと空結果の区別

住所から完全なアシスタントを作る

MCPサーバーの役割を理解する

今後の予定:次発時刻と経路計算

ROOTEは今後、出発予定情報や経路計算機能でMCPを拡充する予定です。これらの機能は将来提供されるものであり、現時点でMCPサーバーが提供しているツールには含まれていません。利用可能になった際は、通過案内や旅程案内を行う前に、サーバーが公開するツール、引数、および実際に返却される情報を必ず確認してください。

開発者向けROOTE Mobility API

拠点周辺のモビリティ。
あなたのアプリに直接。

  • 検索
    位置周辺で
  • モビリティ
    データへアクセス
  • アプリに
    統合する

地図からデータへ。ROOTE APIで近隣のモビリティとサービスを検索。

よくある質問

トークンは必須ですか?

ドキュメントは匿名Freeアクセスを想定しています。利用制限や機能はサービスにより適用されます。

なぜアシスタントは停留所検索後に時刻情報を示すのですか?

transit_nearby検索は次の出発時刻を提供しません。実際に返されたデータをアシスタントに示し、この欠如を伝えさせてください。

アプリを作成せずにテストは可能ですか?

はい、リモートサーバー追加とツール実行可能な対応クライアントがあれば可能です。

周辺を見てみませんか?

ROOTEで街を探索し、移動のための情報を集めましょう。

ROOTEマップを探索 ↗