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.

Utilisez-le dans Claude (web, mobile et bureau)

Dans Claude, ouvrez Paramètres → Connecteurs → Ajouter un connecteur personnalisé, collez l'URL ci-dessus et cliquez sur Connecter — vous vous connectez à Pedra une fois et autorisez l'accès. Aucune clé API à copier. Cela fonctionne dans Claude sur web, mobile et bureau, et utilise les crédits de votre compte.

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

Travailler avec vos photos

Les photos déjà dans votre compte Pedra sont la source la plus simple — demandez simplement, par ex. « crée une vidéo à partir des photos de mon annonce Calle Mayor », et l'assistant liste vos projets, lit les URL des images et génère la vidéo. Pour récupérer une photo du web, indiquez son URL et elle est ajoutée à un projet (le serveur la télécharge). Pour des photos toutes neuves sur votre appareil, l'assistant vous donne un lien pour ouvrir le projet dans Pedra et les y déposer — le chat ne peut pas téléverser de gros fichiers directement.

Autres clients et configuration locale (Cursor, scripts, config Claude Desktop)

Pour Claude, préférez le connecteur hébergé ci-dessus. Pour Cursor, des scripts locaux ou la modification directe du fichier de config de Claude Desktop, exécutez le paquet npm via stdio — il se lance avec npx (sans installation globale) et lit votre clé depuis la variable d'environnement PEDRA_API_KEY.

{
  "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, pedra_update_video, pedra_generate_voice_script, pedra_generate_voice, pedra_music_library, ainsi que pedra_credits et pedra_feedback — voir Vidéo et Crédits.
• pedra_list_projects, pedra_list_project_images, pedra_create_project, pedra_add_images_to_project — parcourez votre bibliothèque et ajoutez des photos pour que n'importe quel outil puisse les utiliser.

La plupart des outils d'image prennent un imageUrl — une URL publique, une URI data: ou un chemin absolu vers un fichier local (lu et intégré pour vous). Plus quelques paramètres optionnels — votre client affiche le schéma d'entrée de chaque outil. Remarque : une image collée dans le chat n'est pas envoyée à l'outil — glissez un fichier ou indiquez son chemin. Tous les outils d'image et de vidéo acceptent aussi un propertyId optionnel : indiquez-le et le résultat est enregistré dans la galerie de cette propriété — visible et modifiable depuis l'app — au lieu d'être seulement renvoyé sous forme d'URL. Voir Propriétés.

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.

Questions fréquentes