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.

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

Añádelo a tu cliente

El servidor funciona sobre stdio y está publicado en npm, así que la mayoría de clientes lo lanzan con npx — sin instalación global. Define tu clave en la variable de entorno PEDRA_API_KEY dentro de la configuración.

{
  "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, además de pedra_credits y pedra_feedback — mira Vídeo y Créditos.

La mayoría de herramientas de imagen reciben un imageUrl — una URL pública o una URL data:; algunos clientes MCP también te permiten adjuntar una imagen directamente. Más algunos parámetros opcionales — tu cliente muestra el esquema de entrada de cada herramienta.

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.