Cómo conectar Idealista a Claude — via MCP

Solo autoalojado. Idealista rechaza las peticiones que llegan desde direcciones IP de centros de datos, y AnythingMCP Cloud funciona en un centro de datos, así que este conector no está disponible en AnythingMCP Cloud. Funciona en una instancia de AnythingMCP que ejecutes tú mismo en un ordenador o servidor con una conexión a internet normal de casa o de oficina.

Idealista + Claude

Busca anuncios inmobiliarios de Idealista (España, Italia, Portugal) desde cualquier asistente de IA. Encuentra pisos y casas en venta o alquiler, lee el detalle completo del anuncio, consulta datos de barrios. 4 herramientas, sin autenticación, obtenido mediante ingeniería inversa de la app móvil de Idealista.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

(none — public API)

Paso 1 — Obtener credenciales

This connector wraps the Idealista mobile app's internal API (app.idealista.it).

Setup: nothing. The mobile API endpoints used here do not require OAuth for read access.

Markets: Idealista operates in Italy, Spain, and Portugal. The locale path segment in URLs (/api/3.5/it/..., /api/3.5/es/..., /api/3.5/pt/...) selects the market. Pass locale as a tool parameter.

What it does NOT do: contact sellers, save searches, post listings. Use this connector to find and read listings; act on them in the Idealista app/site.

…(continued in the in-app connector instructions)

Paso 2 — Instalar el adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

1. Abre http://localhost:3000 y regístrate. La primera cuenta pasa a ser la administradora.
2. Abre la tienda de conectores (http://localhost:3000/connectors/store), elige Idealista, introduce las credenciales que pida (algunos conectores no necesitan ninguna) e instálalo.
3. En MCP Servers, crea un servidor y asígnale el conector Idealista. En la página del servidor, copia el MCP endpoint (http://localhost:4000/mcp/<server-id>) y genera una clave en API keys.

El quickstart solo escucha en localhost. Para una instancia a la que puedan llegar otras personas o clientes de IA en la nube, clona el repositorio y ejecuta ./setup.sh, que configura dominio, HTTPS y OAuth (guía de despliegue).

Paso 3 — Añade el connector Idealista a Claude

Claude llega a los servidores MCP de dos formas distintas, y solo una funciona con el quickstart en localhost.

Claude Code se ejecuta en tu ordenador, así que puede usar el endpoint local directamente:

claude mcp add --transport http idealista http://localhost:4000/mcp/<server-id> --header "X-API-Key: <your-api-key>"

Ejecuta claude mcp list para comprobar que se ha conectado.

Claude.ai y Claude Desktop añaden servidores remotos como conectores personalizados: ve a Customize → Connectors, pulsa + y elige Add custom connector (en los planes Team y Enterprise, primero lo añade un owner en Organization settings → Connectors). Claude abre esa conexión desde la nube de Anthropic, no desde tu ordenador, así que una URL localhost no funciona ahí. Necesitas una instancia de AnythingMCP con una dirección HTTPS pública (ver ./setup.sh arriba) en una conexión que Idealista acepte; pega el MCP endpoint de esa instancia e inicia sesión en AnythingMCP cuando Claude te lo pida.

Herramientas disponibles

FAQ

¿Por qué Idealista no está disponible en AnythingMCP Cloud? Idealista rechaza las peticiones desde direcciones IP de centros de datos. AnythingMCP Cloud funciona en un centro de datos, así que todas las llamadas fallarían. Con una instancia de AnythingMCP en una conexión de casa o de oficina normalmente funciona.

Siguientes pasos

• Página del conector
• Conectar a ChatGPT
• Conectar a Cursor
• Conectar a Gemini
• Conectar a Meta Muse