Connecter Normi à Gemini CLI et Antigravity CLI

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).

Gemini CLI : connexion distante (HTTP Streamable)Recommandé

Ajoutez le serveur, puis lancez /mcp auth normi dans Gemini CLI : il ouvre la connexion Normi dans le navigateur. --scope user écrit dans ~/.gemini/settings.json (tous les projets) ; sans lui, la config va dans .gemini/settings.json du projet.

gemini mcp add --transport http --scope user normi https://mcp.normi.fr/mcp
# puis, dans Gemini CLI :
/mcp auth normi

Avec une clé API, sans navigateur :

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

Ou directement dans le fichier. Gemini CLI utilise httpUrl pour le HTTP Streamable (url désigne SSE) et remplace $NORMI_API_KEY par la variable d'environnement :

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

Gemini CLI : paquet STDIO

Alternative locale : le paquet npm @normi/mcp-dvf relaie les appels vers le même serveur Normi.

{
  "mcpServers": {
    "normi": {
      "command": "npx",
      "args": ["-y", "@normi/mcp-dvf"],
      "env": {
        "NORMI_API_KEY": "$NORMI_API_KEY"
      }
    }
  }
}

Antigravity CLI (agy)

Antigravity lit ~/.gemini/config/mcp_config.json (global) ou .agents/mcp_config.json (projet). Un serveur distant se déclare avec serverUrl. Normi prend en charge l'enregistrement dynamique de client : Antigravity gère l'OAuth sans autre réglage. Lancez l'authentification depuis les paramètres de l'agent (onglet Customizations → Authenticate), puis vérifiez avec /mcp.

{
  "mcpServers": {
    "normi": {
      "serverUrl": "https://mcp.normi.fr/mcp"
    }
  }
}

Avec une clé API. La documentation d'Antigravity ne décrit pas de substitution de variables d'environnement dans ce fichier : ne le versionnez pas s'il contient la clé.

{
  "mcpServers": {
    "normi": {
      "serverUrl": "https://mcp.normi.fr/mcp",
      "headers": {
        "Authorization": "Bearer normi_VOTRE_TOKEN"
      }
    }
  }
}

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": "NANTES",
  "periode": { "mois": 24, "date_debut": "2023-12-31", "date_fin": "2025-12-31" },
  "type_local": "Maison",
  "transactions_revente": 1967,
  "flips_detectes": 50,
  "taux_de_flip": 2.54,
  "marge_brute_mediane": -11500,
  "marge_mediane_pct": -3.31,
  "duree_detention_mediane_jours": 624
}

Non, en médiane : sur 24 mois, 50 des 1 967 reventes de maisons nantaises sont des reventes rapides (2,54 %), avec une marge brute médiane de -11 500 € (-3,3 %) après environ 21 mois de détention. Normi ne renvoie que des agrégats, jamais d'adresse.

Dépannage