Servidor MCP

Conecta Pedra a Claude, ChatGPT, Cursor y cualquier cliente MCP. El servidor oficial de Model Context Protocol expone una herramienta por cada endpoint de Pedra — home staging virtual, renovación, mejora de imágenes y vídeos para anuncios — como llamadas que esperan y devuelven la URL final del recurso.

Servidor MCP oficial

De código abierto, con licencia MIT y publicado en npm como @pedra-ai/mcp. Expone una herramienta por cada endpoint de la API; cada herramienta es una llamada que espera y devuelve la(s) URL(s) final(es) del recurso — sin IDs de trabajo que consultar. Por dentro es una capa fina sobre el SDK de Node de Pedra.

Úsalo en Claude (web, móvil y escritorio)

En Claude, abre Ajustes → Conectores → Añadir conector personalizado, pega la URL de arriba y pulsa Conectar — inicias sesión en Pedra una vez y autorizas el acceso. Sin copiar ninguna clave API. Funciona en Claude web, móvil y escritorio, y consume los créditos de tu cuenta.

En ChatGPT: Pedra es un plugin oficial de ChatGPT. Abre Plugins en la barra lateral de ChatGPT, busca Pedra y pulsa Install plugin. Mira cómo hacer un vídeo inmobiliario con ChatGPT o Claude.

Qué puedes hacer

Una vez conectado, pídeselo a tu asistente en lenguaje natural — elige la herramienta adecuada y devuelve la URL de la imagen o el vídeo terminado:

«Usa Pedra para hacer home staging virtual de https://example.com/empty-living-room.jpg como un salón minimalista.»

«Vacía este dormitorio amueblado para mostrar la habitación sin muebles: https://example.com/bedroom.jpg»

«Renueva esta cocina anticuada con un estilo escandinavo: https://example.com/kitchen.jpg»

«Añade una planta grande en la esquina de este salón: https://example.com/living.jpg»

«Ilumina y endereza la foto que acabo de adjuntar.»

«Cambia el cielo gris de esta foto exterior por un azul despejado: https://example.com/facade.jpg»

«Difumina las caras y matrículas de esta foto a pie de calle: https://example.com/street.jpg»

«Crea un vídeo para el anuncio con estas 8 fotos, con música y el texto '3 hab · 2 baños'.»

«Crea un tour virtual de Calle Mayor 12 con mis fotos 360° y dame el código para incrustarlo.»

«¿Cuántos créditos de Pedra me quedan?»

Fotos desde el chat

Las fotos que ya están en tu cuenta de Pedra son la fuente más fácil — solo pídelo, p. ej. «crea un vídeo con las fotos de mi anuncio de Calle Mayor», y el asistente lista tus propiedades, lee las URLs de las imágenes y renderiza el vídeo. Una foto de la web también sirve: da su URL y el servidor la descarga. Para las fotos que tienes contigo:

• ChatGPT: adjúntalas. Las fotos adjuntadas al chat llegan directamente a las herramientas. Adjunta una foto y di «amuebla este salón»: las nueve herramientas de una sola foto (pedra_furnish, pedra_enhance, pedra_empty_room y el resto) la reciben como imageFile en lugar de imageUrl, y pedra_add_images_to_property recibe varias como files.
• Claude, o fotos que siguen en tu móvil: un enlace de subida. Claude no pasa los adjuntos del chat a las herramientas, así que el asistente llama a pedra_create_upload_link y te da un enlace sin inicio de sesión, válido 24 horas. Ábrelo en el móvil (las HEIC del iPhone funcionan) o envíalo al fotógrafo, suelta las fotos y dile al asistente cuando termines. Entonces las lista con pedra_list_property_images y sigue — ediciones, pedra_create_video o pedra_create_virtual_tour. Por defecto el enlace acepta fotos normales y fotos 360° (type: "any"); mira create_upload_link.

Las fotos que entran desde fuera de la app cuentan para un límite diario de subidas (30 al día en el plan gratuito, 500 en los de pago).

¿Nuevo en Pedra?

No hace falta tener cuenta antes. Al conectar Pedra en ChatGPT o Claude se abre una pestaña de inicio de sesión de Pedra, y los usuarios nuevos pueden crear su cuenta ahí mismo. Otros agentes — Claude Code, scripts, el servidor MCP local — pueden conseguir una cuenta y una clave API para su usuario por email con agent_signup.

Otros clientes y configuración local (Cursor, scripts, config de Claude Desktop)

Para Claude, usa el conector alojado de arriba. Para Cursor, scripts locales o editar directamente el archivo de configuración de Claude Desktop, ejecuta el paquete npm sobre stdio — se lanza con npx (sin instalación global) y lee tu clave de la variable de entorno PEDRA_API_KEY.

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

En Claude Desktop, abre Ajustes → Desarrollador → Editar configuración y añade la entrada pedra. En Cursor, usa ~/.cursor/mcp.json (o .cursor/mcp.json en un proyecto). Reinicia el cliente tras guardar.

Autenticación

El servidor lee tu clave de PEDRA_API_KEY. Consigue una registrándote en app.pedra.ai y abriendo Ajustes → API. Mira Autenticación para más detalles.

Herramientas

Una herramienta por cada endpoint, todas devuelven URLs finales:

• pedra_furnish, pedra_empty_room, pedra_renovation, pedra_edit_via_prompt, pedra_remove_object — mira Home staging virtual.
• pedra_enhance, pedra_enhance_and_correct_perspective, pedra_sky_blue, pedra_blur — mira Mejora de imágenes.
• pedra_create_video, pedra_update_video, pedra_generate_voice_script, pedra_generate_voice, pedra_music_library, además de pedra_credits y pedra_feedback — mira Vídeo y Créditos.
• pedra_list_properties, pedra_list_property_images, pedra_create_property, pedra_add_images_to_property — explora tu biblioteca y añade fotos para que cualquier herramienta pueda usarlas.
• 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 y edita tours virtuales 360° alojados; mira Tours virtuales. Eliminar un tour solo es posible desde la API (/api/delete_virtual_tour), a propósito.
• pedra_social_accounts, pedra_social_post, pedra_social_list_posts, pedra_social_cancel_post: publica o programa un vídeo en Instagram, Facebook, TikTok y YouTube (Pedra Pro). De momento solo en el servidor remoto; el paquete npm aún no las tiene. Mira Redes sociales.

La mayoría de herramientas de imagen reciben un imageUrl — una URL pública, una URI data: o una ruta absoluta a un archivo local (se lee e incrusta automáticamente). Más algunos parámetros opcionales — tu cliente muestra el esquema de entrada de cada herramienta. En ChatGPT, una foto adjuntada llega a la herramienta como imageFile; en Claude, una imagen pegada en el chat no se envía a la herramienta — indica una ruta o usa un enlace de subida (mira Fotos desde el chat). Todas las herramientas de imagen y vídeo también aceptan un propertyId opcional: indícalo y el resultado se guarda en la galería de esa propiedad — visible y editable desde la app — en lugar de devolverse solo como una URL. Mira Propiedades.

Crea un tour virtual desde el chat

Las fotos 360° suelen estar en un móvil o una cámara 360°, y un chat no puede pasar archivos grandes a una herramienta. Así que el asistente te da un enlace de subida — pide algo como «Crea un tour virtual de Calle Mayor 12 con mis fotos 360°» y hace lo siguiente:

1. pedra_create_upload_link — recibes un enlace sin inicio de sesión, válido 24 horas. Ábrelo en el móvil (o envíalo al fotógrafo) y suelta las fotos.
2. pedra_create_virtual_tour con ese propertyId — cuando dices que has terminado, crea el tour con todas las fotos subidas, por orden de nombre de archivo.
3. pedra_get_virtual_tour — la creación del tour es el único flujo asíncrono, así que el asistente consulta hasta que el tour está ready (unos 10 segundos por habitación).
4. Comparte el tourUrl y el iframe embedCode. Pide cambios con tus palabras — «cambia el segundo dormitorio a Despacho», «que el tour empiece en el salón» — y llama a pedra_update_virtual_tour.

Si las fotos 360° ya están online, sáltate el enlace de subida: da las URLs y el asistente las pasa directamente a pedra_create_virtual_tour como scenes.

Cómo funciona

Una capa fina sobre el SDK de Node de Pedra. Cada endpoint espera y devuelve la(s) URL(s) final(es) en la respuesta — incluso pedra_create_video, que puede tardar hasta ~10 minutos (la API mantiene viva la conexión con un heartbeat). Los errores de la API — créditos insuficientes, una imagen incorrecta — vuelven como errores de herramienta MCP legibles, no como caídas.

Código y soporte

El servidor tiene licencia MIT y se desarrolla en abierto en github.com/pedra-ai/pedra-mcp. Conoce más sobre el protocolo en modelcontextprotocol.io, y escribe a felix@pedra.ai para ayuda con la integración, mayores cuotas o condiciones enterprise.

Preguntas frecuentes