Server MCP

Collega Pedra a Claude, ChatGPT, Cursor e qualsiasi client MCP. Il server ufficiale Model Context Protocol espone uno strumento per ogni endpoint Pedra — home staging virtuale, rinnovazione, miglioramento immagini e video per annunci — come chiamate che attendono e restituiscono l'URL finale della risorsa.

Server MCP ufficiale

Open source, con licenza MIT e pubblicato su npm come @pedra-ai/mcp. Espone uno strumento per ogni endpoint dell'API; ogni strumento è una singola chiamata che attende e restituisce l'URL (o gli URL) finale della risorsa — senza ID di lavoro da interrogare. Internamente è un sottile wrapper sopra l'SDK Node di Pedra.

Usalo in Claude (web, mobile e desktop)

In Claude apri Impostazioni → Connettori → Aggiungi connettore personalizzato, incolla l'URL sopra e clicca Connetti — accedi a Pedra una volta e autorizzi l'accesso. Nessuna chiave API da copiare. Funziona in Claude su web, mobile e desktop e usa i crediti del tuo account.

In ChatGPT: Pedra è un plugin ufficiale di ChatGPT. Apri Plugins nella barra laterale di ChatGPT, cerca Pedra e clicca Install plugin. Vedi come creare un video immobiliare con ChatGPT o Claude.

Cosa puoi fare

Una volta connesso, chiedi al tuo assistente in linguaggio naturale — sceglie lo strumento giusto e restituisce l'URL dell'immagine o del video finito:

«Usa Pedra per fare home staging virtuale di https://example.com/empty-living-room.jpg come soggiorno minimalista.»

«Svuota questa camera arredata per mostrare la stanza vuota: https://example.com/bedroom.jpg»

«Rinnova questa cucina datata in stile scandinavo: https://example.com/kitchen.jpg»

«Aggiungi una grande pianta verde nell'angolo di questo soggiorno: https://example.com/living.jpg»

«Schiarisci e raddrizza la foto che ho appena allegato.»

«Sostituisci il cielo grigio di questa foto esterna con un azzurro limpido: https://example.com/facade.jpg»

«Sfoca volti e targhe in questa foto fronte strada: https://example.com/street.jpg»

«Crea un video per l'annuncio con queste 8 foto, con musica e la didascalia '3 camere · 2 bagni'.»

«Crea un tour virtuale di Calle Mayor 12 con le mie foto 360° e dammi il codice da incorporare.»

«Quanti crediti Pedra mi restano?»

Foto dalla chat

Le foto già nel tuo account Pedra sono la fonte più semplice — basta chiedere, ad es. «crea un video con le foto del mio annuncio di Calle Mayor», e l'assistente elenca le tue proprietà, legge gli URL delle immagini e genera il video. Va bene anche una foto sul web: indica il suo URL e il server la scarica. Per le foto che hai con te:

• ChatGPT: allegale. Le foto allegate alla chat arrivano direttamente agli strumenti. Allega una foto e scrivi «arreda questo soggiorno»: i nove strumenti a foto singola (pedra_furnish, pedra_enhance, pedra_empty_room e gli altri) la ricevono come imageFile invece di imageUrl, e pedra_add_images_to_property ne riceve diverse come files.
• Claude, o foto ancora sul telefono: un link di caricamento. Claude non passa gli allegati della chat agli strumenti, quindi l'assistente chiama pedra_create_upload_link e ti dà un link senza login, valido 24 ore. Aprilo sullo smartphone (le HEIC dell'iPhone funzionano) o invialo al fotografo, carica le foto e avvisa l'assistente quando hai finito. Lui le elenca con pedra_list_property_images e prosegue — modifiche, pedra_create_video o pedra_create_virtual_tour. Di default il link accetta foto normali e foto 360° (type: "any"); vedi create_upload_link.

Le foto che arrivano da fuori dall'app contano in un limite giornaliero di caricamento (30 al giorno sul piano gratuito, 500 sui piani a pagamento).

Nuovo su Pedra?

Non serve un account prima. Collegando Pedra in ChatGPT o Claude si apre una scheda di accesso a Pedra, e i nuovi utenti possono creare l'account lì stesso. Gli altri agenti — Claude Code, script, il server MCP locale — possono ottenere un account e una chiave API per il loro utente via email con agent_signup.

Altri client e configurazione locale (Cursor, script, config di Claude Desktop)

Per Claude, preferisci il connettore ospitato qui sopra. Per Cursor, script locali o per modificare direttamente il file di config di Claude Desktop, esegui il pacchetto npm su stdio — si avvia con npx (senza installazione globale) e legge la tua chiave dalla variabile d'ambiente PEDRA_API_KEY.

{
  "mcpServers": {
    "pedra": {
      "command": "npx",
      "args": ["-y", "@pedra-ai/mcp"],
      "env": { "PEDRA_API_KEY": "your-api-key" }
    }
  }
}

In Claude Desktop apri Impostazioni → Sviluppatore → Modifica config e aggiungi la voce pedra. In Cursor usa ~/.cursor/mcp.json (o .cursor/mcp.json in un progetto). Riavvia il client dopo aver salvato.

Autenticazione

Il server legge la tua chiave da PEDRA_API_KEY. Ottienine una registrandoti su app.pedra.ai e aprendo Impostazioni → API. Vedi Autenticazione per i dettagli.

Strumenti

Uno strumento per ogni endpoint, tutti restituiscono URL finali:

• pedra_furnish, pedra_empty_room, pedra_renovation, pedra_edit_via_prompt, pedra_remove_object — vedi Home staging virtuale.
• pedra_enhance, pedra_enhance_and_correct_perspective, pedra_sky_blue, pedra_blur — vedi Miglioramento immagini.
• pedra_create_video, pedra_update_video, pedra_generate_voice_script, pedra_generate_voice, pedra_music_library, oltre a pedra_credits e pedra_feedback — vedi Video e Crediti.
• pedra_list_properties, pedra_list_property_images, pedra_create_property, pedra_add_images_to_property — sfoglia la tua libreria e aggiungi foto perché qualsiasi strumento possa usarle.
• pedra_create_upload_link, pedra_create_virtual_tour, pedra_get_virtual_tour, pedra_list_virtual_tours, pedra_update_virtual_tour, pedra_add_virtual_tour_scenes — crea e modifica tour virtuali 360° ospitati; vedi Tour virtuali. L'eliminazione di un tour è volutamente solo via API (/api/delete_virtual_tour).
• pedra_social_accounts, pedra_social_post, pedra_social_list_posts, pedra_social_cancel_post: pubblica o programma un video su Instagram, Facebook, TikTok e YouTube (Pedra Pro). Per ora solo sul server remoto; il pacchetto npm non li ha ancora. Vedi Social.

La maggior parte degli strumenti immagine accetta un imageUrl — un URL pubblico, un URI data: o un percorso assoluto a un file locale (letto e incorporato per te). Più alcuni parametri opzionali — il tuo client mostra lo schema di input di ogni strumento. In ChatGPT una foto allegata arriva allo strumento come imageFile; in Claude un'immagine incollata nella chat non viene inviata allo strumento — indica un percorso o usa un link di caricamento (vedi Foto dalla chat). Tutti gli strumenti immagine e video accettano anche una propertyId opzionale: indicala e il risultato viene salvato nella galleria di quella proprietà — visibile e modificabile dall'app — invece di essere restituito solo come URL. Vedi Proprietà.

Crea un tour virtuale dalla chat

Le foto 360° di solito sono su uno smartphone o una fotocamera 360°, e una chat non può passare file grandi a uno strumento. Così l'assistente ti dà un link di caricamento — chiedi ad esempio «Crea un tour virtuale di Calle Mayor 12 con le mie foto 360°» e procede così:

1. pedra_create_upload_link — ricevi un link senza login, valido 24 ore. Aprilo sullo smartphone (o invialo al fotografo) e trascina le foto.
2. pedra_create_virtual_tour con quel propertyId — quando dici di aver finito, crea il tour con tutte le foto caricate, in ordine di nome file.
3. pedra_get_virtual_tour — la costruzione è l'unico flusso asincrono, quindi l'assistente ricontrolla finché il tour non è ready (circa 10 secondi per stanza).
4. Condivide il tourUrl e l'iframe embedCode. Chiedi modifiche a parole tue — «rinomina la seconda camera in Studio», «fai partire il tour dal soggiorno» — e chiama pedra_update_virtual_tour.

Se le foto 360° sono già online, salta il link di caricamento: fornisci gli URL e l'assistente li passa direttamente a pedra_create_virtual_tour come scenes.

Come funziona

Un sottile wrapper sopra l'SDK Node di Pedra. Ogni endpoint attende e restituisce l'URL (o gli URL) finale nella risposta — anche pedra_create_video, che può richiedere fino a ~10 minuti (l'API mantiene viva la connessione con un heartbeat). Gli errori dell'API — crediti insufficienti, un'immagine non valida — tornano come errori di strumento MCP leggibili, non come crash.

Codice & supporto

Il server ha licenza MIT ed è sviluppato in modo aperto su github.com/pedra-ai/pedra-mcp. Scopri di più sul protocollo su modelcontextprotocol.io e scrivi a felix@pedra.ai per aiuto con l'integrazione, quote più alte o condizioni enterprise.

Domande frequenti