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.

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'.»

«Quanti crediti Pedra mi restano?»

Lavorare con le tue foto

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 i tuoi progetti, legge gli URL delle immagini e genera il video. Per importare una foto dal web, indica il suo URL e viene aggiunta a un progetto (il server la scarica). Per foto nuove sul tuo dispositivo, l'assistente ti dà un link per aprire il progetto in Pedra e trascinarle lì — la chat non può caricare file grandi direttamente.

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_projects, pedra_list_project_images, pedra_create_project, pedra_add_images_to_project — sfoglia la tua libreria e aggiungi foto perché qualsiasi strumento possa usarle.

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. Nota: un'immagine incollata nella chat non viene inviata allo strumento — trascina un file o indica il suo percorso. 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à.

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