Si Claude nombra las tres herramientas correctamente y con los nombres exactos, la conexión es técnicamente correcta. Si Claude no reacciona al conector o no conoce las herramientas, hay un error de configuración — continúe con el siguiente apartado.
¿Qué Hago si el Conector No Funciona?
La gran mayoría de los problemas en la primera configuración se deben a cuatro causas: una clave de acceso incorrecta o ausente, un error tipográfico en la URL del endpoint, un tipo de transporte mal elegido, o un conector todavía sin activar. El siguiente repaso cubre los casos reales más habituales.
El mensaje apunta a un error de autenticación (por ejemplo, 401/Unauthorized)
Esto casi siempre indica un problema con el token Bearer: falta la clave de acceso, se copió mal (por ejemplo con un espacio de más al final), fue revocada en los ajustes, o falta la palabra Bearer delante de la clave. En ese caso, cree una nueva clave de acceso en Ajustes → "Claude / MCP" e introdúzcala de nuevo completa, incluyendo Bearer y un espacio antes de la clave.
El conector aparece como "no conectado" o no aparece en absoluto
Compruebe primero si hay errores tipográficos en la URL del endpoint — debe ser exactamente https://mcp.immostage.ai/api/mcp, incluida la ruta /api/mcp al final. Compruebe después si el conector se guardó y activó realmente en los ajustes. Iniciar un chat nuevo tras guardar suele ayudar, porque los chats ya abiertos no siempre recargan automáticamente la lista de conectores.
Tipo de transporte incorrecto en Claude Code
El ImmoStage MCP Server funciona exclusivamente con transporte HTTP. Por eso, el comando del paso 4 debe incluir --transport http. Si el servidor se registró por error con otro tipo de transporte, elimine la entrada y vuelva a ejecutar el comando del paso 4 sin modificarlo.
Todavía no se ha creado la clave de acceso
Sin una clave creada en Ajustes → "Claude / MCP", no funciona ni el comando en Claude Code ni el conector personalizado — sencillamente no hay ningún token Bearer que introducir. Cree primero la clave antes de repetir el paso 4 o el 5.
Regla básica ante cualquier problema de conexión: URL del endpoint exacta https://mcp.immostage.ai/api/mcp, cabecera exacta Authorization: Bearer TU_CLAVE con espacio después de "Bearer", y una clave de acceso recién creada y no revocada. Estos tres puntos resuelven la gran mayoría de los problemas de configuración.
¿Qué Hago Después de la Configuración?
En cuanto el prompt de prueba funcione, tendrá disponible el flujo completo de staging directamente en el chat. Cinco estilos (moderno, escandinavo, clásico, minimalista, lujo) y cinco tipos de habitación (salón, dormitorio, cocina, baño, oficina) cubren la mayoría de los inmuebles. Las primeras 3 imágenes por cuenta siguen siendo gratis; a partir de ahí, paga según su volumen: Individual por 29 € únicos por inmueble sin suscripción, Starter por 49 € al mes con 10 inmuebles, o Pro por 199 € al mes sin límite — todos los planes mensuales son cancelables cada mes.
Si quiere conocer con detalle todo lo que ofrece el ImmoStage MCP Server más allá del staging básico, encontrará la referencia completa de las herramientas en Servidor MCP Inmobiliario: las 3 Herramientas de ImmoStage.
