Guide d'installation

Connectez Normi à votre client IA en 3 étapes.

1

Créer un compte et obtenir un token

  1. Connectez-vous sur normi.fr avec Google.
  2. Dans le tableau de bord, allez dans Tokens → Créer un token.
  3. Copiez le token affiché — il ne sera plus visible ensuite.
Un seul token actif par compte
Chaque compte peut avoir un seul token actif. Créer un nouveau token révoque silencieusement l'ancien.
2

Connecter votre client

Claude Code Recommandé

Ouvrez un terminal et exécutez :

claude mcp add --transport http normi https://normimcp-server-production.up.railway.app/mcp --header "Authorization: Bearer VOTRE_TOKEN"

Remplacez VOTRE_TOKEN par votre token. La commande doit être sur une seule ligne.

Voir le guide Claude complet ->

Claude Desktop

Éditez claude_desktop_config.json (Claude Desktop → Paramètres → Développeur → Modifier la config) et ajoutez :

{
  "mcpServers": {
    "normi": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://normimcp-server-production.up.railway.app/mcp"],
      "env": {
        "BEARER_TOKEN": "VOTRE_TOKEN"
      }
    }
  }
}

Redémarrez Claude Desktop après avoir sauvegardé le fichier.

Voir le guide Claude complet ->

ChatGPT

ChatGPT utilise une URL MCP revocable generee par Normi, sans header Bearer. Le guide dedie couvre le mode developpeur, l'avertissement de risque et la creation de l'application.

  1. Allez dans Dashboard → Tokens.
  2. Créez un token API si aucun token actif n'existe.
  3. Dans Connecteurs IA, cliquez sur Créer une URL ChatGPT.
  4. Copiez l'URL affichée.
  5. Dans ChatGPT, activez Parametres - Applications - Parametres avances - Mode Developpeur.
  6. Creez une application nommee Normi et collez l'URL copiee.
  7. Choisissez Aucune authentification. N'ajoutez pas de header Bearer dans ChatGPT.
Voir le guide ChatGPT complet ->
Quel est le prix médian au m² pour les appartements à Lyon 6 ?
URL privée
L'URL ChatGPT agit comme un mot de passe. Révoquez-la depuis le dashboard si elle a été partagée. Révoquer le token API Normi désactive aussi le connecteur ChatGPT.

HTTP Streamable (universel)

Pour tout client MCP compatible HTTP Streamable (Cline, Cursor, agents custom…) :

URLhttps://normimcp-server-production.up.railway.app/mcp
TransportHTTP Streamable (POST)
Auth headerAuthorization: Bearer VOTRE_TOKEN

Ask This Guy Plateforme partenaire

Ask This Guy est une plateforme d'IA conversationnelle qui intègre Normi nativement dans son catalogue MCP. Vos utilisateurs peuvent interroger les données DVF directement depuis leurs conversations.

  1. Connectez-vous à votre console Ask This Guy.
  2. Accédez à Tools management → MCP Catalog.
  3. Sélectionnez Normi et renseignez votre clé API (normi_…).
  4. Normi est immédiatement disponible dans vos conversations.
Voir la documentation Ask This Guy →
3

Vérifier que ça fonctionne

Dans Claude, posez une question sur les prix immobiliers français :

Quel est le prix médian au m² pour les appartements à Lyon 6 ?
Montre-moi l'évolution des prix à Bordeaux ces 3 dernières années.
Trouve des biens comparables à un appartement de 65m² à Paris 11.

Claude appellera automatiquement les outils Normi et vous retournera des données DVF réelles.

Résolution de problèmes

Erreur 401 — Unauthorized
Votre token est manquant, invalide ou révoqué. Régénérez un token depuis le tableau de bord.
Erreur 401 avec ChatGPT
L'URL ChatGPT est mal copiée, révoquée, ou le token API Normi lié a été révoqué. Regénérez une URL depuis Dashboard → Tokens → Connecteurs IA.
Erreur 409 — Session expired
La session MCP a expiré (TTL 15 min). Réinitialisez la connexion (relancez Claude Desktop ou exécutez à nouveau la commande claude mcp add).
Erreur 409 avec ChatGPT
La session MCP ChatGPT a expiré. Testez à nouveau le connecteur dans ChatGPT ou recréez l'application MCP si la session ne se réinitialise pas.
Erreur 429 — Rate limited
Vous dépassez la limite de requêtes/minute de votre plan. Attendez quelques secondes.
Crédits insuffisants
L'erreur apparaît dans le texte de la réponse (pas en HTTP 402). Achetez des crédits depuis le tableau de bord.
Claude ne trouve pas l'outil Normi
Vérifiez que la commande a bien été exécutée dans le bon terminal. Sur Claude Desktop, redémarrez l'application après avoir édité le fichier de config.

Étapes suivantes