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.

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

„Wie viele Pedra-Credits habe ich noch?"

Mit Ihren Fotos arbeiten

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 Projekte auf, liest deren Bild-URLs und rendert das Video. Um ein Foto aus dem Web zu holen, geben Sie dessen URL an, und es wird einem Projekt hinzugefügt (der Server lädt es). Für brandneue Fotos auf Ihrem Gerät gibt Ihnen der Assistent einen Link, um das Projekt in Pedra zu öffnen und sie dort abzulegen — der Chat kann keine großen Dateien direkt hochladen.

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_projects, pedra_list_project_images, pedra_create_project, pedra_add_images_to_project — durchsuchen Sie Ihre Bibliothek und fügen Sie Fotos hinzu, damit jedes Tool sie nutzen kann.

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. Hinweis: Ein in den Chat eingefügtes Bild wird nicht an das Tool gesendet — ziehen Sie eine Datei hinein oder geben Sie ihren Pfad an. 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.

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