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.

Dans ChatGPT : Pedra est un plugin officiel de ChatGPT. Ouvrez Plugins dans la barre latérale de ChatGPT, cherchez Pedra et cliquez sur Install plugin. Voir comment faire une vidéo immobilière avec ChatGPT ou Claude.

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

« Crée une visite virtuelle de Calle Mayor 12 avec mes photos 360° et donne-moi le code d'intégration. »

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

Photos depuis le chat

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 propriétés, lit les URL des images et génère la vidéo. Une photo sur le web fonctionne aussi : donnez son URL et le serveur la télécharge. Pour les photos que vous avez sous la main :

• ChatGPT : joignez-les. Les photos jointes au chat vont directement aux outils. Joignez une photo et dites « meuble ce salon » : les neuf outils à une photo (pedra_furnish, pedra_enhance, pedra_empty_room et les autres) la reçoivent en imageFile au lieu de imageUrl, et pedra_add_images_to_property en reçoit plusieurs en files.
• Claude, ou des photos encore sur votre téléphone : un lien de téléversement. Claude ne transmet pas les pièces jointes du chat aux outils, donc l'assistant appelle pedra_create_upload_link et vous donne un lien sans connexion, valable 24 heures. Ouvrez-le sur votre téléphone (les HEIC d'iPhone fonctionnent) ou envoyez-le au photographe, déposez les photos et prévenez l'assistant quand c'est fini. Il les liste alors avec pedra_list_property_images et continue — retouches, pedra_create_video ou pedra_create_virtual_tour. Par défaut le lien accepte les photos classiques et les photos 360° (type: "any") ; voir create_upload_link.

Les photos importées de l'extérieur de l'app comptent dans une limite quotidienne de téléversement (30 par jour sur le plan gratuit, 500 sur les plans payants).

Nouveau sur Pedra ?

Pas besoin de compte au préalable. Connecter Pedra dans ChatGPT ou Claude ouvre un onglet de connexion Pedra, et les nouveaux utilisateurs peuvent y créer leur compte directement. Les autres agents — Claude Code, scripts, le serveur MCP local — peuvent obtenir un compte et une clé API pour leur utilisateur par e-mail avec agent_signup.

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_properties, pedra_list_property_images, pedra_create_property, pedra_add_images_to_property — parcourez votre bibliothèque et ajoutez des photos pour que n'importe quel outil puisse les utiliser.
• 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 — créez et modifiez des visites virtuelles 360° hébergées ; voir Visites virtuelles. La suppression d'une visite est réservée à l'API (/api/delete_virtual_tour), volontairement.
• pedra_social_accounts, pedra_social_post, pedra_social_list_posts, pedra_social_cancel_post : publiez ou programmez une vidéo sur Instagram, Facebook, TikTok et YouTube (Pedra Pro). Pour l'instant sur le serveur distant uniquement ; le paquet npm ne les a pas encore. Voir Réseaux sociaux.

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. Dans ChatGPT, une photo jointe arrive à l'outil en imageFile ; dans Claude, une image collée dans le chat n'est pas envoyée à l'outil — indiquez un chemin ou utilisez un lien de téléversement (voir Photos depuis le chat). 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.

Créer une visite virtuelle depuis le chat

Les photos 360° sont généralement sur un téléphone ou une caméra 360°, et un chat ne peut pas transmettre de gros fichiers à un outil. L'assistant vous donne donc un lien de téléversement — demandez par exemple « Crée une visite virtuelle de Calle Mayor 12 avec mes photos 360° » et il enchaîne :

1. pedra_create_upload_link — vous recevez un lien sans connexion, valable 24 heures. Ouvrez-le sur votre téléphone (ou envoyez-le au photographe) et déposez les photos.
2. pedra_create_virtual_tour avec ce propertyId — quand vous dites avoir fini, il crée la visite avec toutes les photos envoyées, par ordre de nom de fichier.
3. pedra_get_virtual_tour — la construction est le seul flux asynchrone, donc l'assistant vérifie jusqu'à ce que la visite soit ready (environ 10 secondes par pièce).
4. Il partage le tourUrl et l'iframe embedCode. Demandez des changements avec vos mots — « renomme la deuxième chambre en Bureau », « fais commencer la visite dans le salon » — et il appelle pedra_update_virtual_tour.

Si les photos 360° sont déjà en ligne, pas besoin du lien de téléversement : donnez les URL et l'assistant les passe directement à pedra_create_virtual_tour en scenes.

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