PARA AGENTES DE IA

Deja que tu agente cree imágenes con Sparkles

Conecta Claude Code, Claude Desktop, Cursor u otro cliente MCP a tu cuenta de Sparkles. Instala el Sparkles Image MCP de código abierto, inicia sesión una vez y deja que tu agente genere imágenes y GIF a partir de un prompt.

Sparkles Image MCP es un servidor MCP local. Usa tu cuenta y tus Credits de Sparkles; nunca entregas al agente tu contraseña ni una clave API. Las imágenes creadas por MCP aparecen en la misma Biblioteca que las creadas en el sitio web.

Instala en aproximadamente un minuto Repositorio de GitHub

Instala en aproximadamente un minuto

Elige un solo método. El plugin de Claude Code es el más rápido. Usa la configuración manual para Claude Desktop, Cursor u otro cliente MCP.

Plugin de Claude Code

Dentro de Claude Code, ejecuta estos dos comandos. El plugin incluye el servidor MCP y la skill sparkles-image.

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

Configuración MCP manual

Añade este servidor a la configuración de tu cliente MCP. Funciona con cualquier cliente que admita servidores MCP por stdio.

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

O usa la CLI de instalación

La CLI instala la skill del agente, muestra la configuración e inicia el inicio de sesión en el navegador. Ejecuta doctor cuando quieras para comprobar la conexión.

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

Envía esto a tu agente

¿No sabes cómo configurar tu cliente? Copia este prompt y envíalo a tu agente. Añadirá el servidor e iniciará el inicio de sesión.

Envía esto a tu agente

Configura Sparkles Image MCP para este cliente.

Comando del servidor: npx
Argumentos del servidor: -y github:sparkles-mcp/sparkles-image-mcp serve

Si es Claude Code, ejecuta:
claude mcp add --scope user sparkles-image -- npx -y github:sparkles-mcp/sparkles-image-mcp serve

Después inicia la herramienta login de sparkles-image y espera mientras apruebo el acceso en el navegador. No generes ninguna imagen hasta que te lo pida. Cada generación consume mis Credits de Sparkles.

No instales el plugin de Claude Code y una entrada manual con el mismo nombre a la vez. Solo debe usarse uno.

Inicia sesión una vez y aprueba los permisos

El inicio de sesión abre sparkles-editor.com en tu navegador y espera una callback local en 127.0.0.1. La página de consentimiento muestra la aplicación y la cuenta. Los tokens se guardan en tu equipo; puedes revocar el acceso en Cuenta → Aplicaciones MCP conectadas. El token de acceso caduca a los 15 minutos y se renueva automáticamente.

images:generateEnviar y cancelar tareas de imagen.
images:readLeer el estado de las tareas, tu biblioteca y las imágenes generadas.
account:readLeer tu saldo de Credits y tu uso.

Qué puede hacer el agente

Estas herramientas están disponibles tras iniciar sesión. Generar imágenes consume Credits; las herramientas de lectura no.

generate_imageGenera de 1 a 4 imágenes o un GIF a partir de un prompt.
get_imageConsulta una tarea y devuelve su imagen cuando está lista.
list_imagesLista las imágenes recientes y el estado de sus tareas.
check_image_jobsConsulta hasta 50 tareas sin descargar imágenes.
cancel_image_jobsCancela las tareas en cola.
list_image_modelsLista los modelos, calidades y compatibilidad con GIF.
get_credit_balanceLee el saldo de Credits disponible.
get_credit_usageLee los cargos y reembolsos recientes.
loginAbre el inicio de sesión cuando se necesita autorización.

Las imágenes aparecen en tu Biblioteca de Sparkles

Las imágenes generadas por MCP son imágenes normales de Sparkles. Aparecen en Biblioteca → Obras y en la franja de obras recientes del espacio de imagen, y siguen la misma retención que el sitio: 1 día tras la generación, o 28 días con una suscripción activa. Guarda una imagen de forma permanente si quieres conservarla.

Abrir Biblioteca → Obras

Credits y moderación

Cada generación consume Credits de tu cuenta. El catálogo puede mostrar 0 en los modelos facturados por uso; el cargo real aparece en get_credit_usage y en tu historial de facturación. Los prompts pasan por la misma moderación que las imágenes creadas en el sitio. Un prompt rechazado se devuelve como error y no debe reescribirse para evitar la moderación.

Preguntas frecuentes

El inicio de sesión no se abre: Ejecuta el comando login de la CLI; muestra la URL de autorización para abrirla manualmente.
login_required o login_expired: Inicia sesión de nuevo. Si se repite, revoca el permiso anterior en Cuenta → Aplicaciones MCP conectadas.
insufficient_credits: Recarga o reduce la petición. El agente no debe reintentar sin criterio.
La imagen sigue generándose: Pide al agente que llame a get_image con el id de la tarea. No envíes el mismo prompt otra vez.
image_too_large: La imagen supera el límite de 6 MB para devolverla en línea. Ábrela en Biblioteca → Obras o descárgala allí.
Se abre el sitio equivocado: Revisa SPARKLES_ISSUER si usas un sitio de pruebas o autoalojado.

Enlaces

El cliente MCP es de código abierto bajo MIT. Usa la API pública /api/mcp y no incluye el código del sitio de Sparkles, la lógica de facturación, las reglas de moderación ni secretos.