BigValue Real Estate - Configuración

Configuración de Big Value Real Estate

Después de instalar el plugin, verifica el estado de la conexión MCP. Si aún no se ha iniciado sesión, guía al usuario según el método de inicio de sesión correspondiente a su cliente.

La autenticación es mediante inicio de sesión con Google (OAuth) en el navegador, no mediante una clave API. No se requiere ingresar ningún valor durante la instalación; la primera vez que se usa, un solo inicio de sesión establece la conexión. La gestión y renovación de tokens la maneja el cliente automáticamente.

Esta skill solo verifica el estado y proporciona indicaciones. No ejecuta comandos de inicio de sesión en nombre del usuario — el usuario debe completar el flujo del navegador en su terminal interactivo para que finalice de manera estable. Tampoco edita archivos de configuración ni de credenciales directamente.

Si solo se instaló la skill con npx skills add, la conexión MCP sigue las instrucciones de onboarding y esta skill se omite.

Verificación de estado

1. Identifica el cliente actual. En Claude Code, usa claude plugin list --json y claude mcp list; en Codex, usa codex plugin list --json y codex mcp list --json. Si se requiere aprobación del shell, obténla primero.
2. Verifica que el plugin bigvalue-realestate esté instalado y activo.
3. Verifica el estado del servidor MCP bigvalue-realestate. Antes del inicio de sesión, el servidor rechazará la conexión, mostrando ! Needs authentication; si aparece ✔ Connected, significa que la sesión ha iniciado. Para confirmar, invoca una herramienta representativa.
4. Si solo se solicitó el estado, reporta el resultado en español y no realices ningún cambio.

Ruta para Claude Code

Al instalar el plugin, el servidor MCP se registra automáticamente. Solo queda realizar el inicio de sesión.

No se necesita un comando adicional — en la primera pregunta sobre datos, el cliente abrirá el inicio de sesión en el navegador. A continuación, se describe la ruta manual:

1. Si claude mcp list muestra ! Needs authentication, es normal — significa que aún no se ha iniciado sesión.
2. Indica al usuario que ejecute /mcp y seleccione bigvalue-realestate. El navegador se abrirá y, tras completar el inicio de sesión con Google y los consentimientos, la conexión estará lista.
3. Alternativa: el usuario puede ejecutar directamente claude mcp login plugin:bigvalue-realestate:bigvalue-realestate en una terminal interactiva externa. Esta skill no ejecutará este comando en su lugar.
4. Después del primer inicio de sesión, verifica el estado en una nueva sesión. Los procesos que estaban abiertos antes del inicio de sesión podrían no leer el estado de autenticación.
5. Si la cuenta de inicio de sesión no está en la lista de permitidos, aparecerá la pantalla "Cuenta no conectable". En ese caso, guía al usuario para que solicite la autorización de la cuenta al responsable de onboarding.

Para usar en el chat de Claude Desktop, en lugar del plugin, guía al usuario hacia el conector personalizado: Settings → Connectors → Add custom connector, ingresa https://datamarket-mcp.bigvalue.ai/mcp y presiona Connect; se abrirá el mismo inicio de sesión con Google.

Ruta para Codex

El plugin de Codex solo contiene la skill. El MCP se registra por separado y se inicia sesión de la siguiente manera:

1. Indica al usuario que agregue el servidor en ~/.codex/config.toml. El método de autenticación predeterminado es OAuth, por lo que no es necesario especificarlo.

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

2. El usuario ejecuta el inicio de sesión en una terminal interactiva externa. Esta skill no ejecutará este comando en su lugar.

   codex mcp login bigvalue-realestate
   

3. Reinicia Codex en un nuevo proceso. La configuración y el estado de inicio de sesión no se reflejan en el proceso en ejecución.

4. Verifica la conexión usando codex mcp list --json e invocando una herramienta representativa.

Verificación

Una vez conectado, invoca una herramienta representativa para confirmar la respuesta (por ejemplo, búsqueda de complejos). No muestres ni registres la URL de inicio de sesión, códigos de autorización ni tokens.

Límites de seguridad

• No solicites, muestres, copies ni registres la URL de inicio de sesión, códigos de autorización ni tokens. El flujo del navegador es responsabilidad del usuario.
• Para modificar ~/.codex/config.toml, muestra el fragmento anterior y permite que el usuario lo aplique. No edites directamente archivos de configuración de Claude, archivos de credenciales ni cachés de plugins.
• No elimines ni modifiques otros servidores MCP o plugins irrelevantes configurados por el usuario.