Picsart GenAI MCP

Der Picsart MCP-Server stellt den vollständigen Modellkatalog als Model Context Protocol-Tools bereit. Verbinden Sie ihn mit einem beliebigen MCP-kompatiblen Agenten, und dieser Agent kann Bilder, Videos und Audio über 201 Modelle mithilfe natürlicher Sprache oder strukturierter Tool-Aufrufe generieren.

Neu bei MCP? Beginnen Sie zuerst mit Was ist MCP?.

Voraussetzungen

1. Installieren Sie die gen-ai CLI – siehe Installation.
2. Führen Sie gen-ai login einmal aus (öffnet Ihren Browser für OAuth).

Das ist alles. Der MCP-Server (gen-ai-mcp) wird mit der CLI ausgeliefert und verwendet dieselben Anmeldedaten.

Verbinden mit Ihrem Agenten

Claude Code

claude mcp add picsart-gen-ai -- gen-ai-mcp

Verwenden Sie ihn dann in jeder Unterhaltung:

„Generiere ein Produktbild auf weißem Hintergrund mit Flux 2 Pro, 4:3-Seitenverhältnis."

Für die vollständige Claude-Code-Einrichtung einschließlich Skills und Fehlerbehebung siehe Claude-Code-Integration.

Cursor

Fügen Sie Folgendes zu Ihrer Cursor-MCP-Konfigurationsdatei hinzu (.cursor/mcp.json oder entsprechend):

{
  "mcpServers": {
    "picsart-gen-ai": {
      "command": "gen-ai-mcp"
    }
  }
}

Siehe Cursor-Integration.

Windsurf

Fügen Sie dies zu Ihrer Windsurf-MCP-Konfiguration hinzu:

{
  "mcpServers": {
    "picsart-gen-ai": {
      "command": "gen-ai-mcp"
    }
  }
}

Siehe Windsurf-Integration.

VS Code (Copilot)

Fügen Sie dies zu .vscode/mcp.json in Ihrem Workspace oder zu Ihren Benutzereinstellungen hinzu:

{
  "servers": {
    "picsart-gen-ai": {
      "type": "stdio",
      "command": "gen-ai-mcp"
    }
  }
}

Siehe VS-Code-Integration.

Codex (OpenAI)

codex mcp add picsart-gen-ai -- gen-ai-mcp

Siehe Codex-Integration.

ChatGPT und andere MCP-Clients

Siehe ChatGPT-Integration oder die offizielle Seite unter picsart.com/gen-ai-mcp für die aktuelle Connector-Konfiguration.

---

Tool-Katalog

Durch die Verbindung werden die unten aufgeführten Generierungs-, Katalog- und Drive-Tools sowie picsart_media_*-Tools zum Erstellen von Videos und Bildern aus bereits vorhandenem Material verfügbar gemacht.

Statt zu generieren, lieber bauen?

Picsart Media Studio ist ein Connector, der genau für diese Art von Arbeit gedacht ist. Er wird separat hinzugefügt und angemeldet und funktioniert problemlos neben diesem.

Jedes Tool ist dem Agenten nach der Verbindung verfügbar. Tools, die keine Credits verbrauchen, können beliebig oft aufgerufen werden.

Generierung

Tool	Zweck	Verbraucht Credits
picsart_generate	Beliebiges Modell end-to-end ausführen (Bild / Video / Audio / Text)	ja
picsart_remove_bg	Bildhintergrund entfernen	ja
picsart_change_bg	Bildhintergrund basierend auf einer Eingabeaufforderung ersetzen	ja
picsart_enhance	Bild hochskalieren / verbessern	ja
picsart_vectorize	Rasterbild in SVG konvertieren	ja
picsart_music_studio	Music Studio öffnen (Musik / Soundeffekte / Albumcover)	nein¹

¹ Das Öffnen des Studios ist kostenlos; die Generierung darin verbraucht Credits.

Katalog & Kosten

Tool	Zweck	Verbraucht Credits
picsart_list_models	Modellauswahl-Widget – für den Benutzer zum visuellen Durchsuchen	nein
picsart_model_catalog	Derselbe Katalog als reine Daten, für die eigene Argumentation des Agenten	nein
picsart_model_params	Parameterschema eines Modells (Typ, erforderlich, Aufzählung, Min/Max)	nein
picsart_preflight	Eine Parameter-Payload validieren und deren Credit-Kosten angeben – ein kostenloser Probelauf	nein
picsart_credits	Aktueller Credit-Saldo und Kontingentaufschlüsselung	nein
picsart_job_status	Einen von picsart_generate gestarteten Job mit async: true abfragen	nein

Drive

Tool	Zweck	Verbraucht Credits
picsart_drive	Einzelner Einstiegspunkt für Picsart Drive – Verhalten ausgewählt durch action	nein

picsart_drive akzeptiert einen action-Parameter; es gibt keine separaten Drive-Tools pro Vorgang:

action	Was es tut
list	Ordner durchsuchen (folderUid weggelassen = Stammverzeichnis; flat: true listet jede Datei auf)
create_folder	Ordner erstellen (name, optionaler übergeordneter folderUid, description)
upload	Datei speichern – entweder file (ein Chat-Anhang) oder url + name (HTTPS-URL oder Inline-data:-URI). result.url ist eine CDN-URL, die bereit ist, an imageUrls übergeben zu werden
move	itemUids nach targetFolderUid verschieben
delete	itemUids per Soft-Delete in den Papierkorb verschieben (permanent: true zum endgültigen Löschen)
update	Benutzerdefinierte Attribute für eine Datei festlegen (itemUid + attributes)

Jede Aktion gibt die aktuelle Ordnerliste zurück, damit das Drive-Widget rendern kann. Siehe Dateien & Drive für Details und Lokale Dateien → URLs, um eine Datei überhaupt erst von Ihrer Festplatte zu bekommen.

Kein Tool akzeptiert einen Dateisystempfad

Jede Bild-/Videoeingabe ist eine URL. Es gibt keinen filePath-Parameter irgendwo im MCP-Vertrag – siehe Lokale Dateien → URLs für die drei Wege, die tatsächlich funktionieren.

Empfohlener Generierungsablauf

Die Tools sind für die Verkettung konzipiert. Diese Reihenfolge vermeidet Überraschungen:

1. picsart_model_catalog (oder picsart_list_models, um den Benutzer visuell auswählen zu lassen) → ein Modell auswählen
2. picsart_model_params → dessen Eingaben kennenlernen
3. picsart_preflight → die Payload validieren und die Kosten in einem kostenlosen Aufruf angeben
4. picsart_generate → tatsächlich ausführen

Wenn Sie bereits eine Modell-ID zur Hand haben, springen Sie direkt zu picsart_generate.

Beispiel-Tool-Aufrufe

Ein Bild generieren:

{
  "name": "picsart_generate",
  "arguments": {
    "model": "flux-2-pro",
    "prompt": "a ceramic cup, studio lighting, 4:3",
    "aspectRatio": "4:3",
    "count": 1
  }
}

Ein Video generieren:

{
  "name": "picsart_generate",
  "arguments": {
    "model": "seedance-2.0",
    "prompt": "a cat skiing down a mountain",
    "duration": 8,
    "aspectRatio": "16:9",
    "generateAudio": true
  }
}

Zuerst validieren und Kosten angeben:

{
  "name": "picsart_preflight",
  "arguments": {
    "model": "veo-3.1",
    "params": { "prompt": "a drone shot over a snowy ridge", "duration": 8, "resolution": "1080p" }
  }
}

Einen Hintergrund entfernen:

{
  "name": "picsart_remove_bg",
  "arguments": {
    "imageUrls": ["https://example.com/product.jpg"]
  }
}

Eingabereferenz

picsart_generate akzeptiert:

• Erforderlich: model (Modell-ID), prompt (Textaufforderung)
• Häufig optional: aspectRatio, resolution, duration, count (1 bis 8), quality, style, negativePrompt
• Bildeingabe: imageUrls (Array von URLs – für Bild-zu-Bild- oder Bild-zu-Video-Modelle)
• Videoeingabe: videoUrl (einzelne URL – für Video-zu-Video-Modelle)
• Audio-Generierung: generateAudio (boolesch – für Videomodelle, die natives Audio unterstützen)
• Aufforderungsverbesserung: enhancePrompt (boolesch – leitet vor der Generierung durch ein LLM)
• Modellspezifische Parameter: extra (frei formbares Objekt – verwenden Sie picsart_model_params, um zu sehen, was ein Modell akzeptiert)

Ergebnisse werden als results: [{ url, metadata? }] zurückgegeben. Assets sind URLs, niemals base64. Jedes Ergebnis enthält außerdem ein resource_link, damit der Agent es in Folge-Tool-Aufrufen referenzieren kann.

FAQ

Benötigt der MCP-Server einen separaten API-Schlüssel?

Nein. Er verwendet dieselbe OAuth-Sitzung wie die CLI. Führen Sie gen-ai login einmal aus; der MCP-Server übernimmt diese Anmeldedaten automatisch.

Kann ich MCP und die CLI gleichzeitig auf demselben Rechner verwenden?

Ja. Beide verwenden dieselbe Anmeldedatendatei (~/.gen-ai/credentials.json) und denselben Credit-Saldo. Die parallele Ausführung ist in Ordnung.

Der Agent ist verbunden, aber die Tools erscheinen nicht.

Starten Sie den Agenten nach dem Hinzufügen der MCP-Konfiguration neu. Die meisten Agenten laden die Tool-Liste beim Start, nicht dynamisch.

Welche Modelle funktionieren über MCP?

Alle 201 Modelle im Katalog. Es gibt keine MCP-spezifische Teilmenge. Verwenden Sie picsart_list_models, um nach Modus oder Anbieter zu filtern, oder durchsuchen Sie den Modellkatalog.

Kann der Agent generierte Dateien auf Drive speichern?

Ja. Übergeben Sie "saveToDrive": true in den picsart_generate-Argumenten oder verwenden Sie picsart_drive, um eine lokale Datei oder URL hochzuladen. Siehe Dateien und Drive.

Wie erfahre ich, was ein Modell kostet, bevor ich es ausführe?

Rufen Sie picsart_preflight mit der Modell-ID und den geplanten Parametern auf. Es validiert die Payload und gibt eine Credit-Schätzung zurück, ohne die Generierung auszuführen.

Was passiert, wenn mein Credit-Saldo mitten in der Generierung aufgebraucht ist?

Überprüfen Sie Ihren Saldo mit picsart_credits und laden Sie unter picsart.com auf, bevor Sie es erneut versuchen.