POUR LES AGENTS IA

Laissez votre agent créer des images avec Sparkles

Connectez Claude Code, Claude Desktop, Cursor ou un autre client MCP à votre compte Sparkles. Installez le Sparkles Image MCP open source, connectez-vous une fois et laissez votre agent générer des images et des GIF à partir d'un prompt.

Sparkles Image MCP est un serveur MCP local. Il utilise votre compte et vos Credits Sparkles ; vous ne transmettez jamais votre mot de passe ni une clé API à l'agent. Les images créées via MCP apparaissent dans la même bibliothèque que celles créées sur le site.

Installez en une minute environ Dépôt GitHub

Installez en une minute environ

Choisissez une seule méthode. Le plugin Claude Code est le plus rapide. Utilisez la configuration manuelle pour Claude Desktop, Cursor ou un autre client MCP.

Plugin Claude Code

Dans Claude Code, exécutez ces deux commandes. Le plugin fournit le serveur MCP et la compétence sparkles-image.

/plugin marketplace add sparkles-mcp/sparkles-image-mcp
/plugin install sparkles-image@sparkles-image-mcp

Configuration MCP manuelle

Ajoutez ce serveur à la configuration de votre client MCP. Il fonctionne avec tout client prenant en charge les serveurs MCP stdio.

{
  "mcpServers": {
    "sparkles-image": {
      "command": "npx",
      "args": ["-y", "github:sparkles-mcp/sparkles-image-mcp", "serve"]
    }
  }
}

Ou utilisez la CLI d'installation

La CLI installe la compétence de l'agent, affiche la configuration du client et lance la connexion dans le navigateur. Exécutez doctor à tout moment pour vérifier la connexion.

npx -y github:sparkles-mcp/sparkles-image-mcp init
npx -y github:sparkles-mcp/sparkles-image-mcp doctor

Envoyez ceci à votre agent

Vous ne savez pas comment configurer votre client ? Copiez ce prompt et envoyez-le à votre agent. Il ajoutera le serveur et lancera la connexion.

Envoyez ceci à votre agent

Configure le Sparkles Image MCP pour ce client.

Commande du serveur : npx
Arguments du serveur : -y github:sparkles-mcp/sparkles-image-mcp serve

S'il s'agit de Claude Code, exécute :
claude mcp add --scope user sparkles-image -- npx -y github:sparkles-mcp/sparkles-image-mcp serve

Lance ensuite l'outil login de sparkles-image et attends que j'approuve l'accès dans le navigateur. Ne génère aucune image avant que je le demande. Chaque génération consomme mes Credits Sparkles.

N'installez pas en même temps le plugin Claude Code et une entrée manuelle portant le même nom. Une seule méthode doit être utilisée.

Connectez-vous une fois et approuvez les autorisations

La connexion ouvre sparkles-editor.com dans votre navigateur et attend un retour local sur 127.0.0.1. La page de consentement affiche l'application et le compte connecté. Les jetons restent sur votre machine ; vous pouvez révoquer l'accès dans Compte → Applications MCP connectées. Le jeton d'accès expire après 15 minutes et se renouvelle automatiquement.

images:generateEnvoyer et annuler des tâches d'image.
images:readLire l'état des tâches, votre bibliothèque et les images générées.
account:readLire votre solde de Credits et votre utilisation.

Ce que l'agent peut faire

Ces outils sont disponibles après connexion. La génération consomme des Credits ; les outils de lecture n'en consomment pas.

generate_imageGénère 1 à 4 images ou un GIF à partir d'un prompt.
get_imageVérifie une tâche et renvoie son image lorsqu'elle est prête.
list_imagesListe les images récentes et l'état de leurs tâches.
check_image_jobsVérifie jusqu'à 50 tâches sans télécharger les images.
cancel_image_jobsAnnule les tâches en file d'attente.
list_image_modelsListe les modèles, qualités et la prise en charge des GIF.
get_credit_balanceLit le solde de Credits disponible.
get_credit_usageLit les débits et remboursements récents.
loginOuvre la connexion dans le navigateur lorsqu'une autorisation est nécessaire.

Les images apparaissent dans votre bibliothèque Sparkles

Les images générées via MCP sont des images Sparkles ordinaires. Elles apparaissent dans Bibliothèque → Œuvres et dans la bande des œuvres récentes de l'espace image, avec la même durée de conservation que le site : 1 jour après la génération, ou 28 jours avec un abonnement actif. Enregistrez définitivement une image si vous souhaitez la conserver.

Ouvrir la bibliothèque → Œuvres

Credits et modération

Chaque génération consomme des Credits de votre compte connecté. Le catalogue peut afficher 0 pour les modèles facturés à l'usage ; le débit réel apparaît dans get_credit_usage et dans votre historique de facturation. Les prompts passent par la même modération que les images créées sur le site. Un prompt refusé est renvoyé comme erreur et ne doit pas être reformulé pour contourner la modération.

Questions fréquentes

La connexion ne s'ouvre pas: Exécutez la commande login de la CLI ; elle affiche l'URL d'autorisation à ouvrir manuellement.
login_required ou login_expired: Reconnectez-vous. Si le problème persiste, révoquez l'ancienne autorisation dans Compte → Applications MCP connectées.
insufficient_credits: Rechargez ou réduisez la demande. L'agent ne doit pas réessayer sans discernement.
L'image est encore en cours de génération: Demandez à l'agent d'appeler get_image avec l'identifiant de la tâche. Ne soumettez pas le même prompt à nouveau.
image_too_large: L'image dépasse la limite de 6 Mo pour un renvoi intégré. Ouvrez-la dans Bibliothèque → Œuvres ou téléchargez-la à cet endroit.
Le mauvais site s'ouvre: Vérifiez SPARKLES_ISSUER si vous utilisez un site de test ou auto-hébergé.

Liens

Le client MCP est open source sous licence MIT. Il utilise l'API publique /api/mcp et n'inclut ni le code du site Sparkles, ni la logique de facturation, ni les règles de modération, ni les secrets.