# Comment connecter un assistant IA au MCP ROOTE ?

> Connectez un assistant au MCP ROOTE : URL du serveur, configuration HTTP, première recherche, lecture des résultats et dépannage des erreurs.

Source: https://www.roote.ai/fr/guides/connecter-assistant-mcp-roote/
Language: fr
Author: ROOTE

Pour connecter un assistant IA au MCP ROOTE, ajoutez le serveur distant https://mcp.roote.ai/mcp dans une application compatible avec MCP Streamable HTTP. Le serveur expose des outils de lecture pour les adresses, les mobilités et les services à proximité.

Ce tutoriel suit la configuration publiée par ROOTE et une vérification de connexion au serveur. Les intitulés des menus changent selon le client ; l’URL, le transport et le schéma des outils sont les éléments à vérifier. La liste tools/list du serveur peut évoluer avant la documentation : utilisez les capacités réellement annoncées.

## Vérifier la compatibilité du client

Votre application doit accepter un serveur MCP distant en Streamable HTTP. Un client limité aux serveurs locaux stdio ne peut pas utiliser cette URL comme une commande exécutable. Vérifiez également si votre compte autorise l’ajout de serveurs personnalisés.

Si l’application propose un formulaire, renseignez ROOTE comme nom et l’URL du serveur comme adresse. Si elle accepte un fichier au format mcpServers, la documentation ROOTE propose cette configuration minimale :

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

[Configuration officielle de connexion ROOTE](https://doc.roote.ai/roote-mcp/connect-roote-mcp)

## Choisir l’accès anonyme ou authentifié

La documentation prévoit un accès anonyme sans en-tête Authorization, soumis à la projection Free et aux limites actives de l’API. Pour un accès authentifié, utilisez le mécanisme sécurisé du client pour transmettre votre jeton dans un en-tête Bearer.

```
Authorization: Bearer YOUR_API_TOKEN
```

YOUR_API_TOKEN est un emplacement à remplacer dans la configuration sécurisée du client. Ne collez pas le jeton dans une conversation, une URL publique ou un article. Un jeton invalide ou révoqué n’est pas remplacé automatiquement par un accès anonyme.

## Confirmer que les outils sont disponibles

Après la connexion, ouvrez la liste des outils du serveur dans votre client. La documentation ROOTE décrit la séquence initialize, tools/list puis tools/call ; les clients compatibles effectuent normalement ces échanges pour vous. Utilisez la version et les capacités annoncées par le serveur.

Le serveur expose geocode, place_search, reverse_geocode, nearby, mobility_nearby, transit_nearby, transit_disruptions et services_nearby. L’absence de ces outils indique un problème de connexion, de découverte ou une évolution du service. Contrôlez toujours la liste annoncée par le serveur. Journey et Departures n’y sont pas encore exposés.

## Faire une première recherche reproductible

Commencez par une adresse explicite : « Utilise ROOTE pour rechercher 10 rue de Rivoli, Paris, France. Indique les candidats trouvés et leurs coordonnées. » Examinez le résultat de l’outil, pas seulement la réponse rédigée par le modèle.

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

Ce bloc illustre le nom et les arguments d’un appel ; ce n’est pas une requête HTTP complète. Votre client encapsule l’appel MCP. Si plusieurs candidats plausibles reviennent, choisissez le bon avant de rechercher autour du point.

Vous pouvez ensuite tester le transport autour d’un point de référence à Bordeaux. Les coordonnées ci-dessous servent au test et ne prétendent pas provenir de l’adresse parisienne précédente.

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

## Lire le résultat avant de conclure

Vérifiez le statut, les entités retournées, la couverture, les avertissements et les limites appliquées. Une réponse partielle peut contenir des informations utiles. Une recherche vide ne démontre pas l’absence physique de transports dans la ville.

Le résultat attendu du test est une réponse structurée ou une erreur explicite, pas un nombre prédéfini d’arrêts. Les sources et la couverture peuvent évoluer. La recherche d’arrêts ne renvoie pas leurs prochains départs.

## Résoudre les erreurs de connexion

| Symptôme | Vérification utile |
| --- | --- |
| Aucun outil découvert | URL exacte, transport distant et autorisation du client |
| Erreur d’arguments | Types, valeurs autorisées et champs du schéma annoncé |
| Erreur d’authentification | Validité du Bearer et configuration des en-têtes |
| Limite atteinte | Limites actives, délai de reprise et fréquence des appels |
| Résultat vide ou partiel | Coordonnées, filtres, rayon, couverture et avertissements |

[Distinguer un résultat vide d’une erreur API](https://www.roote.ai/fr/guides/aucun-resultat-erreur-api/)

[Créer un assistant complet à partir d’une adresse](https://www.roote.ai/fr/guides/creer-assistant-mobilite-adresse/)

[Comprendre le rôle d’un serveur MCP](https://www.roote.ai/fr/guides/serveur-mcp-definition/)

## À venir : prochains départs et calcul d’itinéraire

ROOTE prévoit d’étendre son MCP aux prochains départs et au calcul d’itinéraire. Ces fonctionnalités sont à venir et ne font pas encore partie des outils actuellement exposés par le serveur MCP. Lors de leur disponibilité, vérifiez les outils annoncés par le serveur, leurs arguments et les informations effectivement retournées avant d’annoncer un passage ou un trajet.

## Questions fréquentes

### Faut-il obligatoirement un jeton ?

La documentation prévoit un accès anonyme Free. Les limites et les capacités de votre accès restent celles appliquées par le service.

### Pourquoi mon assistant annonce-t-il un horaire après une recherche d’arrêt ?

Une recherche transit_nearby ne fournit pas les prochains départs. Demandez à l’assistant de citer les données réellement retournées et de signaler cette absence.

### Peut-on tester sans créer une application ?

Oui, avec un client compatible qui permet d’ajouter un serveur distant et d’exécuter ses outils.