Guide de configuration

Connecter Immo Spot
à votre IA, pas à pas

Chaque écran, chaque bouton, dans l'ordre — pour ChatGPT, Claude, Mistral et les autres. Et surtout : ce qui bloque quand ça ne marche pas.

Le plus fréquent : ChatGPT gratuit ne permet pas d'ajouter un serveur MCP. Claude, si — voir la marche à suivre.

Commencez par vérifier votre formule

C'est la cause d'échec numéro un, et elle n'a rien à voir avec Immo Spot : certaines IA réservent les connecteurs personnalisés à leurs formules payantes.

Votre IA Formules qui le permettent Où ça se passe
ChatGPT Payant Plus, Pro, Business, Enterprise ou Edu Navigateur sur ordinateur uniquement Marche à suivre
Claude Gratuit OK Gratuit (1 connecteur), Pro, Max, Team, Enterprise Navigateur et application de bureau Marche à suivre
Mistral Gratuit OK Gratuit, Pro, Team Navigateur Marche à suivre
Cursor, Windsurf, Claude Desktop… Gratuit OK Selon le client Fichier de configuration Marche à suivre
Claude Code Gratuit OK Selon le client Une ligne de commande Marche à suivre
Valable pour toutes les IA

Deux choses à avoir
sous la main

Votre clé personnelle, et l'adresse du serveur. Quelle que soit votre IA, c'est toujours la même adresse, et elle porte votre clé.

Créer ma clé dans mon compte
1

Créez une clé

Dans votre compte Immo Spot, page Clés IA et API, bouton Créer une clé IA ou API. Notez-la immédiatement : elle ne s'affiche qu'une seule fois. Si vous la perdez, vous ne la retrouverez pas — il faudra en créer une autre, ce qui est sans conséquence.

Il faut un abonnement Application actif, ou un essai en cours : le serveur MCP y est inclus, il n'y a rien à acheter en plus.

2

Composez l'adresse à donner à votre IA

Copiez celle-ci et remplacez VOTRE_CLE par la clé que vous venez de créer.

À coller dans votre IA
https://immo-spot.com/mcp/user?token=VOTRE_CLE

Cette adresse contient votre clé : elle vaut un mot de passe. Ne la publiez pas, ne la partagez pas. Vous pouvez supprimer une clé à tout moment depuis votre compte, ce qui coupe l'accès dans la seconde.

GPT

ChatGPT

Compte payant obligatoire · navigateur sur ordinateur

Un compte ChatGPT gratuit ne peut pas le faire

Chez OpenAI, l'ajout d'un serveur MCP est enfermé dans le « mode développeur », réservé aux formules Plus, Pro, Business, Enterprise et Edu — et disponible dans le navigateur seulement, jamais dans les applications iPhone ou Android. Si vous êtes en compte gratuit, vous ne trouverez pas le réglage : ce n'est pas une erreur de votre part. Deux issues : passer en formule payante, ou utiliser Claude, qui accepte un connecteur personnalisé même avec un compte gratuit.

Aller à la marche à suivre pour Claude
  1. 1

    Ouvrez ChatGPT sur un ordinateur

    Dans un navigateur, sur chatgpt.com. Les applications mobiles ne proposent pas cette fonction : inutile de la chercher sur votre téléphone.
  2. 2

    Activez le mode développeur

    Cliquez sur votre nom en bas à gauche, puis Paramètres → Sécurité et connexion (Settings → Security and login si votre interface est en anglais), et activez Mode développeur (Developer mode). Si vous êtes sur un compte Business ou Enterprise, seul un administrateur peut l'activer, et il doit le faire pour lui-même : demandez-le à la personne qui gère votre espace de travail.
  3. 3

    Créez l'application Immo Spot

    Rendez-vous sur chatgpt.com/plugins et cliquez le bouton +. Tant que le mode développeur n'est pas activé, ce bouton ne propose pas de créer une application à partir d'un serveur MCP.
  4. 4

    Renseignez l'adresse et l'authentification

    Donnez-lui le nom Immo Spot, collez l'adresse ci-dessous en remplaçant VOTRE_CLE par votre clé, et choisissez l'authentification Aucune authentification (No authentication) — c'est correct : votre clé est déjà dans l'adresse, ChatGPT n'a rien d'autre à gérer.
    URL du serveur MCP
    https://immo-spot.com/mcp/user?token=VOTRE_CLE
  5. 5

    Lancez l'analyse des outils, puis créez

    Cliquez Scan tools et laissez l'analyse se terminer : une vingtaine d'outils doivent apparaître (parcelle, DVF, DPE, urbanisme…). Validez avec Créer (Create). Si la liste revient vide, l'adresse ou la clé est en cause — revoyez l'étape précédente.
  6. 6

    L'étiquette « Dev » est normale

    L'application apparaît dans vos brouillons (Drafts) avec une étiquette Dev. Elle est parfaitement utilisable en l'état : rien à publier.
  7. 7

    Activez-la dans la conversation

    Dans un nouveau chat, cliquez le + du champ de saisie → Mode développeur, puis cochez Immo Spot. Attention : la sélection ne vaut que pour le message que vous envoyez, pas pour toute la conversation — il faut la refaire dès que vous redemandez des données.

ChatGPT choisit parfois sa recherche web plutôt que vos outils. Nommez Immo Spot dans votre question : « Utilise Immo Spot pour… », et au besoin ajoutez « n'utilise pas la recherche web ».

CL

Claude

Fonctionne aussi avec un compte gratuit

La voie la plus simple si vous n'avez pas d'abonnement IA

Anthropic autorise un connecteur personnalisé même sur un compte gratuit — un seul, ce qui suffit pour Immo Spot. Les formules Pro, Max, Team et Enterprise en acceptent plusieurs. C'est la solution à recommander à quiconque bute sur ChatGPT.

  1. 1

    Ouvrez les connecteurs

    Sur claude.ai ou dans l'application de bureau : votre nom en bas à gauche → Paramètres → Connecteurs (Settings → Connectors).
  2. 2

    Ajoutez un connecteur personnalisé

    Bouton + → Ajouter un connecteur personnalisé (Add custom connector).
  3. 3

    Collez l'adresse

    Nom : Immo Spot. Adresse : celle ci-dessous, VOTRE_CLE remplacée par votre clé. Ne touchez pas aux paramètres avancés (Advanced settings) : ils servent à OAuth, dont vous n'avez pas besoin. Terminez par Ajouter.
    URL du connecteur
    https://immo-spot.com/mcp/user?token=VOTRE_CLE
  4. 4

    Activez-la dans la conversation

    Dans un chat, cliquez le + en bas à gauche → Connecteurs, et activez Immo Spot. Contrairement à ChatGPT, l'activation tient pour toute la conversation.
  5. 5

    Compte Team ou Enterprise : une étape en plus

    Un propriétaire doit d'abord ajouter le connecteur pour l'organisation, dans Paramètres de l'organisation → Connecteurs. Les membres le retrouvent ensuite dans leurs propres connecteurs et cliquent Se connecter.

Si vous êtes en compte gratuit et que l'ajout est refusé, c'est que vous avez déjà un connecteur personnalisé : supprimez-le, ou passez en Pro.

MI

Mistral

Fonctionne avec un compte gratuit

  1. 1

    Ouvrez les connecteurs

    Sur chat.mistral.ai, dans la barre latérale, puis + Ajouter un connecteur.
  2. 2

    Choisissez l'onglet « Connecteur MCP personnalisé »

    Les autres onglets listent des connecteurs prêts à l'emploi : ce n'est pas là qu'Immo Spot se trouve.
  3. 3

    Nommez et collez l'adresse

    Nom : immo-spot (sans espace ni accent, certains clients les refusent). Adresse du serveur : celle ci-dessous. Puis Connecter.
    URL du serveur MCP
    https://immo-spot.com/mcp/user?token=VOTRE_CLE
  4. 4

    Ou, si Mistral vous propose un jeton

    Mistral sait poser une authentification Bearer Token. Dans ce cas, donnez l'adresse sans ?token= et collez votre clé dans le champ du jeton — c'est un peu plus propre, votre clé ne traînant pas dans l'URL.
    URL sans clé (avec jeton Bearer)
    https://immo-spot.com/mcp/user
  5. 5

    Activez-le dans la conversation

    Bouton + → Outils, puis activez Immo Spot.
{ }

Cursor, Windsurf, Claude Desktop…

Les clients qui se configurent par fichier

  1. 1

    Trouvez le fichier de configuration MCP de votre outil

    Il s'appelle mcp.json, claude_desktop_config.json ou équivalent, et votre outil l'ouvre depuis ses réglages (cherchez « MCP » ou « Serveurs »).
  2. 2

    Ajoutez cette entrée

    Remplacez VOTRE_CLE par votre clé. Ces clients savent envoyer un en-tête HTTP : la clé reste hors de l'adresse, ce qui est préférable. Si vous avez déjà d'autres serveurs, ajoutez seulement le bloc immo-spot à l'intérieur de mcpServers.
    Configuration 
    {
    "mcpServers": {
        "immo-spot": {
            "type": "http",
            "url": "https://immo-spot.com/mcp/user",
            "headers": {
                "Authorization": "Bearer VOTRE_CLE"
            }
        }
    }
}
  3. 3

    Redémarrez l'outil

    La plupart ne relisent leur configuration qu'au démarrage.
›_

Claude Code

Une seule commande dans le terminal

  1. 1

    Lancez cette commande

    Dans votre terminal, en remplaçant VOTRE_CLE par votre clé.
    Terminal 
    claude mcp add --transport http immo-spot https://immo-spot.com/mcp/user --header "Authorization: Bearer VOTRE_CLE"
  2. 2

    Vérifiez

    La commande /mcp dans Claude Code liste les serveurs connectés et leurs outils.
Dernière étape

Vérifiez en une question

Posez celle-ci à votre IA. Si elle vous répond avec des chiffres et cite sa source, tout est en place.

Si elle répond de mémoire, en s'excusant de ne pas avoir accès aux données, ou en allant chercher sur le web : le connecteur n'est pas activé pour ce message. Voyez le dépannage juste en dessous.

Question de test
Utilise Immo Spot pour me donner les dernières ventes enregistrées sur la parcelle du 33 square de la Rance à Rennes, avec leur date et leur prix au m².

Ce que vous devez voir passer

resolve_parcelle — l'adresse est convertie en parcelle cadastrale
parcelle_dvf — les ventes de cette parcelle sont lues

Les noms d'outils apparaissent dans la réponse, souvent repliés : c'est la preuve que votre IA est allée chercher la donnée réelle plutôt que de l'inventer.

Ça ne marche pas ?

Les sept blocages que nous voyons réellement, et quoi faire pour chacun.

Je ne trouve pas « Mode développeur » dans ChatGPT

Pourquoi

Compte gratuit, application mobile, ou compte Business/Enterprise dont l'administrateur ne l'a pas activé.

Ce qu'il faut faire

Le réglage n'existe pas sur un compte gratuit, ni sur mobile. Utilisez un navigateur sur ordinateur avec une formule payante — ou passez par Claude, qui accepte un connecteur en gratuit.

Le connecteur s'ajoute mais aucun outil n'apparaît

Pourquoi

L'adresse est incomplète : il manque ?token=, ou la clé n'a pas été collée à la place de VOTRE_CLE.

Ce qu'il faut faire

Recopiez l'adresse depuis cette page, remplacez VOTRE_CLE, et vérifiez qu'aucun espace ne s'est glissé au début ou à la fin.

Erreur 401, « non autorisé », « unauthorized »

Pourquoi

La clé n'est plus valable : supprimée, ou recopiée de travers.

Ce qu'il faut faire

Créez une nouvelle clé dans votre compte et refaites l'ajout. Une clé ne s'affiche qu'une fois à sa création : si vous ne l'avez pas notée, elle est perdue, créez-en une autre.

Erreur 402, « un abonnement Application est requis »

Pourquoi

La clé est bonne, mais le compte n'a ni abonnement Application ni essai en cours.

Ce qu'il faut faire

Le serveur MCP est inclus dans l'offre Application. Activez l'essai gratuit ou l'abonnement, la clé existante se remettra à fonctionner sans rien reconfigurer.

L'IA répond de mémoire, sans interroger Immo Spot

Pourquoi

Rien n'oblige une IA à utiliser un outil ; elle choisit, et se trompe parfois.

Ce qu'il faut faire

Nommez-le : « Utilise Immo Spot pour… ». Ajoutez « n'utilise pas la recherche web » si elle insiste. Sur ChatGPT, vérifiez aussi que l'application est bien cochée pour ce message.

Ça fonctionnait, ça ne fonctionne plus

Pourquoi

Clé supprimée, abonnement interrompu, ou liste d'outils devenue obsolète côté ChatGPT.

Ce qu'il faut faire

Vérifiez d'abord la clé et l'abonnement. Côté ChatGPT, la liste des outils est figée au moment de la création : ouvrez la fiche de l'application et utilisez Refresh pour récupérer les nouveaux outils.

Erreur 429, « trop de requêtes »

Pourquoi

Les garde-fous du serveur : 10 appels par minute, et 1 000 appels par mois et par utilisateur.

Ce qu'il faut faire

Attendez une minute. Votre consommation du mois est visible dans votre compte, à la page Utilisation de l'API.

Rien de tout cela ne débloque votre situation ? Écrivez-nous à contact@immo-spot.com en précisant votre IA, votre formule, et le message d'erreur exact. Ne joignez jamais votre clé.

Questions fréquentes

Faut-il un abonnement payant à ChatGPT ou Claude ?

Pour ChatGPT, oui : l'ajout d'un serveur MCP demande une formule Plus, Pro, Business, Enterprise ou Edu. Pour Claude, non : un compte gratuit peut ajouter un connecteur personnalisé, ce qui suffit pour Immo Spot. Mistral l'autorise aussi en gratuit.

Puis-je le configurer depuis mon téléphone ?

Non pour ChatGPT, dont le mode développeur n'existe que dans le navigateur sur ordinateur. Une fois le connecteur ajouté depuis un ordinateur, il reste en revanche utilisable depuis l'application mobile.

Est-ce dangereux de mettre ma clé dans l'adresse du serveur ?

Cette adresse vaut un mot de passe : ne la publiez pas et ne la transmettez à personne. La plupart des IA grand public ne permettent pas d'ajouter un en-tête HTTP, d'où cette solution. Vous pouvez supprimer une clé à tout moment depuis votre compte, ce qui coupe immédiatement l'accès. Les clients qui acceptent un en-tête (Cursor, Claude Desktop, Claude Code, Mistral) permettent de garder la clé hors de l'adresse.

Faut-il une clé par personne dans l'équipe ?

Oui. Chaque utilisateur crée sa propre clé depuis son compte, et sa consommation est comptée séparément. Ne partagez pas une clé entre plusieurs personnes.

Combien de questions puis-je poser ?

1 000 appels d'outils par mois et par utilisateur, dans la limite de 10 par minute. Une question en langage naturel déclenche souvent plusieurs appels : localiser la parcelle, puis lire les ventes, puis les DPE.

Mon IA ne connaît pas le mot « MCP », est-ce grave ?

Non. Vous n'avez rien à expliquer à votre IA : dès que le connecteur est ajouté, elle découvre seule les outils disponibles et leur mode d'emploi.

Revenir à la présentation du serveur MCP
MCP · IA

Pas encore de compte
Immo Spot ?

Cinq minutes de configuration, et votre IA interroge les données immobilières officielles.

Créer mon compte Voir ce que le MCP sait faire
Sans carte bancaire
Accès immédiat à toutes les données
Sans engagement