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

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

Source: https://www.roote.ai/ja/guides/mcp-roote-ia%E3%82%A2%E3%82%B7%E3%82%B9%E3%82%BF%E3%83%B3%E3%83%88%E6%8E%A5%E7%B6%9A%E6%96%B9%E6%B3%95/
Language: ja
Author: ROOTE

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公式接続設定](https://doc.roote.ai/roote-mcp/connect-roote-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の有効性とヘッダー設定 |
| 制限超過 | 有効な制限、リトライ遅延、呼び出し頻度 |
| 結果が空または部分的 | 座標、フィルター、検索半径、カバレッジ、警告 |

[APIエラーと空結果の区別](https://www.roote.ai/ja/guides/api%E7%B5%90%E6%9E%9C%E3%81%AA%E3%81%97%E3%81%A8%E3%82%A8%E3%83%A9%E3%83%BC%E3%81%AE%E9%81%95%E3%81%84/)

[住所から完全なアシスタントを作る](https://www.roote.ai/ja/guides/%E3%82%A2%E3%83%89%E3%83%AC%E3%82%B9%E5%91%A8%E8%BE%BA%E3%81%AE%E3%83%A2%E3%83%93%E3%83%AA%E3%83%86%E3%82%A3%E3%82%A2%E3%82%B7%E3%82%B9%E3%82%BF%E3%83%B3%E3%83%88%E3%81%AE%E4%BD%9C%E3%82%8A%E6%96%B9/)

[MCPサーバーの役割を理解する](https://www.roote.ai/ja/guides/mcp%E3%82%B5%E3%83%BC%E3%83%90%E3%83%BC%E3%81%A8%E3%81%AF%E4%BD%95%E3%81%8B%E3%81%A8%E3%81%9D%E3%81%AE%E5%BD%B9%E5%89%B2/)

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

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

## よくある質問

### トークンは必須ですか？

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

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

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

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

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