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" }
}
}
匿名アクセスか認証アクセスを選ぶ
ドキュメントは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の有効性とヘッダー設定 |
| 制限超過 | 有効な制限、リトライ遅延、呼び出し頻度 |
| 結果が空または部分的 | 座標、フィルター、検索半径、カバレッジ、警告 |
今後の予定:次発時刻と経路計算
ROOTEは今後、出発予定情報や経路計算機能でMCPを拡充する予定です。これらの機能は将来提供されるものであり、現時点でMCPサーバーが提供しているツールには含まれていません。利用可能になった際は、通過案内や旅程案内を行う前に、サーバーが公開するツール、引数、および実際に返却される情報を必ず確認してください。
よくある質問
トークンは必須ですか?
ドキュメントは匿名Freeアクセスを想定しています。利用制限や機能はサービスにより適用されます。
なぜアシスタントは停留所検索後に時刻情報を示すのですか?
transit_nearby検索は次の出発時刻を提供しません。実際に返されたデータをアシスタントに示し、この欠如を伝えさせてください。
アプリを作成せずにテストは可能ですか?
はい、リモートサーバー追加とツール実行可能な対応クライアントがあれば可能です。