Picsart GenAI MCP

El servidor MCP de Picsart expone sus modelos disponibles como herramientas de Model Context Protocol. Conéctalo a cualquier agente compatible con MCP y podrá generar imágenes, videos y audio con los modelos disponibles mediante lenguaje natural o llamadas estructuradas a herramientas.

¿Es la primera vez que usas MCP? Empieza por ¿Qué es MCP?.

Qué necesitas

• Una cuenta de Picsart. Inicia sesión en ella desde el navegador la primera vez que el agente se conecte.
• Créditos en esa cuenta para generar contenido. Explorar el catálogo y consultar los costos es gratis.
• Un agente compatible con servidores MCP remotos (HTTP) con inicio de sesión OAuth. Claude, Claude Code, Cursor, VS Code, Codex, ChatGPT y Gemini CLI son compatibles.

Eso es todo. Picsart aloja el servidor, así que no tienes que instalar nada en tu equipo. No necesitas gen-ai CLI, gen-ai login ni una clave de API para usar MCP.

La dirección del servidor es:

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

Cómo funciona el inicio de sesión

La primera vez que el agente se conecta, el servidor indica que es necesario iniciar sesión y dirige al agente a la página de inicio de sesión de Picsart. El agente abre una ventana del navegador; inicias sesión en Picsart y apruebas el acceso, y el agente guarda la sesión. A partir de entonces, todas las llamadas a herramientas se realizan en tu nombre y usan tu saldo de créditos.

Si la sesión caduca, vuelve a conectar o autentica de nuevo el servidor desde la configuración de MCP o de conectores de tu agente. Encontrarás los pasos en cada guía de integración.

Conecta tu agente

Claude (web y escritorio)

Ve a Settings → Connectors → Add custom connector, pega https://api.picsart.com/gen-ai/mcp e inicia sesión en Picsart en la ventana que se abre. En los planes Claude Team o Enterprise, el propietario de la organización añade el conector para todos.

Claude Code

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

Luego ejecuta /mcp en Claude Code, selecciona picsart-gen-ai y elige Authenticate para iniciar sesión. Úsalo en cualquier conversación:

«Genera una imagen de producto sobre un fondo blanco con Flux 2 Pro, con una relación de aspecto de 4:3».

Para ver la configuración completa de Claude Code, incluidas las Skills y la solución de problemas, consulta Integración con Claude Code.

Cursor

Añade lo siguiente a .cursor/mcp.json en tu proyecto, o a ~/.cursor/mcp.json para todos los proyectos:

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

Consulta Integración con Cursor.

Windsurf

Añádelo a mcp_config.json (ábrelo desde el menú ... de Cascade → Open MCP config file):

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

Consulta Integración con Windsurf.

VS Code (Copilot)

Añádelo a .vscode/mcp.json en tu espacio de trabajo o a la configuración MCP de usuario:

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

Consulta Integración con VS Code.

Codex (OpenAI)

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

Consulta Integración con Codex.

ChatGPT y otros clientes MCP

Añade un conector (a veces llamado servidor MCP remoto o personalizado) con la dirección anterior y selecciona OAuth como método de autenticación. Consulta Integración con ChatGPT y la lista completa de integraciones.

---

Catálogo de herramientas

Al conectarte, tendrás acceso a las herramientas de generación, catálogo y Drive que se indican a continuación, además de herramientas de visualización, un conjunto de tableros creativos guiados y herramientas de picsart_media_* para crear videos e imágenes a partir de material que ya tienes.

¿Vas a crear en lugar de generar?

Picsart Media Studio es un conector dedicado a ese tipo de trabajo. Se añade y se inicia sesión en él por separado, y funciona perfectamente junto con este.

Una vez conectado, el agente tiene acceso a todas las herramientas. Las herramientas que no consumen créditos se pueden usar gratis tantas veces como sea necesario.

Generación

Herramienta	Propósito	Consume créditos
picsart_generate	Ejecutar cualquier modelo de principio a fin (imagen / video / audio / texto)	sí
picsart_remove_bg	Eliminar el fondo de una imagen	sí
picsart_change_bg	Reemplazar el fondo de una imagen a partir de una instrucción	sí
picsart_enhance	Ampliar / mejorar una imagen	sí
picsart_vectorize	Convertir una imagen rasterizada a SVG	sí

Catálogo y costos

Herramienta	Propósito	Consume créditos
picsart_list_models	Widget para que el usuario explore visualmente el selector de modelos	no
picsart_model_catalog	El mismo catálogo como datos sin formato, para el razonamiento del agente	no
picsart_model_params	Esquema de parámetros de un modelo (tipo, obligatorio, enum, mínimo/máximo)	no
picsart_model_choice	Mostrar al usuario una lista breve de modelos candidatos en tarjetas para que elija	no
picsart_preflight	Validar una carga útil de parámetros y consultar su costo en créditos en una sola simulación gratuita	no
picsart_credits	Saldo de créditos actual y desglose de cuotas	no
picsart_job_status	Consultar el estado de un trabajo iniciado por picsart_generate	no
picsart_render_monitor	Panel de progreso en tiempo real para un lote de generaciones en curso	no

Visualización

Herramienta	Propósito	Consume créditos
picsart_view_image	Permitir que el agente vea hasta 6 imágenes alojadas en Picsart para evaluar un resultado o describir una referencia	no

Drive

Herramienta	Propósito	Consume créditos
picsart_drive	Punto de acceso único a Picsart Drive; el comportamiento se selecciona mediante action	no

picsart_drive acepta un parámetro action; no hay herramientas de Drive independientes para cada operación:

action	Qué hace
list	Explorar una carpeta (folderUid omitido = raíz; flat: true muestra todos los archivos)
create_folder	Crear una carpeta (name o una ruta path separada por barras, carpeta principal opcional folderUid, description)
upload	Guardar un archivo: file (un adjunto del chat), url + name (URL HTTPS o URI data: integrada), o hasta 10 a la vez con files. result.url es una URL de CDN lista para pasar a imageUrls
move	Mover itemUids a targetFolderUid
delete	Enviar itemUids a la papelera (usar permanent: true para borrarlo definitivamente)
update	Establecer atributos personalizados en un archivo (itemUid + attributes)

Cada acción devuelve el contenido actual de la carpeta para que el widget de Drive pueda mostrarlo. Consulta Archivos y Drive para obtener más información y Archivos locales → URL para saber cómo obtener primero un archivo de tu disco.

Tableros creativos y creación de contenido multimedia

Algunas herramientas abren un panel interactivo en la conversación en lugar de responder con texto: la consola de configuración de películas, el tablero de lista de tomas, el tablero de revisión de recursos, la consola de configuración de movimiento y el editor de escenas, entre otros. Guían proyectos de varios pasos, como un cortometraje o un video de diseño en movimiento. Las herramientas de picsart_media_* (carga, plantillas de escenas, subtítulos, transcripción, reencuadre y exportación) pertenecen a la misma familia que se documenta en Media Studio → Qué puedes hacer. El agente las descubre automáticamente; no tienes que llamarlas por nombre.

Ninguna herramienta acepta una ruta del sistema de archivos

Todas las imágenes y videos de entrada deben ser una URL. El contrato MCP no incluye ningún parámetro filePath. Consulta Archivos locales → URL para ver qué rutas funcionan realmente.

Flujo de generación recomendado

Las herramientas están diseñadas para encadenarse. Esta secuencia evita sorpresas:

1. picsart_model_catalog (o picsart_list_models para que el usuario elija visualmente) → elegir un modelo
2. picsart_model_params → conocer sus entradas
3. picsart_preflight → validar la carga útil y consultar el costo en una sola llamada gratuita
4. picsart_generate → iniciar la generación
5. picsart_job_status → obtener el resultado (los modelos multimedia se ejecutan de forma asíncrona de manera predeterminada)

Si ya tienes el ID de un modelo, ve directamente a picsart_generate.

Ejemplos de llamadas a herramientas

Generar una imagen:

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

Generar un video:

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

Validar y consultar el costo primero:

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

Eliminar un fondo:

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

picsart_remove_bg, picsart_change_bg, picsart_enhance y picsart_vectorize aceptan una URL image y seleccionan automáticamente un modelo adecuado. Pasa model para anularlo.

Referencia de entradas

picsart_generate acepta:

• Obligatorios: model (ID del modelo), prompt (instrucción de texto)
• Opcionales habituales: aspectRatio, resolution, duration, count (de 1 a 10), quality, style, negativePrompt
• Entrada de imagen: imageUrls (matriz de URL, para modelos de imagen a imagen o de imagen a video)
• Entrada de video: videoUrl (una sola URL, para modelos de video a video)
• Generación de audio: generateAudio (booleano, para modelos de video compatibles con audio nativo)
• Mejora de instrucciones: enhancePrompt (booleano, pasa por un LLM antes de la generación)
• Drive: saveToDrive (valor predeterminado true) y folderUid (carpeta de Drive donde guardar el resultado)
• Asíncrono: async (el valor predeterminado es true para todos los modelos multimedia: la llamada devuelve un identificador de trabajo de inmediato y el agente consulta picsart_job_status para obtener el resultado)
• Parámetros específicos del modelo: extra (objeto de formato libre; usa picsart_model_params para ver qué acepta un modelo)

Los resultados terminados se devuelven como assets: [{ id, type, url, ... }], junto con un resource_link por cada archivo para que el agente pueda hacer referencia a él en llamadas posteriores a herramientas. Los recursos son URL HTTPS, nunca base64. Los modelos de texto devuelven el texto generado.

Preguntas frecuentes

¿Necesito gen-ai CLI para usar MCP?

No. Picsart aloja el servidor MCP y tu agente se conecta a él mediante HTTPS. La CLI es una herramienta independiente para la terminal. Instálala solo si quieres generar contenido desde un shell o usar Skills.

¿El servidor MCP requiere una clave de API?

No. Inicias sesión con tu cuenta de Picsart desde el agente. No hay ninguna clave que copiar ni rotar.

¿Puedo usar MCP y la CLI al mismo tiempo?

Sí. Inicias sesión en cada uno por separado, pero ambos usan la misma cuenta de Picsart y el mismo saldo de créditos.

El agente se conectó, pero no aparecen las herramientas.

Asegúrate de haber terminado de iniciar sesión y luego reinicia o vuelve a cargar el agente. La mayoría de los agentes cargan la lista de herramientas al conectarse, no de forma continua.

¿Qué modelos funcionan con MCP?

La referencia del catálogo del SDK incluye 251 modelos. La disponibilidad en MCP depende de la versión del servidor. Usa picsart_model_catalog o picsart_list_models para filtrar por modo, proveedor o propósito, o explora el Catálogo de modelos.

¿Dónde se guardan los archivos generados?

De forma predeterminada, cada resultado multimedia también se guarda en tu Picsart Drive, en una carpeta picsart-genai-mcp en la raíz de Drive. Pasa folderUid para guardarlo en otro lugar o "saveToDrive": false para omitir el guardado. Usa picsart_drive para subir una URL o un adjunto del chat. Consulta Archivos y Drive.

¿Cómo puedo saber cuánto cuesta un modelo antes de ejecutarlo?

Llama a picsart_preflight con el ID del modelo y los parámetros que planeas usar. Valida la carga útil y devuelve una estimación de créditos sin ejecutar la generación.

¿Qué ocurre si me quedo sin créditos?

Consulta tu saldo con picsart_credits y recarga en picsart.com antes de volver a intentarlo.