Serveur MCP — connectez une IA à vos itinéraires

Waydo expose un serveur MCP (Model Context Protocol) — le standard qui permet aux assistants IA (p. ex. Claude) d'utiliser des outils externes en toute sécurité. Une fois connectée, l'IA peut lire et modifier vos itinéraires enregistrés : parcourir les jours et les étapes, rechercher des lieux, ajouter, supprimer et réordonner des étapes.

Prérequis

L'intégration MCP fait partie du plan Premium. Les outils travaillent sur les itinéraires enregistrés (« Mes itinéraires » dans l'application) — rechargez l'itinéraire dans l'app pour voir les modifications.

Étape 1 — générer une clé API

1. Connectez-vous sur waydo.app et ouvrez le menu utilisateur → Compte et abonnement.
2. Allez dans l'onglet Abonnement → section Clé API (MCP).
3. Cliquez sur Générer la clé et copiez-la immédiatement — la clé (format wd_…) n'est affichée qu'une seule fois. Vous pouvez à tout moment en générer une nouvelle (l'ancienne cesse de fonctionner) ou la supprimer.

Traitez la clé comme un mot de passe

Quiconque possède votre clé peut lire et modifier vos itinéraires enregistrés. En cas de fuite, régénérez-la ou supprimez-la immédiatement dans l'application.

Étape 2 — connecter un client MCP

Endpoint : https://waydo.app/api/mcp (HTTP streamable). Autorisation par l'en-tête Authorization: Bearer <clé>.

Claude Code

Ajoutez à .mcp.json du projet (ou via claude mcp add) :

{
  "mcpServers": {
    "waydo": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://waydo.app/api/mcp",
        "--header", "Authorization:Bearer ${WAYDO_API_KEY}"
      ],
      "env": { "WAYDO_API_KEY": "wd_VOTRE_CLE" }
    }
  }
}

Plus sûr : gardez la clé dans une variable d'environnement ou un gestionnaire de secrets et injectez-la via env, plutôt que de l'écrire dans le fichier.

Claude Desktop

Dans claude_desktop_config.json (Paramètres → Developer → Edit Config) :

{
  "mcpServers": {
    "waydo": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://waydo.app/api/mcp",
        "--header", "Authorization:Bearer wd_VOTRE_CLE"
      ]
    }
  }
}

Après le redémarrage du client, les outils Waydo apparaissent automatiquement.

Outils disponibles

Outil	Description
list_trips	Vos itinéraires enregistrés (id, nom, nombre de jours et d'étapes)
get_trip	Plan complet : jours, étapes (positions, adresses, coordonnées), tronçons avec mode de transport, distance et durée
search_places	Recherche de lieux en texte libre (Google Places) — renvoie un place_id pour add_stop
add_stop	Ajouter une étape à un jour (à la fin ou à une position donnée)
remove_stop	Supprimer l'étape à une position donnée
move_stop	Réordonner les étapes au sein d'un jour
set_travel_mode	Définir le mode de transport d'un tronçon (voiture / à pied / vol / ferry) — les nouveaux tronçons sont « voiture » par défaut

Exemples de requêtes pour votre assistant :

« Montre mon itinéraire Pont de mai et propose des visites en chemin. »

« Ajoute Sandomierz à la fin du premier jour de l'itinéraire Pont de mai. »

« Déplace Kazimierz Dolny avant Lublin au jour deux. »

Règles et limites

• Les positions des étapes commencent à 1 (première étape = 1).
• La première étape du jour 2+ reflète la dernière étape du jour précédent — elle ne peut pas être supprimée ni déplacée, et rien ne peut être inséré avant elle. Modifier la dernière étape d'un jour met automatiquement à jour la première étape du jour suivant (comme dans l'app).
• Les itinéraires et distances sont recalculés à la prochaine ouverture de l'itinéraire dans l'app.
• Limite : 120 requêtes par minute.
• La clé ne fonctionne qu'avec un abonnement Premium actif — ensuite les requêtes renvoient 403.