Picsart GenAI MCP

Der Picsart MCP-Server stellt seine verfügbaren Modelle als Tools des Model Context Protocol bereit. Verbinde ihn mit einem beliebigen MCP-kompatiblen Agenten, und dieser kann mit den verfügbaren Modellen Bilder, Videos und Audio anhand natürlicher Sprache oder strukturierter Tool-Aufrufe generieren.

Neu bei MCP? Lies zuerst Was ist MCP?.

Was du brauchst

• Ein Picsart-Konto. Wenn sich der Agent zum ersten Mal verbindet, meldest du dich im Browser bei deinem Konto an.
• Credits auf diesem Konto für Generierungen. Das Durchsuchen des Katalogs und das Abfragen von Kosten sind kostenlos.
• Einen Agenten, der Remote-MCP-Server (HTTP) mit OAuth-Anmeldung unterstützt. Claude, Claude Code, Cursor, VS Code, Codex, ChatGPT und Gemini CLI unterstützen das alle.

Das ist alles. Der Server wird von Picsart gehostet, du musst also nichts auf deinem Rechner installieren. Du brauchst weder die gen-ai CLI, gen-ai login, noch einen API-Schlüssel, um MCP zu verwenden.

Die Serveradresse lautet:

https://api.picsart.com/gen-ai/mcp

So funktioniert die Anmeldung

Wenn sich dein Agent zum ersten Mal verbindet, teilt der Server ihm mit, dass eine Anmeldung erforderlich ist, und verweist ihn auf die Picsart-Anmeldeseite. Der Agent öffnet ein Browserfenster. Du meldest dich bei Picsart an und genehmigst den Zugriff, und der Agent speichert die Sitzung selbst. Von da an wird jeder Tool-Aufruf in deinem Namen und zulasten deines Credit-Guthabens ausgeführt.

Wenn die Sitzung abläuft, verbinde den Server erneut oder authentifiziere ihn über die MCP- oder Connector-Einstellungen deines Agenten neu. Die Schritte findest du in den jeweiligen Integrationsanleitungen.

Mit deinem Agenten verbinden

Claude (Web und Desktop)

Gehe zu Einstellungen → Connectors → Benutzerdefinierten Connector hinzufügen, füge https://api.picsart.com/gen-ai/mcp ein und melde dich im geöffneten Fenster bei Picsart an. Bei einem Claude Team- oder Enterprise-Tarif fügt ein Organisationsinhaber den Connector für alle hinzu.

Claude Code

claude mcp add --transport http picsart-gen-ai https://api.picsart.com/gen-ai/mcp

Führe dann /mcp in Claude Code aus, wähle picsart-gen-ai und anschließend Authentifizieren, um dich anzumelden. Verwende es in einer beliebigen Unterhaltung:

„Erzeuge ein Produktbild vor weißem Hintergrund mit Flux 2 Pro im Seitenverhältnis 4:3.“

Die vollständige Einrichtung von Claude Code einschließlich Skills und Fehlerbehebung findest du unter Claude Code-Integration.

Cursor

Füge Folgendes in deinem Projekt zu .cursor/mcp.json oder für jedes Projekt zu ~/.cursor/mcp.json hinzu:

{
  "mcpServers": {
    "picsart-gen-ai": {
      "url": "https://api.picsart.com/gen-ai/mcp"
    }
  }
}

Siehe Cursor-Integration.

Windsurf

Füge Folgendes zu mcp_config.json hinzu (öffne die Datei über Cascades Menü ... → MCP-Konfigurationsdatei öffnen):

{
  "mcpServers": {
    "picsart-gen-ai": {
      "serverUrl": "https://api.picsart.com/gen-ai/mcp"
    }
  }
}

Siehe Windsurf-Integration.

VS Code (Copilot)

Füge Folgendes in deinem Workspace zu .vscode/mcp.json oder deiner MCP-Benutzerkonfiguration hinzu:

{
  "servers": {
    "picsart-gen-ai": {
      "type": "http",
      "url": "https://api.picsart.com/gen-ai/mcp"
    }
  }
}

Siehe VS Code-Integration.

Codex (OpenAI)

codex mcp add picsart-gen-ai --url https://api.picsart.com/gen-ai/mcp
codex mcp login picsart-gen-ai

Siehe Codex-Integration.

ChatGPT und andere MCP-Clients

Füge einen Connector hinzu (manchmal als Remote- oder benutzerdefinierter MCP-Server bezeichnet), gib die obige Adresse ein und wähle OAuth als Authentifizierungsmethode. Siehe ChatGPT-Integration und die vollständige Liste der Integrationen.

---

Tool-Katalog

Nach der Verbindung stehen die unten aufgeführten Generierungs-, Katalog- und Drive-Tools sowie Anzeige-Tools, eine Reihe geführter Kreativboards und picsart_media_*-Tools zur Verfügung, mit denen du aus bereits vorhandenem Material Videos und Bilder erstellen kannst.

Du möchtest etwas erstellen statt generieren?

Picsart Media Studio ist ein Connector, der speziell für diese Art von Arbeit gedacht ist. Er wird separat hinzugefügt und angemeldet und lässt sich problemlos parallel zu diesem Connector verwenden.

Nach der Verbindung stehen dem Agenten alle Tools zur Verfügung. Tools, die keine Credits verbrauchen, können beliebig oft kostenlos aufgerufen werden.

Generierung

Tool	Zweck	Verbraucht Credits
picsart_generate	Jedes Modell vollständig ausführen (Bild / Video / Audio / Text)	ja
picsart_remove_bg	Bildhintergrund entfernen	ja
picsart_change_bg	Bildhintergrund anhand eines Prompts ersetzen	ja
picsart_enhance	Bild hochskalieren / verbessern	ja
picsart_vectorize	Rasterbild in SVG umwandeln	ja

Katalog und Kosten

Tool	Zweck	Verbraucht Credits
picsart_list_models	Modellauswahl-Widget, in dem der Benutzer visuell stöbern kann	nein
picsart_model_catalog	Derselbe Katalog als einfache Daten für die Schlussfolgerungen des Agenten	nein
picsart_model_params	Parameterschema eines Modells (Typ, erforderlich, Enum, Min./Max.)	nein
picsart_model_choice	Dem Benutzer eine kurze Liste möglicher Modelle als auswählbare Karten anzeigen	nein
picsart_preflight	Eine params-Nutzlast validieren und die Credit-Kosten in einem kostenlosen Probelauf abfragen	nein
picsart_credits	Aktueller Credit-Kontostand und Kontingentübersicht	nein
picsart_job_status	Einen mit picsart_generate gestarteten Auftrag abfragen	nein
picsart_render_monitor	Live-Fortschrittsanzeige für einen Stapel laufender Generierungen	nein

Anzeige

Tool	Zweck	Verbraucht Credits
picsart_view_image	Dem Agenten ermöglichen, bis zu 6 von Picsart gehostete Bilder anzusehen, um ein Ergebnis zu beurteilen oder eine Referenz zu beschreiben	nein

Drive

Tool	Zweck	Verbraucht Credits
picsart_drive	Einheitlicher Einstiegspunkt für Picsart Drive; das Verhalten wird über action ausgewählt	nein

picsart_drive erwartet einen Parameter action; es gibt keine separaten Drive-Tools für einzelne Vorgänge:

action	Funktion
list	Einen Ordner durchsuchen (folderUid weglassen = Stammverzeichnis; flat: true listet alle Dateien auf)
create_folder	Einen Ordner erstellen (name oder ein durch Schrägstriche getrenntes path; optionaler übergeordneter Ordner folderUid, description)
upload	Eine Datei speichern: file (ein Chat-Anhang), url + name (HTTPS-URL oder Inline-data:-URI) oder bis zu 10 auf einmal mit files. result.url ist eine CDN-URL, die direkt an imageUrls übergeben werden kann
move	itemUids nach targetFolderUid verschieben
delete	itemUids 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 sie anzeigen kann. Weitere Informationen findest du unter Dateien und Drive und unter Lokale Dateien → URLs, wenn du wissen möchtest, wie du eine Datei zunächst von deinem Datenträger abrufst.

Kreativboards und Medienerstellung

Einige Tools öffnen in der Unterhaltung ein interaktives Panel, statt mit Text zu antworten: etwa die Film-Setup-Konsole, das Shotlisten-Board, das Asset-Prüfboard, die Motion-Setup-Konsole und den Szeneneditor. Sie führen durch mehrstufige Projekte wie einen Kurzfilm oder ein Motion-Design-Video. Die picsart_media_*-Tools (Upload, Szenenvorlagen, Untertitel, Transkription, Neuausrichtung, Export) gehören zur selben Tool-Familie, die unter Media Studio → Was du tun kannst dokumentiert ist. Dein Agent erkennt sie automatisch; du musst sie nicht namentlich aufrufen.

Kein Tool akzeptiert einen Dateisystempfad

Jede Bild- und Videoeingabe muss eine URL sein. Im MCP-Vertrag gibt es nirgends einen Parameter filePath. Unter Lokale Dateien → URLs findest du die tatsächlich funktionierenden Pfade.

Empfohlener Generierungsablauf

Die Tools sind so konzipiert, dass sie aufeinander aufbauen. Mit dieser Abfolge vermeidest du Überraschungen:

1. picsart_model_catalog (oder picsart_list_models, damit der Benutzer visuell auswählen kann) → Modell auswählen
2. picsart_model_params → Eingaben ermitteln
3. picsart_preflight → Nutzlast validieren und Kosten in einem kostenlosen Aufruf abfragen
4. picsart_generate → Generierung starten
5. picsart_job_status → Ergebnis abrufen (Medienmodelle laufen standardmäßig asynchron)

Wenn du die Modell-ID bereits kennst, kannst du direkt zu picsart_generate springen.

Beispiele für Tool-Aufrufe

Ein Bild generieren:

{
  "name": "picsart_generate",
  "arguments": {
    "model": "flux-2-pro",
    "prompt": "a ceramic cup, studio lighting",
    "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 abfragen:

{
  "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": {
    "image": "https://example.com/product.jpg"
  }
}

picsart_remove_bg, picsart_change_bg, picsart_enhance und picsart_vectorize erwarten jeweils eine image-URL und wählen automatisch ein geeignetes Modell aus. Übergib model, um es zu überschreiben.

Referenz zu Eingaben

picsart_generate erwartet:

• Erforderlich: model (Modell-ID), prompt (Text-Prompt)
• Häufige optionale Parameter: aspectRatio, resolution, duration, count (1 bis 10), quality, style, negativePrompt
• Bildeingabe: imageUrls (Array von URLs für Image-to-Image- oder Image-to-Video-Modelle)
• Videoeingabe: videoUrl (einzelne URL für Video-to-Video-Modelle)
• Audiogenerierung: generateAudio (boolescher Wert für Videomodelle mit nativer Audio-Unterstützung)
• Prompt-Verbesserung: enhancePrompt (boolescher Wert; leitet den Prompt vor der Generierung über ein LLM)
• Drive: saveToDrive (Standardwert true) und folderUid (Drive-Ordner, in dem das Ergebnis abgelegt werden soll)
• Asynchron: async (standardmäßig true für jedes Medienmodell: Der Aufruf gibt sofort einen Auftrags-Handle zurück, und der Agent fragt picsart_job_status nach dem Ergebnis ab)
• Modellspezifische Parameter: extra (freies Objekt; mit picsart_model_params kannst du sehen, welche Parameter ein Modell akzeptiert)

Abgeschlossene Ergebnisse werden als assets: [{ id, type, url, ... }] zurückgegeben, zusammen mit einem resource_link für jede Datei, damit der Agent in nachfolgenden Tool-Aufrufen darauf verweisen kann. Assets sind HTTPS-URLs, niemals Base64. Textmodelle geben stattdessen den generierten Text zurück.

FAQ

Brauche ich die gen-ai CLI, um MCP zu verwenden?

Nein. Der MCP-Server wird von Picsart gehostet, und dein Agent verbindet sich über HTTPS mit ihm. Die CLI ist ein separates Terminal-Tool. Installiere sie nur, wenn du über eine Shell generieren oder Skills verwenden möchtest.

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

Nein. Du meldest dich über deinen Agenten mit deinem Picsart-Konto an. Es gibt keinen Schlüssel, den du kopieren oder erneuern musst.

Kann ich MCP und die CLI gleichzeitig verwenden?

Ja. Sie werden separat angemeldet, greifen aber auf dasselbe Picsart-Konto und dasselbe Credit-Guthaben zu.

Der Agent hat eine Verbindung hergestellt, aber die Tools werden nicht angezeigt.

Vergewissere dich, dass du die Anmeldung abgeschlossen hast, und starte den Agenten dann neu oder lade ihn erneut. Die meisten Agenten laden die Tool-Liste beim Verbindungsaufbau und nicht fortlaufend.

Welche Modelle funktionieren über MCP?

Die SDK-Katalogreferenz umfasst 251 Modelle. Welche davon über MCP verfügbar sind, hängt von der Serverversion ab. Verwende picsart_model_catalog oder picsart_list_models, um nach Modus, Anbieter oder Zweck zu filtern, oder durchsuche den Modellkatalog.

Wo werden generierte Dateien abgelegt?

Standardmäßig wird jedes Medienergebnis auch in deinem Picsart Drive in einem Ordner picsart-genai-mcp im Stammverzeichnis von Drive gespeichert. Übergib folderUid, um es an einem anderen Ort abzulegen, oder "saveToDrive": false, um das Speichern zu überspringen. Mit picsart_drive kannst du selbst eine URL oder einen Chat-Anhang hochladen. Siehe Dateien und Drive.

Wie kann ich vor dem Ausführen feststellen, was ein Modell kostet?

Rufe picsart_preflight mit der Modell-ID und den geplanten Parametern auf. Das Tool validiert die Nutzlast und gibt eine Credit-Kostenschätzung zurück, ohne die Generierung auszuführen.

Was passiert, wenn mein Credit-Guthaben aufgebraucht ist?

Prüfe dein Guthaben mit picsart_credits und lade es unter picsart.com auf, bevor du es erneut versuchst.