Come collegare Idealista a Cursor — via MCP

Solo self-hosted. Idealista rifiuta le richieste provenienti da indirizzi IP di data center e AnythingMCP Cloud gira in un data center, quindi questo connettore non è disponibile su AnythingMCP Cloud. Funziona su un'istanza di AnythingMCP che gestisci tu, su un computer o un server con una normale connessione internet di casa o dell'ufficio.

Idealista + Cursor

Cerca annunci immobiliari su Idealista (Spagna, Italia, Portogallo) da qualsiasi assistente AI. Trova appartamenti e case in vendita o in affitto, leggi i dettagli completi degli annunci, consulta i dati del quartiere. 4 strumenti, nessuna autenticazione: ricavato tramite reverse engineering dall'app mobile di Idealista.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

(none — public API)

Step 1 — Ottieni le credenziali

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)

Step 2 — Installa l'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. Apri http://localhost:3000 e registrati. Il primo account diventa amministratore.
2. Apri lo store dei connettori (http://localhost:3000/connectors/store), scegli Idealista, inserisci le credenziali richieste (alcuni connettori non ne hanno bisogno) e installalo.
3. In MCP Servers crea un server e assegnagli il connettore Idealista. Nella pagina del server copia l'MCP endpoint (http://localhost:4000/mcp/<server-id>) e genera una chiave in API keys.

Il quickstart ascolta solo su localhost. Per un'istanza raggiungibile da altre persone o da client AI nel cloud, clona il repository ed esegui ./setup.sh, che configura dominio, HTTPS e OAuth (guida al deployment).

Step 3 — Aggiungi il connettore in Cursor

Cursor gira sul tuo computer, quindi può usare l'endpoint locale. Aggiungi il server a ~/.cursor/mcp.json (tutti i progetti) o a .cursor/mcp.json (un solo progetto):

{
  "mcpServers": {
    "idealista": {
      "url": "http://localhost:4000/mcp/<server-id>",
      "headers": { "X-API-Key": "<your-api-key>" }
    }
  }
}

Poi controlla nelle impostazioni MCP di Cursor che il server sia attivo e che i suoi tool siano elencati.

Tool disponibili

FAQ

Cursor supporta MCP server personalizzati nel piano free? Sì — MCP è disponibile su Hobby, Pro e Business.

Perché Idealista non è disponibile su AnythingMCP Cloud? Idealista rifiuta le richieste da indirizzi IP di data center. AnythingMCP Cloud gira in un data center, quindi ogni chiamata fallirebbe. Con un'istanza di AnythingMCP su una connessione di casa o dell'ufficio di solito funziona.

Prossimi passi

• Pagina del connettore
• Collega a Claude
• Collega a ChatGPT
• Collega a Gemini
• Collega a Meta Muse