Connecter Normi à Claude Code

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é

Ajoutez le serveur, puis lancez /mcp dans Claude Code : il ouvre la page de connexion Normi. Aucune clé à copier. --scope user rend Normi disponible dans tous vos projets.

claude mcp add --transport http --scope user normi https://mcp.normi.fr/mcp
# puis, dans Claude Code :
/mcp

Vérifiez l'état de la connexion :

claude mcp list
# normi: https://mcp.normi.fr/mcp (HTTP) - ✔ Connected

Variante avec clé API (CI, machine distante)

Sans navigateur, passez une clé dans l'en-tête Authorization :

export NORMI_API_KEY=normi_VOTRE_TOKEN
claude mcp add --transport http --scope user normi https://mcp.normi.fr/mcp \
  --header "Authorization: Bearer $NORMI_API_KEY"

Pour partager la config avec votre équipe, versionnez un .mcp.json à la racine du projet. Claude Code remplace ${NORMI_API_KEY} par la variable d'environnement de chaque développeur : la clé ne finit jamais dans Git.

{
  "mcpServers": {
    "normi": {
      "type": "http",
      "url": "https://mcp.normi.fr/mcp",
      "headers": {
        "Authorization": "Bearer ${NORMI_API_KEY}"
      }
    }
  }
}

Alternative : paquet STDIO

Le paquet npm @normi/mcp-dvf tourne en local et relaie les appels vers le même serveur Normi. Le -- sépare les options de Claude Code de la commande du serveur.

claude mcp add --env NORMI_API_KEY=normi_VOTRE_TOKEN --transport stdio normi \
  -- npx -y @normi/mcp-dvf

Premier prompt à essayer

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

{
  "classes": {
    "A": { "count": 669,  "median_prix_m2": 9217, "vs_median_pct": -0.8 },
    "B": { "count": 241,  "median_prix_m2": 9543, "vs_median_pct": 2.7 },
    "C": { "count": 1678, "median_prix_m2": 9501, "vs_median_pct": 2.3 },
    "D": { "count": 5303, "median_prix_m2": 9354, "vs_median_pct": 0.7 },
    "F": { "count": 4366, "median_prix_m2": 9206, "vs_median_pct": -0.9 },
    "G": { "count": 1808, "median_prix_m2": 9286, "vs_median_pct": 0 }
  },
  "summary": "Class B homes sell at +2.7% vs. median; class F at -0.9%"
}

À Paris 11, l'écart reste faible : de -0,9 % (classe F) à +2,7 % (classe B) autour de la médiane, sur plus de 20 000 ventes rapprochées d'un DPE. Les médianes ne sont pas corrigées de l'emplacement ni de l'année de vente : c'est une description, pas une « valeur verte » mesurée.

Dépannage