Guide d'installation
Connectez Normi à votre client IA : collez une URL, connectez-vous, autorisez. Ou utilisez une clé API.
Guides par client
Configuration exacte, premier prompt avec sa réponse réelle et dépannage propre à chaque client :
Choisir la méthode
| Client | Méthode |
|---|---|
| claude.ai (web, mobile, Cowork), Claude Desktop | Un clic depuis l'annuaire Claude, puis connexion OAuth |
| ChatGPT | Connexion OAuth |
| Claude Code | Connexion OAuth (/mcp), ou clé API |
| Cursor, VS Code (Copilot), Windsurf, Gemini CLI | Connexion OAuth, ou clé API |
| n8n, LangChain / LangGraph, API REST, scripts, CI | Clé API normi_… |
Avec OAuth, pas besoin de créer de clé à l'avance : si votre compte n'en a pas, une clé gratuite (500 crédits) est créée à la première autorisation. Dans tous les cas, les crédits sont débités sur la clé active de votre compte. En savoir plus
Connecter votre client
claude.ai, Claude Desktop, mobile, Cowork Recommandé
Normi est dans l'annuaire des connecteurs Claude : ouvrez la fiche, cliquez pour l'ajouter, puis connectez-vous à Normi et autorisez Claude. Aucune URL à coller.
Annuaire indisponible dans votre organisation ? Ajoutez un connecteur personnalisé avec cette URL :
https://mcp.normi.fr/mcp
ChatGPT
- Dans ChatGPT : Plugins → Ajouter → Créer une application MCP.
- Nom libre (si « Normi » est déjà pris, par exemple « Normi-mcp »), URL ci-dessous, authentification OAuth, puis Créer.
- Connectez-vous à Normi et autorisez ChatGPT.
https://mcp.normi.fr/mcp
Quel est le prix médian au m² pour les appartements à Lyon 6 ?
Claude Code
Ajoutez le serveur, puis lancez /mcp dans Claude Code pour vous connecter :
claude mcp add --transport http normi https://mcp.normi.fr/mcp # puis, dans Claude Code : /mcp
Sans navigateur (CI, machine distante), avec une clé API :
claude mcp add --transport http normi https://mcp.normi.fr/mcp --header "Authorization: Bearer VOTRE_TOKEN"
Clé API (REST, scripts, n8n, STDIO)
- 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.
Claude Desktop avec une clé, via le paquet STDIO @normi/mcp-dvf :
{
"mcpServers": {
"normi": {
"command": "npx",
"args": ["-y", "@normi/mcp-dvf"],
"env": { "NORMI_API_KEY": "normi_VOTRE_TOKEN" }
}
}
}Clients sans OAuth ni en-têtes personnalisés : une URL de connecteur secrète est disponible dans Dashboard → Tokens → Connecteurs IA (section Avancé).
HTTP Streamable (universel)
Pour tout client MCP compatible HTTP Streamable (Cline, agents custom…) :
| URL | https://mcp.normi.fr/mcp |
| Transport | HTTP Streamable (POST) |
| Auth | OAuth 2.1 (découverte via 401 + WWW-Authenticate), ou Authorization: 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.
- Connectez-vous à votre console Ask This Guy.
- Accédez à Tools management → MCP Catalog.
- Sélectionnez Normi et renseignez votre clé API (
normi_…). - Normi est immédiatement disponible dans vos conversations.
Vérifier que ça fonctionne
Dans Claude ou ChatGPT, posez une question sur les prix immobiliers français :
Claude appellera automatiquement les outils Normi et vous retournera des données DVF réelles.