TrustyData Docs
Site Tarifs Contact

Serveur MCP — connecter TrustyData à un assistant IA

TrustyData expose ses services via un serveur MCP à l'adresse https://mcp.trustydata.app/mcp. Une fois connecté à un assistant comme Claude ou ChatGPT, vous vérifiez une adresse, listez des communes ou calculez un itinéraire en langage naturel, sans écrire une ligne de code.

Qu'est-ce qu'un serveur MCP ?

Le MCP (Model Context Protocol) est un standard ouvert qui permet à un assistant IA d'appeler des outils externes pendant une conversation. Plutôt que de répondre « de mémoire » (et risquer d'inventer un code postal ou une population), l'assistant interroge directement TrustyData et restitue une réponse qui fait autorité, issue de sources officielles tenues à jour.

L'intérêt pour vous :

  • Aucun code à écrire — vous posez une question, l'assistant choisit l'outil et formule la réponse.
  • Des données fiables — adresses et communes issues de la BAN et de l'INSEE, itinéraires calculés sur OpenStreetMap. Un résultat vide signifie « aucune correspondance », pas une approximation.
  • La même clé, le même plan — le MCP s'appuie sur votre compte TrustyData existant : les mêmes services, les mêmes quotas, le même plan que l'API REST.

Programmes compatibles

Tout client compatible MCP avec authentification OAuth : Claude (claude.ai, application de bureau), ChatGPT (mode développeur, voir plus bas), ainsi que des éditeurs de code comme Cursor, VS Code ou Zed. Cette page détaille Claude et ChatGPT ; la marche à suivre est très proche pour les autres.

Ce que vous pouvez demander

Six outils sont exposés. Tous sont visibles quel que soit votre plan ; si vous demandez un outil que votre plan n'ouvre pas, l'assistant relaie un message vous invitant à passer au plan requis.

Outil Ce qu'il fait Plan minimum
verify_address Vérifier une adresse française contre la BAN (verdict + adresse canonique) Discovery
search_address Rechercher des adresses à partir d'un texte libre (candidats classés) Discovery
search_locality Rechercher ou lister des communes (par nom, code postal, département, population…) Discovery
get_address_details Récupérer le détail complet d'une adresse via son identifiant Discovery
route_matrix Matrice de distances/durées en voiture entre N origines et M destinations Growth
compute_route Itinéraire routier complet (distance, durée, étapes de navigation, géométrie) Business

La richesse des réponses adresse suit votre plan, exactement comme en API REST : position GPS et Lambert 93 dès Starter, géocodage IRIS dès Growth, grille statistique INSEE Filosofi dès Business. Voir Plans & quotas.

Avant de commencer

La connexion se fait en OAuth : vous ne collez aucune clé d'API dans l'assistant. À la place, une fenêtre de connexion TrustyData s'ouvre et vous autorisez l'accès, comme un « Se connecter avec… » classique.

Utilisez le même e-mail que votre espace client

Au moment de la connexion OAuth, identifiez-vous avec exactement le même e-mail que celui de votre espace client TrustyData. C'est ce qui relie l'assistant à votre compte, votre plan et vos quotas. Un e-mail différent — ou un compte non activé — donnera une erreur « compte introuvable ». Pas encore de compte ? Créez-en un (plan Discovery gratuit).

Connexion à Claude

Sur claude.ai (ou l'application de bureau Claude) :

  1. Ouvrez Réglages → Connecteurs.
  2. Cliquez sur Ajouter un connecteur personnalisé.
  3. Renseignez un nom (par ex. TrustyData) et l'URL du serveur : 
    https://mcp.trustydata.app/mcp
  4. Validez, puis cliquez sur Se connecter : la fenêtre OAuth TrustyData s'ouvre. Connectez-vous avec l'e-mail de votre espace client et autorisez l'accès.
  5. Les outils TrustyData apparaissent. Vous pouvez maintenant poser vos questions d'adresses, de communes et d'itinéraires.

Bien saisir l'URL

L'adresse est mcp.trustydata.app en .app (pas .fr), suffixée par /mcp. Une URL incomplète ou en .fr provoque un « Failed to connect ».

Connexion à ChatGPT

Support en bêta côté OpenAI

Les connecteurs MCP personnalisés de ChatGPT passent par le mode développeur, une fonctionnalité bêta réservée aux offres payantes (Plus, Pro, Team, Enterprise/Edu). L'interface évolue régulièrement. Si une étape ne correspond pas à ce que vous voyez, réessayez plus tard ou contactez-nous.

  1. Dans ChatGPT, ouvrez Réglages → Connecteurs (ou Apps), puis Paramètres avancés, et activez le mode développeur.
  2. Revenez aux connecteurs et choisissez Créer / Ajouter.
  3. Renseignez un nom (TrustyData), l'URL du serveur https://mcp.trustydata.app/mcp, et choisissez l'authentification OAuth.
  4. Validez : connectez-vous avec l'e-mail de votre espace client et autorisez l'accès.

Le mode développeur est indispensable : sans lui, ChatGPT n'attend que des outils de recherche et de lecture standardisés et ne chargera pas les outils TrustyData.

Comment l'assistant choisit d'utiliser TrustyData

Un assistant IA ne « sait » pas d'avance qu'il doit appeler TrustyData. À chaque message, il lit le nom et la description de chaque outil à sa disposition — ceux de TrustyData, mais aussi la recherche web, ses propres connaissances, vos éventuels autres connecteurs — et estime, d'après votre formulation, lequel est le plus pertinent. C'est une décision probabiliste, pas une règle figée : la même question posée autrement peut déclencher l'outil… ou pas.

L'assistant a tendance à appeler TrustyData quand votre demande ressemble à ce que décrivent les outils : une adresse française à vérifier, une commune à retrouver, un itinéraire à calculer. À l'inverse, il peut préférer une recherche web ou répondre de mémoire quand :

  • la demande est vague ou conversationnelle (« c'est grand, Calais ? ») et ne signale pas clairement une vérification d'adresse ou de commune ;
  • elle sort du périmètre des outils — adresse hors de France, question de culture générale ;
  • il juge que sa propre connaissance suffit, au risque d'un chiffre approximatif ou périmé.

Pour qu'il utilise TrustyData

Quand vous voulez la réponse qui fait autorité, guidez-le :

  • Nommez l'action : « vérifie cette adresse », « liste les communes de… », « calcule l'itinéraire de… ».
  • Précisez le contexte : mentionnez la France ou donnez une adresse complète quand la demande est ambiguë.
  • Demandez-le explicitement si besoin : « utilise TrustyData » / « via le connecteur TrustyData ».
  • Corrigez le tir : s'il a répondu de mémoire, « non, vérifie avec TrustyData » suffit à lui faire rappeler l'outil.

Exemples de prompts et de réponses

Voici des échanges réels. Les réponses ci-dessous reprennent les informations renvoyées par les outils ; l'assistant les reformule ensuite dans son propre style.

Vérifier une adresse

Vous : « Peux-tu vérifier l'adresse 32 bis rue de Labbeville 95690 Nesles la Vallée ? »

L'assistant appelle verify_address et répond : l'adresse est confirmée (match_exact), sous la forme canonique 32 bis Rue de Labbeville, 95690 Nesles-la-Vallée, code INSEE 95446, identifiant BAN 95446_0440_00032_bis. 

{
  "verdict": "match_exact",
  "adresse": "32 bis Rue de Labbeville, 95690 Nesles-la-Vallée",
  "code_postal": "95690",
  "nom_commune": "Nesles-la-Vallée",
  "code_insee": "95446",
  "id_ban": "95446_0440_00032_bis"
}

Selon votre plan, la réponse inclut aussi la position (GPS + Lambert 93), le code IRIS et les indicateurs Filosofi.

Lister des communes

Vous : « Quelles communes du Pas-de-Calais dépassent 40 000 habitants ? »

L'assistant appelle search_locality (département 62, population minimale 40 000) et renvoie, population municipale 2022 à l'appui :

  • Calais (62100) — 68 231 habitants
  • Arras (62000) — 43 496 habitants
  • Boulogne-sur-Mer (62200) — 41 439 habitants

Source : INSEE. Les chiffres proviennent du référentiel officiel — l'assistant ne complète jamais une population de mémoire.

Comparer des temps de trajet (matrice)

Vous : « Depuis la place Bellecour à Lyon, compare le temps de trajet en voiture vers l'avenue Tony Garnier et vers la place des Terreaux. »

L'assistant appelle route_matrix (Growth) et répond :

  • → Avenue Tony Garnier : 4,1 km, ≈ 6 min
  • → Place des Terreaux : 4,5 km, ≈ 8 min

Données cartographiques © les contributeurs OpenStreetMap, sous licence ODbL. Voir Attribution OSM.

Calculer un itinéraire complet

Vous : « Donne-moi l'itinéraire en voiture de la place Bellecour à la place des Terreaux, à Lyon. »

L'assistant appelle compute_route (Business) et renvoie 4,5 km, ≈ 8 min avec les étapes de navigation en français : 

1. Conduisez vers l'ouest sur Place Bellecour. (0,1 km)
2. Tournez à gauche dans Quai Tilsitt. (1,1 km)
3. Serrez à gauche dans Trémie n° 7. (0,4 km)
…
9. Tournez à gauche dans Place des Terreaux. (0,02 km)
10. Votre destination est sur la droite.

Données cartographiques © les contributeurs OpenStreetMap, sous licence ODbL.

Astuce — adresses précises pour le routage

Les outils d'itinéraire résolvent d'abord chaque adresse contre la BAN. Donnez une adresse précise (numéro + voie + commune) plutôt qu'un point d'intérêt vague (« la gare ») pour éviter un « adresse non résolue ».

Confidentialité & sécurité

  • Aucune clé exposée — la connexion OAuth ne vous demande jamais de coller une clé d'API dans l'assistant.
  • Accès lié à votre compte — l'autorisation est rattachée à votre seul compte TrustyData ; l'assistant ne voit que ce que vous lui demandez d'interroger.
  • Révocable à tout moment — déconnectez le connecteur depuis votre assistant pour couper l'accès immédiatement.
  • Quota protecteur — votre quota mensuel s'applique aussi via le MCP ; il sert de garde-fou si un assistant tentait d'enchaîner des appels non souhaités.

Consommation de quota

Un appel via assistant compte double

Pour des raisons de coût d'infrastructure, un appel passé via le MCP consomme 2 unités de quota (au lieu d'1 pour le même appel en API REST). Autrement dit, le canal assistant épuise votre quota deux fois plus vite. Le détail de votre consommation, ventilé par service et par canal, reste consultable dans votre espace client.

En cas de problème

Symptôme Cause probable Solution
« Failed to connect » dès l'ajout URL erronée (souvent .fr au lieu de .app, ou sans /mcp) Saisir exactement https://mcp.trustydata.app/mcp
Connexion OK mais « compte introuvable » E-mail OAuth ≠ e-mail de l'espace client, ou compte non activé Se reconnecter avec le bon e-mail ; vérifier que le compte est actif
L'assistant réclame un plan supérieur Outil hors plan (ex. itinéraire réservé à Business) Passer au plan requis depuis l'espace client (voir Plans)
« Adresse non résolue » sur un itinéraire Point de départ/arrivée trop vague Donner une adresse précise (numéro + voie + commune)
Besoin de changer de compte / re-déclencher OAuth Session OAuth précédente encore active Déconnecter puis reconnecter le connecteur dans l'assistant
Aucun outil TrustyData dans ChatGPT Mode développeur non activé Activer le mode développeur (Réglages → Connecteurs → Paramètres avancés)

Prochains pas