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.

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?»

Aggiungilo al tuo client

Il server funziona su stdio ed è pubblicato su npm, quindi la maggior parte dei client lo avvia con npx — senza installazione globale. Imposta la tua chiave nella variabile d'ambiente PEDRA_API_KEY nella configurazione.

{
  "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, oltre a pedra_credits e pedra_feedback — vedi Video e Crediti.

La maggior parte degli strumenti immagine accetta un imageUrl — un URL pubblico o un URL data:; alcuni client MCP permettono anche di allegare un'immagine direttamente. Più alcuni parametri opzionali — il tuo client mostra lo schema di input di ogni strumento.

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.