Guide d'installation / n8n

Connecter Normi à un agent IA n8n

Dans n8n, le nœud MCP Client Tool donne à un AI Agent l'accès aux outils Normi : ventes DVF, DPE, BDNB, dans vos workflows automatisés (veille de marché, enrichissement de leads, rapports).

https://mcp.normi.fr/mcp

Paramètres vérifiés le 10 octobre 2026 avec la documentation n8n et le code source du nœud MCP Client Tool (version 1.4 du nœud). Documentation n8n MCP Client Tool

Avant de commencer

  • Un compte Normi : connexion avec Google, 500 crédits gratuits par mois.
  • Pour la connexion par clé API ou le paquet STDIO : une clé normi_…, créée dans Tableau de bord → Tokens. Elle n'est affichée qu'une fois.
  • Pour le paquet STDIO : Node.js 18 ou plus récent (npx).

Connexion distante (HTTP Streamable)Recommandé

  1. Dans votre workflow, ajoutez un nœud AI Agent et branchez-lui un modèle de chat.
  2. Sur l'entrée Tool de l'agent, ajoutez MCP Client Tool.
  3. Renseignez l'Endpoint et le transport HTTP Streamable.
  4. Authentification Bearer Auth : créez un credential avec votre clé normi_… comme token.
  5. Choisissez les outils exposés à l'agent, puis exécutez le workflow.
Endpoint:          https://mcp.normi.fr/mcp
Server Transport:  HTTP Streamable
Authentication:    Bearer Auth
  Credential → Bearer Token: normi_VOTRE_TOKEN
Tools to Include:  Selected
  → analyze_dpe_price_premium, get_market_overview, resolve_location

Le nœud propose aussi MCP OAuth2. La clé API reste le choix le plus simple pour un workflow qui tourne sans surveillance : elle ne dépend d'aucune session navigateur.

Cadrer l'agent

Un message système court évite les appels inutiles. Normi exige un filtre de localisation sur chaque requête : demander d'abord resolve_location évite les erreurs sur les noms de communes.

Tu es un analyste immobilier. Pour toute question sur un lieu,
appelle d'abord resolve_location pour obtenir les filtres canoniques,
puis l'outil Normi adapté. Cite toujours le nombre de ventes utilisées.

Paquet STDIO

Le nœud intégré de n8n ne lance pas de serveur STDIO : utilisez la connexion distante ci-dessus. Pour appeler Normi sans agent, le nœud HTTP Request fonctionne aussi avec l'API REST, qui expose les mêmes données.

Premier prompt à essayer

“Quel est le taux de revente rapide des maisons à Rennes, et ces reventes sont-elles rentables ?”

L'agent appelle detect_flips (10 crédits). Extrait de la réponse réelle, relevée le 10 octobre 2026 sur les données DVF 2014–2025 :

{
  "commune": "RENNES",
  "periode": { "mois": 24, "date_debut": "2023-12-31", "date_fin": "2025-12-31" },
  "type_local": "Maison",
  "transactions_revente": 938,
  "flips_detectes": 11,
  "taux_de_flip": 1.17,
  "marge_brute_mediane": -6040,
  "marge_mediane_pct": -1.44,
  "duree_detention_mediane_jours": 651
}

Sur 24 mois, 11 des 938 reventes de maisons à Rennes (1,17 %) sont des reventes rapides, avec une marge brute médiane de -6 040 € (-1,4 %). Dans un workflow, branchez la sortie de l'agent sur un e-mail ou une ligne de Google Sheets pour un suivi mensuel.

Dépannage

Le nœud ne liste aucun outil, ou échoue à se connecter↓
Vérifiez le transport : choisissez HTTP Streamable, pas Server Sent Events. Les nœuds créés en version 1 n'ont qu'un champ « SSE Endpoint » : supprimez-le et ajoutez un nouveau MCP Client Tool pour obtenir la version actuelle.
401 alors que la clé est correcte↓
Avec Bearer Auth, saisissez la clé seule (normi_…), sans le mot « Bearer ». Avec Header Auth, le nom est Authorization et la valeur « Bearer normi_… ».
L'agent appelle trop d'outils, ou les mauvais↓
Passez « Tools to Include » à Selected et ne gardez que les outils utiles au workflow. Chaque appel consomme des crédits : un agent mal cadré peut en dépenser beaucoup en une exécution.
Délai dépassé sur un gros appel↓
Certaines analyses prennent quelques secondes. Augmentez Options → Timeout du nœud (60 000 ms par défaut) si votre instance coupe avant.
Erreur 401 — Unauthorized↓
Clé API : elle est absente, mal recopiée ou révoquée (le préfixe normi_ fait partie de la clé). Vérifiez que la variable d'environnement est bien visible du client. OAuth : l'accès a expiré ou a été révoqué, relancez la connexion depuis le client.
« no active API key » (403) sur chaque appel↓
Votre compte n'a plus de clé active. Créez-en une dans le tableau de bord : une connexion OAuth reprend dès l'appel suivant, une config par clé doit recevoir la nouvelle clé.
Crédits insuffisants↓
Le message arrive dans la réponse de l'outil, pas en HTTP 402. Le plan gratuit recharge 500 crédits le 1er du mois ; vous pouvez aussi acheter des crédits depuis le tableau de bord.
Erreur 429 — Rate limited↓
Vous dépassez la limite de requêtes par minute de votre plan. Attendez quelques secondes, ou limitez les appels en parallèle de votre agent.

Étapes suivantes