Guide d'installation
Connectez Normi à votre client IA en 3 étapes.
1
Créer un compte et obtenir un token
- Connectez-vous sur normi.fr avec Google.
- Dans le tableau de bord, allez dans Tokens → Créer un token.
- 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://mcp.normi.fr/mcp --header "Authorization: Bearer VOTRE_TOKEN"
Remplacez VOTRE_TOKEN par votre token. La commande doit être sur une seule ligne.
Claude Desktop
Éditez claude_desktop_config.json (Claude Desktop → Paramètres → Développeur) et ajoutez :
{
"mcpServers": {
"normi": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp.normi.fr/mcp"],
"env": {
"BEARER_TOKEN": "VOTRE_TOKEN"
}
}
}
}Redémarrez Claude Desktop après avoir sauvegardé le fichier.
HTTP Streamable (universel)
Pour tout client MCP compatible HTTP Streamable (Cline, Cursor, agents custom…) :
| URL | https://mcp.normi.fr/mcp |
| Transport | HTTP Streamable (POST) |
| Auth header | Authorization: Bearer VOTRE_TOKEN |
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 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 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.