Picsart GenAI MCP

Le serveur MCP Picsart expose le catalogue complet de modèles sous forme d'outils Model Context Protocol. Connectez-le à n'importe quel agent compatible MCP et cet agent pourra générer des images, des vidéos et de l'audio sur 201 modèles en utilisant le langage naturel ou des appels d'outils structurés.

Nouveau sur MCP ? Commencez par Qu'est-ce que MCP ?.

Prérequis

1. Installez la CLI gen-ai — voir Installation.
2. Exécutez gen-ai login une fois (ouvre votre navigateur pour OAuth).

C'est tout. Le serveur MCP (gen-ai-mcp) est fourni avec la CLI et utilise les mêmes identifiants.

Connectez-vous à votre agent

Claude Code

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

Utilisez-le ensuite dans n'importe quelle conversation :

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

Pour une configuration complète de Claude Code, y compris les compétences et le dépannage, voir Intégration Claude Code.

Cursor

Ajoutez ce qui suit à votre fichier de configuration MCP Cursor (.cursor/mcp.json ou équivalent) :

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

Voir Intégration Cursor.

Windsurf

Ajoutez à votre configuration MCP Windsurf :

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

Voir Intégration Windsurf.

VS Code (Copilot)

Ajoutez à .vscode/mcp.json dans votre espace de travail ou à vos paramètres utilisateur :

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

Voir Intégration VS Code.

Codex (OpenAI)

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

Voir Intégration Codex.

ChatGPT et autres clients MCP

Voir Intégration ChatGPT ou la page officielle sur picsart.com/gen-ai-mcp pour la configuration actuelle du connecteur.

---

Catalogue d'outils

La connexion expose les outils de génération, de catalogue et Drive ci-dessous, plus picsart_media_* outils pour créer des vidéos et des images à partir de matériel que vous possédez déjà.

Vous préférez construire plutôt que générer ?

Picsart Media Studio est un connecteur dédié à ce type de travail. Il est ajouté et connecté séparément, et fonctionne parfaitement en parallèle de celui-ci.

Chaque outil est disponible pour l'agent une fois connecté. Les outils qui ne dépensent pas de crédits sont gratuits et peuvent être appelés autant de fois que nécessaire.

Génération

Outil	Objectif	Dépense des crédits
picsart_generate	Exécuter n'importe quel 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	Améliorer / agrandir une image	oui
picsart_vectorize	Convertir une image raster en SVG	oui
picsart_music_studio	Ouvrir Music Studio (musique / effets sonores / pochette d'album)	non¹

¹ Ouvrir le studio est gratuit ; générer à l'intérieur dépense des crédits.

Catalogue et coût

Outil	Objectif	Dépense des crédits
picsart_list_models	Sélecteur de modèles widget — pour que l'utilisateur navigue visuellement	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 de paramètres d'un modèle (type, obligatoire, énumération, min/max)	non
picsart_preflight	Valider une charge utile de paramètres et estimer son coût en crédits — un essai gratuit	non
picsart_credits	Solde de crédits actuel et répartition du quota	non
picsart_job_status	Interroger un travail démarré par picsart_generate avec async: true	non

Drive

Outil	Objectif	Dépense des crédits
picsart_drive	Point d'entrée unique pour Picsart Drive — comportement sélectionné par action	non

picsart_drive prend un paramètre action ; il n'y a pas d'outils Drive séparés par opération :

action	Ce qu'il fait
list	Parcourir un dossier (folderUid omis = racine ; flat: true liste chaque fichier)
create_folder	Créer un dossier (name, parent facultatif folderUid, description)
upload	Enregistrer un fichier — soit file (une pièce jointe de chat) soit url + name (URL HTTPS ou URI data: intégré). result.url est une URL CDN prête à être transmise à imageUrls
move	Déplacer itemUids vers targetFolderUid
delete	Suppression douce de itemUids vers la corbeille (permanent: true pour effacer)
update	Définir des attributs personnalisés sur un fichier (itemUid + attributes)

Chaque action renvoie la liste actuelle du dossier afin que le widget Drive puisse s'afficher. Voir Fichiers et Drive pour plus de détails, et Fichiers locaux → URLs pour obtenir un fichier depuis votre disque en premier lieu.

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

Chaque entrée image/vidéo est une URL. Il n'y a pas de paramètre filePath dans le contrat MCP — voir Fichiers locaux → URLs pour les trois chemins qui fonctionnent réellement.

Flux de génération recommandé

Les outils sont conçus pour s'enchaîner. Cette séquence évite les surprises :

1. picsart_model_catalog (ou picsart_list_models pour laisser l'utilisateur choisir visuellement) → choisir un modèle
2. picsart_model_params → apprendre ses entrées
3. picsart_preflight → valider la charge utile et estimer le coût en un seul appel gratuit
4. picsart_generate → l'exécuter réellement

Si vous avez déjà un identifiant de modèle en main, 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, 4:3",
    "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 un coût d'abord :

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

Référence des entrées

picsart_generate prend :

• Obligatoire : model (identifiant du modèle), prompt (invite textuelle)
• Facultatif courant : aspectRatio, resolution, duration, count (1 à 8), quality, style, negativePrompt
• Entrée image : imageUrls (tableau d'URLs — pour les modèles image-à-image ou image-à-vidéo)
• Entrée vidéo : videoUrl (URL unique — pour les modèles vidéo-à-vidéo)
• Génération audio : generateAudio (booléen — pour les modèles vidéo prenant en charge l'audio natif)
• Amélioration d'invite : enhancePrompt (booléen — passe par un LLM avant la génération)
• Paramètres spécifiques au modèle : extra (objet libre — utilisez picsart_model_params pour voir ce qu'un modèle accepte)

Les résultats reviennent sous forme de results: [{ url, metadata? }]. Les ressources sont des URLs, jamais du base64. Chaque résultat inclut également un resource_link afin que l'agent puisse y faire référence dans les appels d'outils suivants.

FAQ

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

Non. Il utilise la même session OAuth que la CLI. Exécutez gen-ai login une fois ; le serveur MCP récupère automatiquement ces identifiants.

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

Oui. Les deux utilisent le même fichier d'identifiants (~/.gen-ai/credentials.json) et le même solde de crédits. Les exécuter en parallèle est parfaitement possible.

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

Redémarrez l'agent après avoir ajouté la configuration MCP. La plupart des agents chargent la liste des outils au démarrage, pas dynamiquement.

Quels modèles fonctionnent via MCP ?

Les 201 modèles du catalogue. Il n'y a pas de sous-ensemble spécifique à MCP. Utilisez picsart_list_models pour filtrer par mode ou fournisseur, ou parcourez le Catalogue de modèles.

L'agent peut-il enregistrer les fichiers générés sur Drive ?

Oui. Passez "saveToDrive": true dans les arguments de picsart_generate, ou utilisez picsart_drive pour téléverser un fichier local ou une URL. Voir 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 prévoyez d'utiliser. Il valide la charge utile et renvoie une estimation de crédits sans exécuter la génération.

Que se passe-t-il si mon solde de crédits s'épuise en pleine génération ?

Vérifiez votre solde avec picsart_credits et rechargez sur picsart.com avant de réessayer.