Connecter Normi à VS Code (GitHub Copilot)

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é

Créez le fichier ci-dessous dans votre projet, ou lancez MCP: Add Server depuis la palette de commandes et choisissez HTTP. Au premier démarrage, VS Code détecte la connexion OAuth de Normi et ouvre le navigateur : connectez-vous à normi.fr et autorisez VS Code.

{
  "servers": {
    "normi": {
      "type": "http",
      "url": "https://mcp.normi.fr/mcp"
    }
  }
}

Ou en une ligne, dans votre profil utilisateur :

code --add-mcp '{"name":"normi","type":"http","url":"https://mcp.normi.fr/mcp"}'

Variante avec clé API

VS Code vous demande la clé au premier démarrage du serveur (champ masqué) et la stocke de façon sécurisée : elle n'apparaît jamais dans mcp.json, que vous pouvez donc versionner.

{
  "inputs": [
    {
      "type": "promptString",
      "id": "normi-api-key",
      "description": "Clé API Normi (normi_…)",
      "password": true
    }
  ],
  "servers": {
    "normi": {
      "type": "http",
      "url": "https://mcp.normi.fr/mcp",
      "headers": {
        "Authorization": "Bearer ${input:normi-api-key}"
      }
    }
  }
}

Alternative : paquet STDIO

Si les serveurs distants sont bloqués, lancez le paquet npm @normi/mcp-dvf en local. Il relaie les appels vers le même serveur Normi.

{
  "inputs": [
    {
      "type": "promptString",
      "id": "normi-api-key",
      "description": "Clé API Normi (normi_…)",
      "password": true
    }
  ],
  "servers": {
    "normi": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@normi/mcp-dvf"],
      "env": {
        "NORMI_API_KEY": "${input:normi-api-key}"
      }
    }
  }
}

Premier prompt à essayer

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": "BORDEAUX",
  "periode": { "mois": 24, "date_debut": "2023-12-31", "date_fin": "2025-12-31" },
  "type_local": "Maison",
  "transactions_revente": 2246,
  "flips_detectes": 37,
  "taux_de_flip": 1.65,
  "marge_brute_mediane": 10000,
  "marge_mediane_pct": 3.53,
  "duree_detention_mediane_jours": 646
}

Sur les 24 derniers mois de DVF, 37 des 2 246 reventes de maisons à Bordeaux sont des « flips » (revente sous 18 à 24 mois), soit 1,65 %, avec une marge brute médiane de 10 000 € (+3,5 %). Les adresses ne sont jamais renvoyées : seulement des agrégats.

Dépannage