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.

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

Zu Ihrem Client hinzufügen

Der Server läuft über stdio und ist auf npm veröffentlicht, daher starten ihn die meisten Clients mit npx — ohne globale Installation. Setzen Sie Ihren Schlüssel in der Umgebungsvariable PEDRA_API_KEY in der Konfiguration.

{
  "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 sowie pedra_credits und pedra_feedback — siehe Video und Credits.

Die meisten Bild-Tools nehmen ein imageUrl — eine öffentliche URL oder eine data:-URL; einige MCP-Clients erlauben auch, ein Bild direkt anzuhängen. Plus einige optionale Parameter — Ihr Client zeigt das Eingabeschema jedes Tools.

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.