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.

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

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

Trabaja con tus fotos

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 proyectos, lee las URLs de las imágenes y renderiza el vídeo. Para traer una foto de la web, indica su URL y se añade a un proyecto (el servidor la descarga). Para fotos nuevas de tu dispositivo, el asistente te da un enlace para abrir el proyecto en Pedra y soltarlas allí — el chat no puede subir archivos grandes directamente.

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_projects, pedra_list_project_images, pedra_create_project, pedra_add_images_to_project — explora tu biblioteca y añade fotos para que cualquier herramienta pueda usarlas.

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. Nota: una imagen pegada en el chat no se envía a la herramienta — arrastra un archivo o indica su ruta. 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.

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