BigValue Real Estate – Paramètres

Configuration de BigValue Real Estate

Une fois le plug-in installé, vérifiez l'état de la connexion MCP. Si l'utilisateur n'est pas encore connecté, guidez-le vers la méthode de connexion adaptée à son client.

L'authentification se fait via OAuth Google par navigateur – pas de saisie de clé API. Aucune valeur n'est requise lors de l'installation ; une seule connexion lors de la première utilisation suffit. Le client gère automatiquement le stockage et le renouvellement des jetons.

Cette compétence se contente de vérifier l'état et de fournir des instructions. Elle n'exécute pas les commandes de connexion à la place de l'utilisateur – le round-trip navigateur doit être effectué par l'utilisateur directement dans son terminal interactif pour se terminer de manière fiable. Elle ne modifie pas non plus les fichiers de configuration ou d'identification.

Si la compétence a été installée avec npx skills add, suivez le guide d'intégration pour la connexion MCP ; cette compétence est alors ignorée.

Vérification de l'état

1. Identifiez le client actuel. Pour Claude Code, utilisez claude plugin list --json et claude mcp list ; pour Codex, codex plugin list --json et codex mcp list --json. Si une approbation shell est requise, demandez-la d'abord.
2. Vérifiez que le plug-in bigvalue-realestate est installé et actif.
3. Vérifiez l'état du serveur MCP bigvalue-realestate. Avant connexion, le serveur refuse la connexion et affiche ! Needs authentication ; ✔ Connected signifie que l'utilisateur est connecté. Pour confirmer, appelez un outil représentatif une fois.
4. Si l'utilisateur demande uniquement l'état, rapportez le résultat en français et ne modifiez rien.

Chemin Claude Code

Lorsque le plug-in est installé, le serveur MCP est automatiquement enregistré. Il ne reste plus qu'une seule connexion.

Aucune commande supplémentaire n'est nécessaire – lors de la première question de données, le client ouvre le navigateur pour la connexion. Voici le chemin manuel :

1. Si claude mcp list affiche ! Needs authentication, c'est normal – l'utilisateur n'est pas encore connecté.
2. Guidez l'utilisateur pour exécuter /mcp et sélectionner bigvalue-realestate. Le navigateur s'ouvre, et après la connexion Google et l'accord, la connexion est terminée.
3. Alternative : l'utilisateur peut exécuter directement claude mcp login plugin:bigvalue-realestate:bigvalue-realestate dans un terminal interactif externe. Cette compétence n'exécute pas cette commande à sa place.
4. Immédiatement après la première connexion, vérifiez dans une nouvelle session. Le processus existant avant la connexion peut ne pas lire l'état d'authentification.
5. Si le compte de connexion n'est pas dans la liste autorisée, un écran "Compte non autorisé" s'affiche. Dans ce cas, guidez l'utilisateur pour demander l'autorisation à l'administrateur d'intégration.

Pour utiliser depuis un chat Claude Desktop, guidez l'utilisateur vers un connecteur personnalisé au lieu du plug-in – Settings → Connectors → Add custom connector, entrez https://datamarket-mcp.bigvalue.ai/mcp et cliquez sur Connect ; la même connexion Google s'affiche.

Chemin Codex

Le plug-in Codex ne contient que la compétence. Le MCP doit être enregistré séparément, comme décrit ci-dessous, puis connecté.

1. Guidez l'utilisateur pour ajouter le serveur dans ~/.codex/config.toml :

   [mcp_servers.bigvalue-realestate]
   url = "https://datamarket-mcp.bigvalue.ai/mcp"
   

   Le mode d'authentification par défaut est OAuth, donc il n'est pas nécessaire de le préciser.

2. L'utilisateur exécute la connexion dans un terminal interactif externe. Cette compétence n'exécute pas cette commande à sa place.

   codex mcp login bigvalue-realestate
   

3. Redémarrez Codex dans un nouveau processus. La configuration et l'état de connexion ne sont pas répercutés dans le processus en cours.

4. Vérifiez la connexion avec codex mcp list --json et un appel à un outil représentatif.

Vérification

Une fois connecté, appelez un outil représentatif (par exemple, recherche de complexes résidentiels) pour vérifier la réponse. N'affichez ni n'enregistrez l'URL de connexion, le code d'autorisation ou le jeton.

Limites de sécurité

• Ne demandez, n'affichez, ne copiez et n'enregistrez jamais l'URL de connexion, le code d'autorisation ou le jeton. Le round-trip navigateur incombe à l'utilisateur.
• Pour la modification de ~/.codex/config.toml, montrez l'extrait ci-dessus et laissez l'utilisateur l'appliquer lui-même. Ne modifiez pas directement les fichiers de configuration Claude, les fichiers d'identification ou le cache des plug-ins.
• Ne supprimez ni ne modifiez aucun autre serveur MCP configuré par l'utilisateur ou des plug-ins non liés.