Serveur MCP

Connectez Pedra à Claude, ChatGPT, Cursor et tout client MCP. Le serveur officiel Model Context Protocol expose un outil par endpoint Pedra — home staging virtuel, rénovation, amélioration d'images et vidéos d'annonces — sous forme d'appels bloquants qui renvoient l'URL finale du rendu.

Serveur MCP officiel

Open source, sous licence MIT et publié sur npm sous @pedra-ai/mcp. Il expose un outil par endpoint de l'API ; chaque outil est un appel bloquant qui renvoie la ou les URL finales du rendu — aucun ID de tâche à interroger. En interne, c'est une fine couche au-dessus du SDK Node de Pedra.

Ce que vous pouvez faire

Une fois connecté, demandez à votre assistant en langage naturel — il choisit le bon outil et renvoie l'URL de l'image ou de la vidéo finale :

« Utilise Pedra pour faire le home staging virtuel de https://example.com/empty-living-room.jpg en salon minimaliste. »

« Vide cette chambre meublée pour montrer la pièce nue : https://example.com/bedroom.jpg »

« Rénove cette cuisine vieillotte dans un style scandinave : https://example.com/kitchen.jpg »

« Ajoute une grande plante verte dans le coin de ce salon : https://example.com/living.jpg »

« Éclaircis et redresse la photo que je viens de joindre. »

« Remplace le ciel gris de cette photo extérieure par un bleu clair : https://example.com/facade.jpg »

« Floute les visages et les plaques d'immatriculation sur cette photo côté rue : https://example.com/street.jpg »

« Crée une vidéo d'annonce à partir de ces 8 photos, avec musique et la légende '3 ch · 2 sdb'. »

« Combien de crédits Pedra me reste-t-il ? »

Ajoutez-le à votre client

Le serveur fonctionne via stdio et est publié sur npm, donc la plupart des clients le lancent avec npx — sans installation globale. Définissez votre clé dans la variable d'environnement PEDRA_API_KEY dans la configuration.

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

Dans Claude Desktop, ouvrez Paramètres → Développeur → Modifier la config et ajoutez l'entrée pedra. Dans Cursor, utilisez ~/.cursor/mcp.json (ou .cursor/mcp.json dans un projet). Redémarrez le client après l'enregistrement.

Authentification

Le serveur lit votre clé depuis PEDRA_API_KEY. Obtenez-en une en vous inscrivant sur app.pedra.ai et en ouvrant Paramètres → API. Voir Authentification pour les détails.

Outils

Un outil par endpoint, renvoyant tous des URL finales :

• pedra_furnish, pedra_empty_room, pedra_renovation, pedra_edit_via_prompt, pedra_remove_object — voir Home staging virtuel.
• pedra_enhance, pedra_enhance_and_correct_perspective, pedra_sky_blue, pedra_blur — voir Amélioration d'images.
• pedra_create_video, ainsi que pedra_credits et pedra_feedback — voir Vidéo et Crédits.

La plupart des outils d'image prennent un imageUrl — une URL publique ou une URL data: ; certains clients MCP permettent aussi de joindre une image directement. Plus quelques paramètres optionnels — votre client affiche le schéma d'entrée de chaque outil.

Comment ça marche

Une fine couche au-dessus du SDK Node de Pedra. Chaque endpoint bloque et renvoie la ou les URL finales dans la réponse — même pedra_create_video, qui peut prendre jusqu'à ~10 minutes (l'API maintient la connexion active avec un heartbeat). Les erreurs de l'API — crédits insuffisants, image incorrecte — reviennent sous forme d'erreurs d'outil MCP lisibles, pas de plantages.

Code source & support

Le serveur est sous licence MIT et développé ouvertement sur github.com/pedra-ai/pedra-mcp. En savoir plus sur le protocole sur modelcontextprotocol.io, et écrivez à felix@pedra.ai pour de l'aide d'intégration, des quotas plus élevés ou des conditions enterprise.