Picsart GenAI MCP

Le serveur MCP Picsart expose ses modèles disponibles sous forme d’outils Model Context Protocol. Connectez-le à n’importe quel agent compatible avec MCP : celui-ci pourra générer des images, des vidéos et de l’audio avec les modèles disponibles, en langage naturel ou à l’aide d’appels d’outils structurés.

Vous découvrez MCP ? Commencez par lire Qu’est-ce que MCP ?.

Ce dont vous avez besoin

• Un compte Picsart. Vous vous y connecterez dans votre navigateur lors de la première connexion de l’agent.
• Des crédits sur ce compte pour les générations. La consultation du catalogue et l’estimation des coûts sont gratuites.
• Un agent compatible avec les serveurs MCP distants (HTTP) avec connexion OAuth. Claude, Claude Code, Cursor, VS Code, Codex, ChatGPT et Gemini CLI le sont tous.

C’est tout. Le serveur est hébergé par Picsart : vous n’avez donc rien à installer sur votre machine. Vous n’avez pas besoin de gen-ai CLI, de gen-ai login ni d’une clé API pour utiliser MCP.

Adresse du serveur :

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

Fonctionnement de la connexion

Lors de la première connexion de votre agent, le serveur indique qu’une connexion est requise et redirige l’agent vers la page de connexion Picsart. L’agent ouvre une fenêtre de navigateur ; vous vous connectez à Picsart et autorisez l’accès, puis l’agent enregistre lui-même la session. Dès lors, chaque appel d’outil est effectué en votre nom et débité de votre solde de crédits.

Si la session expire, reconnectez le serveur ou authentifiez-le à nouveau dans les paramètres MCP ou de connecteur de votre agent. Les étapes sont indiquées dans chaque guide d’intégration.

Connecter votre agent

Claude (web et ordinateur)

Accédez à Settings → Connectors → Add custom connector, collez https://api.picsart.com/gen-ai/mcp, puis connectez-vous à Picsart dans la fenêtre qui s’ouvre. Avec un forfait Claude Team ou Enterprise, le propriétaire de l’organisation ajoute le connecteur pour tout le monde.

Claude Code

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

Exécutez ensuite /mcp dans Claude Code, sélectionnez picsart-gen-ai, puis choisissez Authenticate pour vous connecter. Utilisez-le dans n’importe quelle conversation :

« Génère une image de produit sur fond blanc avec Flux 2 Pro, au format 4:3. »

Pour la configuration complète de Claude Code, y compris les Skills et le dépannage, consultez l’intégration Claude Code.

Cursor

Ajoutez ce qui suit à .cursor/mcp.json dans votre projet, ou à ~/.cursor/mcp.json pour tous vos projets :

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

Consultez l’intégration Cursor.

Windsurf

Ajoutez-le à mcp_config.json (ouvrez ce fichier depuis le menu ... de Cascade → Open MCP config file) :

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

Consultez l’intégration Windsurf.

VS Code (Copilot)

Ajoutez-le à .vscode/mcp.json dans votre espace de travail ou dans votre configuration MCP utilisateur :

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

Consultez l’intégration VS Code.

Codex (OpenAI)

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

Consultez l’intégration Codex.

ChatGPT et autres clients MCP

Ajoutez un connecteur (parfois appelé serveur MCP distant ou personnalisé) avec l’adresse ci-dessus et choisissez OAuth comme méthode d’authentification. Consultez l’intégration ChatGPT et la liste complète des intégrations.

---

Catalogue d’outils

La connexion donne accès aux outils de génération, de catalogue et de Drive ci-dessous, ainsi qu’à des outils de visualisation, à un ensemble de tableaux créatifs guidés et aux outils picsart_media_* permettant de créer des vidéos et des images à partir de contenus que vous possédez déjà.

Vous souhaitez créer plutôt que générer ?

Picsart Media Studio est un connecteur dédié à ce type de travail. Il s’ajoute et se connecte séparément, et fonctionne parfaitement aux côtés de celui-ci.

Une fois la connexion établie, l’agent peut utiliser tous les outils. Les appels aux outils qui ne consomment pas de crédits sont gratuits et peuvent être répétés autant que nécessaire.

Génération

Outil	Fonction	Consomme des crédits
picsart_generate	Exécuter un modèle de bout en bout (image / vidéo / audio / texte)	oui
picsart_remove_bg	Supprimer l’arrière-plan d’une image	oui
picsart_change_bg	Remplacer l’arrière-plan d’une image à partir d’une invite	oui
picsart_enhance	Agrandir / améliorer une image	oui
picsart_vectorize	Convertir une image matricielle en SVG	oui

Catalogue et coûts

Outil	Fonction	Consomme des crédits
picsart_list_models	Widget de sélection de modèle, pour permettre à l’utilisateur de parcourir visuellement le catalogue	non
picsart_model_catalog	Le même catalogue sous forme de données brutes, pour le raisonnement de l’agent	non
picsart_model_params	Schéma des paramètres d’un modèle (type, obligatoire, enum, min/max)	non
picsart_model_choice	Présenter à l’utilisateur une courte liste de modèles candidats sous forme de cartes	non
picsart_preflight	Valider un contenu params et estimer son coût en crédits en un seul essai gratuit	non
picsart_credits	Solde de crédits actuel et détail des quotas	non
picsart_job_status	Interroger une tâche lancée par picsart_generate	non
picsart_render_monitor	Panneau de progression en direct pour un lot de générations en cours	non

Visualisation

Outil	Fonction	Consomme des crédits
picsart_view_image	Permettre à l’agent d’examiner jusqu’à 6 images hébergées par Picsart afin d’évaluer un résultat ou de décrire une référence	non

Drive

Outil	Fonction	Consomme des crédits
picsart_drive	Point d’entrée unique pour Picsart Drive, dont le comportement est déterminé par action	non

picsart_drive prend un paramètre action ; il n’existe pas d’outils Drive distincts pour chaque opération :

action	Fonction
list	Parcourir un dossier (folderUid omis = racine ; flat: true répertorie tous les fichiers)
create_folder	Créer un dossier (name, ou un path séparé par des barres obliques, parent facultatif folderUid, description)
upload	Enregistrer un fichier : file (une pièce jointe de chat), url + name (URL HTTPS ou URI data: intégrée), ou jusqu’à 10 fichiers à la fois avec files. result.url est une URL CDN prête à être transmise à imageUrls
move	Déplacer itemUids vers targetFolderUid
delete	Placer itemUids dans la corbeille (suppression réversible ; permanent: true pour l’effacer)
update	Définir des attributs personnalisés sur un fichier (itemUid + attributes)

Chaque action renvoie le contenu actuel du dossier afin que le widget Drive puisse l’afficher. Consultez Fichiers et Drive pour en savoir plus, et Fichiers locaux → URL pour savoir comment obtenir d’abord une URL à partir d’un fichier sur votre disque.

Tableaux créatifs et création de médias

Certains outils ouvrent un panneau interactif dans la conversation au lieu de répondre par du texte : la console de configuration de film, le tableau de liste de plans, le tableau de révision des ressources, la console de configuration de mouvement et l’éditeur de scènes, entre autres. Ils accompagnent des projets en plusieurs étapes, comme un court métrage ou une vidéo de motion design. Les outils picsart_media_* (téléversement, modèles de scènes, sous-titres, transcription, recadrage, exportation) appartiennent à la même famille que ceux décrits dans Media Studio → Ce que vous pouvez faire. Votre agent les découvre automatiquement ; vous n’avez pas besoin de les appeler par leur nom.

Aucun outil n’accepte de chemin de système de fichiers

Chaque image ou vidéo en entrée doit être une URL. Le contrat MCP ne comporte aucun paramètre filePath. Consultez Fichiers locaux → URL pour connaître les chemins qui fonctionnent réellement.

Flux de génération recommandé

Les outils sont conçus pour être enchaînés. Cette séquence évite les mauvaises surprises :

1. picsart_model_catalog (ou picsart_list_models pour laisser l’utilisateur choisir visuellement) → choisir un modèle
2. picsart_model_params → découvrir ses entrées
3. picsart_preflight → valider le contenu et estimer le coût en un seul appel gratuit
4. picsart_generate → lancer la génération
5. picsart_job_status → récupérer le résultat (les modèles de médias s’exécutent par défaut de manière asynchrone)

Si vous avez déjà l’identifiant d’un modèle, passez directement à picsart_generate.

Exemples d’appels d’outils

Générer une image :

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

Générer une vidéo :

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

Valider et estimer le coût au préalable :

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

Supprimer un arrière-plan :

{
  "name": "picsart_remove_bg",
  "arguments": {
    "image": "https://example.com/product.jpg"
  }
}

picsart_remove_bg, picsart_change_bg, picsart_enhance et picsart_vectorize prennent chacun une URL image et sélectionnent automatiquement un modèle adapté. Transmettez model pour le remplacer.

Référence des entrées

picsart_generate prend les paramètres suivants :

• Obligatoires : model (identifiant du modèle), prompt (invite textuelle)
• Facultatifs courants : aspectRatio, resolution, duration, count (de 1 à 10), quality, style, negativePrompt
• Entrée image : imageUrls (tableau d’URL, pour les modèles image-vers-image ou image-vers-vidéo)
• Entrée vidéo : videoUrl (URL unique, pour les modèles vidéo-vers-vidéo)
• Génération audio : generateAudio (booléen, pour les modèles vidéo prenant en charge l’audio natif)
• Amélioration de l’invite : enhancePrompt (booléen, fait passer l’invite par un LLM avant la génération)
• Drive : saveToDrive (valeur par défaut true) et folderUid (dossier Drive dans lequel enregistrer le résultat)
• Asynchrone : async (par défaut true pour tous les modèles de médias : l’appel renvoie immédiatement un identifiant de tâche, puis l’agent interroge picsart_job_status pour obtenir le résultat)
• Paramètres propres au modèle : extra (objet libre ; utilisez picsart_model_params pour connaître les paramètres acceptés par un modèle)

Les résultats terminés sont renvoyés sous forme de assets: [{ id, type, url, ... }], ainsi que d’un resource_link pour chaque fichier afin que l’agent puisse y faire référence dans les appels d’outils suivants. Les ressources sont des URL HTTPS, jamais du base64. Les modèles de texte renvoient plutôt le texte généré.

FAQ

Ai-je besoin de gen-ai CLI pour utiliser MCP ?

Non. Le serveur MCP est hébergé par Picsart et votre agent s’y connecte via HTTPS. La CLI est un outil distinct destiné au terminal. Installez-la uniquement si vous souhaitez générer du contenu depuis un shell ou utiliser les Skills.

Le serveur MCP nécessite-t-il une clé API ?

Non. Vous vous connectez avec votre compte Picsart depuis votre agent. Aucune clé n’est à copier ni à renouveler.

Puis-je utiliser MCP et la CLI en même temps ?

Oui. Les connexions sont séparées, mais elles utilisent le même compte Picsart et le même solde de crédits.

L’agent s’est connecté, mais les outils n’apparaissent pas.

Vérifiez que vous avez terminé la connexion, puis redémarrez ou rechargez l’agent. La plupart des agents chargent la liste des outils au moment de la connexion, et non en continu.

Quels modèles fonctionnent avec MCP ?

La référence du catalogue SDK couvre 251 modèles. La disponibilité dans MCP dépend de la version du serveur. Utilisez picsart_model_catalog ou picsart_list_models pour filtrer par mode, fournisseur ou usage, ou parcourez le Catalogue de modèles.

Où sont enregistrés les fichiers générés ?

Par défaut, chaque résultat multimédia est également enregistré dans votre Picsart Drive, dans un dossier picsart-genai-mcp à la racine du Drive. Transmettez folderUid pour l’enregistrer ailleurs, ou "saveToDrive": false pour ne pas l’enregistrer. Utilisez picsart_drive pour téléverser vous-même une URL ou une pièce jointe de chat. Consultez Fichiers et Drive.

Comment connaître le coût d’un modèle avant de l’exécuter ?

Appelez picsart_preflight avec l’identifiant du modèle et les paramètres que vous comptez utiliser. L’outil valide le contenu et renvoie une estimation en crédits sans lancer la génération.

Que se passe-t-il si mon solde de crédits est épuisé ?

Vérifiez votre solde avec picsart_credits, puis rechargez-le sur picsart.com avant de réessayer.