Guide Claude MCP

Connecter Normi directement a Claude

Interrogez les donnees immobilieres francaises DVF directement depuis Claude Code (VS Code / terminal) ou Claude Desktop, avec votre token Normi.

Creer un token Ouvrir le dashboard

Avant de commencer

Un compte Normi connecte.

Un token API actif dans le dashboard.

Claude Code (VS Code) ou Claude Desktop installe.

Claude Code

Recommande

Ouvrez un terminal (ou le terminal integre de VS Code) et executez cette commande une seule fois :

claude mcp add --transport http normi https://normimcp-server-production.up.railway.app/mcp --header "Authorization: Bearer VOTRE_TOKEN"

La commande doit etre sur une seule ligne. Remplacez VOTRE_TOKEN par votre token.

Verifiez la connexion avec claude mcp list, puis utilisez /mcp dans Claude Code pour inspecter l'etat du serveur.

Claude Desktop

Dans Claude Desktop, allez dans Parametres (icone engrenage) → Developpeur → Modifier la config. Ouvrez le fichier avec Bloc-notes ou VS Code, ajoutez le bloc suivant, sauvegardez, puis redemarrez Claude Desktop.

{
  "mcpServers": {
    "normi": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://normimcp-server-production.up.railway.app/mcp"],
      "env": {
        "BEARER_TOKEN": "VOTRE_TOKEN"
      }
    }
  }
}

Redemarrez Claude Desktop apres avoir sauvegarde le fichier.

Votre token est confidentiel

Votre token Normi agit comme un mot de passe. Ne le partagez jamais. Vous pouvez le revoquer a tout moment depuis le dashboard.

Tester la connexion

Posez une question sur les prix immobiliers francais dans Claude :

“Quel est le prix median au m2 pour les appartements a Lyon 6 ?”

“Montre-moi l'evolution des prix a Bordeaux ces 3 dernieres annees.”

“Trouve des biens comparables a un appartement de 65 m2 a Paris 11.”

Claude appelera automatiquement les outils Normi et retournera des donnees DVF reelles.

Depannage

Erreur 401 — Votre token est manquant, invalide ou revoque. Regenerez un token depuis le dashboard.

Erreur 409 — La session MCP a expire (TTL 60 min). Relancez Claude Desktop ou re-executez la commande claude mcp add.

Erreur 429 — Limite de requetes atteinte. Attendez quelques secondes ou passez a un plan superieur.

Credits insuffisants — L'erreur apparait dans le texte de la reponse. Achetez des credits depuis le dashboard.

Outil Normi introuvable — Verifiez que la commande a bien ete executee dans le bon terminal. Sur Claude Desktop, redemarrez l'application apres avoir edite le fichier de config.

Connecter ChatGPT

Première requête REST