MCP-Server

Verbinden Sie Pedra mit Claude, ChatGPT, Cursor und jedem MCP-Client. Der offizielle Model-Context-Protocol-Server stellt pro Pedra-Endpunkt ein Tool bereit — virtuelles Home Staging, Renovierung, Bildverbesserung und Anzeigenvideos — als blockierende Aufrufe, die die finale Asset-URL zurückgeben.

Offizieller MCP-Server

Quelloffen, MIT-lizenziert und auf npm als @pedra-ai/mcp veröffentlicht. Er stellt ein Tool pro API-Endpunkt bereit; jedes Tool ist ein einzelner blockierender Aufruf, der die finale(n) Asset-URL(s) zurückgibt — keine Job-IDs zum Abfragen. Intern ist es eine dünne Schicht über dem Pedra-Node-SDK.

In Claude nutzen (Web, Mobil & Desktop)

Öffnen Sie in Claude Einstellungen → Connectors → Benutzerdefinierten Connector hinzufügen, fügen Sie die obige URL ein und klicken Sie auf Verbinden — Sie melden sich einmal bei Pedra an und genehmigen den Zugriff. Kein API-Schlüssel zum Kopieren. Funktioniert in Claude im Web, mobil und auf dem Desktop und nutzt die Credits Ihres Kontos.

In ChatGPT: Pedra ist ein offizielles ChatGPT-Plugin. Öffnen Sie Plugins in der Seitenleiste von ChatGPT, suchen Sie nach Pedra und klicken Sie auf Install plugin. Siehe Immobilienvideo mit ChatGPT oder Claude erstellen.

Was Sie tun können

Nach dem Verbinden fragen Sie Ihren Assistenten in natürlicher Sprache — er wählt das richtige Tool und gibt die URL des fertigen Bildes oder Videos zurück:

„Nutze Pedra, um https://example.com/empty-living-room.jpg als minimalistisches Wohnzimmer virtuell zu stagen."

„Leere dieses möblierte Schlafzimmer, um den leeren Raum zu zeigen: https://example.com/bedroom.jpg"

„Renoviere diese veraltete Küche im skandinavischen Stil: https://example.com/kitchen.jpg"

„Füge eine große Grünpflanze in die Ecke dieses Wohnzimmers ein: https://example.com/living.jpg"

„Helle das soeben angehängte Foto auf und richte es gerade aus."

„Ersetze den grauen Himmel in dieser Außenaufnahme durch klares Blau: https://example.com/facade.jpg"

„Verwische die Gesichter und Kennzeichen in dieser Straßenansicht: https://example.com/street.jpg"

„Erstelle ein Anzeigenvideo aus diesen 8 Fotos, mit Musik und der Bildunterschrift '3 Zi · 2 Bäder'."

„Erstelle einen virtuellen Rundgang für Calle Mayor 12 aus meinen 360°-Fotos und gib mir den Einbettungscode."

„Wie viele Pedra-Credits habe ich noch?"

Fotos aus dem Chat

Fotos, die bereits in Ihrem Pedra-Konto sind, sind die einfachste Quelle — fragen Sie einfach, z. B. „erstelle ein Video aus den Fotos meines Calle-Mayor-Inserats", und der Assistent listet Ihre Immobilien auf, liest deren Bild-URLs und rendert das Video. Ein Foto im Web geht auch: Geben Sie die URL an, und der Server lädt es. Für Fotos, die Sie bei sich haben:

• ChatGPT: anhängen. Im Chat angehängte Fotos gehen direkt an die Tools. Hängen Sie ein Foto an und sagen Sie „richte dieses Wohnzimmer ein": Die neun Einzelfoto-Tools (pedra_furnish, pedra_enhance, pedra_empty_room und die übrigen) nehmen es als imageFile statt imageUrl, und pedra_add_images_to_property nimmt mehrere als files.
• Claude oder Fotos, die noch auf dem Handy sind: ein Upload-Link. Claude gibt Chat-Anhänge nicht an Tools weiter, also ruft der Assistent pedra_create_upload_link auf und gibt Ihnen einen Link ohne Login, 24 Stunden gültig. Öffnen Sie ihn am Handy (HEIC vom iPhone funktioniert) oder schicken Sie ihn dem Fotografen, ziehen Sie die Fotos hinein und sagen Sie dem Assistenten, wenn Sie fertig sind. Er listet sie dann mit pedra_list_property_images und macht weiter — Bearbeitungen, pedra_create_video oder pedra_create_virtual_tour. Standardmäßig nimmt der Link normale und 360°-Fotos an (type: "any"); siehe create_upload_link.

Fotos, die von außerhalb der App kommen, zählen zu einem täglichen Upload-Limit (30 pro Tag im Free-Tarif, 500 in bezahlten Tarifen).

Neu bei Pedra?

Vorher ist kein Konto nötig. Wer Pedra in ChatGPT oder Claude verbindet, bekommt einen Pedra-Anmelde-Tab, und neue Nutzer können ihr Konto direkt dort anlegen. Andere Agenten — Claude Code, Skripte, der lokale MCP-Server — können per E-Mail mit agent_signup ein Konto und einen API-Schlüssel für ihren Nutzer bekommen.

Andere Clients & lokale Einrichtung (Cursor, Skripte, Claude-Desktop-Config)

Für Claude empfiehlt sich der gehostete Connector oben. Für Cursor, lokale Skripte oder das direkte Bearbeiten der Claude-Desktop-Config führen Sie das npm-Paket über stdio aus — es startet mit npx (keine globale Installation) und liest Ihren Schlüssel aus der Umgebungsvariable PEDRA_API_KEY.

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

Öffnen Sie in Claude Desktop Einstellungen → Entwickler → Konfiguration bearbeiten und fügen Sie den pedra-Eintrag hinzu. In Cursor verwenden Sie ~/.cursor/mcp.json (oder .cursor/mcp.json im Projekt). Starten Sie den Client nach dem Speichern neu.

Authentifizierung

Der Server liest Ihren Schlüssel aus PEDRA_API_KEY. Holen Sie sich einen, indem Sie sich auf app.pedra.ai registrieren und Einstellungen → API öffnen. Siehe Authentifizierung für Details.

Tools

Ein Tool pro Endpunkt, alle geben finale URLs zurück:

• pedra_furnish, pedra_empty_room, pedra_renovation, pedra_edit_via_prompt, pedra_remove_object — siehe Virtuelles Home Staging.
• pedra_enhance, pedra_enhance_and_correct_perspective, pedra_sky_blue, pedra_blur — siehe Bildverbesserung.
• pedra_create_video, pedra_update_video, pedra_generate_voice_script, pedra_generate_voice, pedra_music_library sowie pedra_credits und pedra_feedback — siehe Video und Credits.
• pedra_list_properties, pedra_list_property_images, pedra_create_property, pedra_add_images_to_property — durchsuchen Sie Ihre Bibliothek und fügen Sie Fotos hinzu, damit jedes Tool sie nutzen kann.
• 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 — gehostete virtuelle 360°-Rundgänge erstellen und bearbeiten; siehe Virtuelle Rundgänge. Löschen geht bewusst nur über die API (/api/delete_virtual_tour).
• pedra_social_accounts, pedra_social_post, pedra_social_list_posts, pedra_social_cancel_post: ein Video auf Instagram, Facebook, TikTok und YouTube posten oder planen (Pedra Pro). Vorerst nur im Remote-Server; das npm-Paket hat sie noch nicht. Siehe Social Media.

Die meisten Bild-Tools nehmen ein imageUrl — eine öffentliche URL, eine data:-URI oder einen absoluten Pfad zu einer lokalen Datei (wird für Sie gelesen und eingebettet). Plus einige optionale Parameter — Ihr Client zeigt das Eingabeschema jedes Tools. In ChatGPT geht ein angehängtes Foto als imageFile an das Tool; in Claude wird ein in den Chat eingefügtes Bild nicht an das Tool gesendet — geben Sie einen Pfad an oder nutzen Sie einen Upload-Link (siehe Fotos aus dem Chat). Alle Bild- und Video-Tools akzeptieren außerdem eine optionale propertyId: geben Sie sie an, und das Ergebnis wird in der Galerie dieser Immobilie gespeichert — sichtbar und in der App bearbeitbar — statt nur als URL zurückzukommen. Siehe Immobilien.

Einen virtuellen Rundgang aus dem Chat erstellen

Die 360°-Fotos liegen meist auf einem Handy oder einer 360°-Kamera, und ein Chat kann keine großen Dateien an ein Tool übergeben. Deshalb gibt Ihnen der Assistent einen Upload-Link — fragen Sie etwa „Erstelle einen virtuellen Rundgang für Calle Mayor 12 aus meinen 360°-Fotos", und er geht so vor:

1. pedra_create_upload_link — Sie erhalten einen Link ohne Login, 24 Stunden gültig. Öffnen Sie ihn am Handy (oder schicken Sie ihn dem Fotografen) und ziehen Sie die Fotos hinein.
2. pedra_create_virtual_tour mit dieser propertyId — sobald Sie fertig sind, baut er den Rundgang aus allen hochgeladenen Fotos, in Dateinamen-Reihenfolge.
3. pedra_get_virtual_tour — der Aufbau ist der einzige asynchrone Ablauf, also fragt der Assistent nach, bis der Rundgang ready ist (etwa 10 Sekunden pro Raum).
4. Er teilt die tourUrl und den embedCode-iframe. Wünschen Sie Änderungen in eigenen Worten — „benenne das zweite Schlafzimmer in Büro um", „starte den Rundgang im Wohnzimmer" — und er ruft pedra_update_virtual_tour auf.

Sind die 360°-Fotos schon online, entfällt der Upload-Link: Geben Sie die URLs an, und der Assistent übergibt sie direkt als scenes an pedra_create_virtual_tour.

Wie es funktioniert

Eine dünne Schicht über dem Pedra-Node-SDK. Jeder Endpunkt blockiert und gibt die finale(n) URL(s) inline zurück — selbst pedra_create_video, das bis zu ~10 Minuten dauern kann (die API hält die Verbindung mit einem Heartbeat aufrecht). API-Fehler — unzureichende Credits, ein fehlerhaftes Bild — kommen als lesbare MCP-Tool-Fehler zurück, nicht als Abstürze.

Quellcode & Support

Der Server ist MIT-lizenziert und wird offen unter github.com/pedra-ai/pedra-mcp entwickelt. Mehr zum Protokoll unter modelcontextprotocol.io, und schreiben Sie an felix@pedra.ai für Integrationshilfe, höhere Quoten oder Enterprise-Bedingungen.

Häufige Fragen