Picsart GenAI MCP

O servidor MCP da Picsart expõe o catálogo completo de modelos como ferramentas do Model Context Protocol. Conecte-o a qualquer agente compatível com MCP e esse agente poderá gerar imagens, vídeos e áudio em 201 modelos usando linguagem natural ou chamadas de ferramentas estruturadas.

Novo no MCP? Comece com O que é MCP? primeiro.

Pré-requisitos

1. Instale a CLI gen-ai — veja Instalação.
2. Execute gen-ai login uma vez (abre seu navegador para OAuth).

Isso é tudo. O servidor MCP (gen-ai-mcp) acompanha a CLI e usa as mesmas credenciais.

Conecte ao seu agente

Claude Code

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

Depois use em qualquer conversa:

"Gere uma imagem de produto em fundo branco usando Flux 2 Pro, proporção 4:3."

Para configuração completa do Claude Code, incluindo Skills e solução de problemas, veja Integração com Claude Code.

Cursor

Adicione o seguinte ao seu arquivo de configuração MCP do Cursor (.cursor/mcp.json ou equivalente):

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

Veja Integração com Cursor.

Windsurf

Adicione à sua configuração MCP do Windsurf:

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

Veja Integração com Windsurf.

VS Code (Copilot)

Adicione a .vscode/mcp.json no seu workspace ou nas configurações do usuário:

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

Veja Integração com VS Code.

Codex (OpenAI)

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

Veja Integração com Codex.

ChatGPT e outros clientes MCP

Veja Integração com ChatGPT ou a página oficial em picsart.com/gen-ai-mcp para a configuração atual do conector.

---

Catálogo de ferramentas

A conexão expõe as ferramentas de geração, catálogo e Drive abaixo, além de picsart_media_* ferramentas para criar vídeos e imagens a partir de material que você já possui.

Prefere construir em vez de gerar?

Picsart Media Studio é um conector dedicado a esse tipo de trabalho. Ele é adicionado e autenticado separadamente, e funciona bem junto com este.

Toda ferramenta fica disponível para o agente após a conexão. Ferramentas que não gastam créditos podem ser chamadas gratuitamente quantas vezes forem necessárias.

Geração

Ferramenta	Finalidade	Gasta créditos
picsart_generate	Executa qualquer modelo de ponta a ponta (imagem / vídeo / áudio / texto)	sim
picsart_remove_bg	Remove o fundo de uma imagem	sim
picsart_change_bg	Substitui o fundo de uma imagem a partir de um prompt	sim
picsart_enhance	Aumenta a resolução / melhora uma imagem	sim
picsart_vectorize	Converte uma imagem raster em SVG	sim
picsart_music_studio	Abre o Music Studio (música / efeitos sonoros / capa de álbum)	não¹

¹ Abrir o estúdio é gratuito; gerar dentro dele gasta créditos.

Catálogo e custo

Ferramenta	Finalidade	Gasta créditos
picsart_list_models	Seletor de modelos widget — para o usuário navegar visualmente	não
picsart_model_catalog	O mesmo catálogo como dados simples, para o raciocínio do próprio agente	não
picsart_model_params	Esquema de parâmetros de um modelo (tipo, obrigatório, enum, mínimo/máximo)	não
picsart_preflight	Valida um payload de parâmetros e informa o custo em créditos — uma execução de teste gratuita	não
picsart_credits	Saldo atual de créditos e detalhamento da cota	não
picsart_job_status	Consulta um job iniciado por picsart_generate com async: true	não

Drive

Ferramenta	Finalidade	Gasta créditos
picsart_drive	Ponto de entrada único para o Picsart Drive — comportamento selecionado por action	não

picsart_drive recebe um parâmetro action; não existem ferramentas separadas por operação no Drive:

action	O que faz
list	Navega em uma pasta (folderUid omitido = raiz; flat: true lista todos os arquivos)
create_folder	Cria uma pasta (name, pasta pai opcional folderUid, description)
upload	Salva um arquivo — ou file (um anexo do chat) ou url + name (URL HTTPS ou URI data: inline). result.url é uma URL de CDN pronta para passar para imageUrls
move	Move itemUids para targetFolderUid
delete	Exclusão suave de itemUids para a lixeira (permanent: true para apagar)
update	Define atributos personalizados em um arquivo (itemUid + attributes)

Cada ação retorna a listagem atual da pasta para que o widget do Drive possa renderizar. Veja Arquivos e Drive para detalhes, e Arquivos locais → URLs para obter um arquivo do seu disco em primeiro lugar.

Nenhuma ferramenta aceita caminho de sistema de arquivos

Toda entrada de imagem/vídeo é uma URL. Não existe filePath em nenhum lugar do contrato MCP — veja Arquivos locais → URLs para os três caminhos que realmente funcionam.

Fluxo de geração recomendado

As ferramentas foram projetadas para encadear. Esta sequência evita surpresas:

1. picsart_model_catalog (ou picsart_list_models para deixar o usuário escolher visualmente) → escolha um modelo
2. picsart_model_params → aprenda suas entradas
3. picsart_preflight → valide o payload e informe o custo em uma única chamada gratuita
4. picsart_generate → execute de fato

Se você já tem um ID de modelo em mãos, vá direto para picsart_generate.

Exemplos de chamadas de ferramentas

Gerar uma imagem:

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

Gerar um vídeo:

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

Validar e informar o custo primeiro:

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

Remover um fundo:

{
  "name": "picsart_remove_bg",
  "arguments": {
    "imageUrls": ["https://example.com/product.jpg"]
  }
}

Referência de entradas

picsart_generate recebe:

• Obrigatórios: model (ID do modelo), prompt (prompt de texto)
• Opcionais comuns: aspectRatio, resolution, duration, count (1 a 8), quality, style, negativePrompt
• Entrada de imagem: imageUrls (matriz de URLs — para modelos de imagem-para-imagem ou imagem-para-vídeo)
• Entrada de vídeo: videoUrl (URL única — para modelos de vídeo-para-vídeo)
• Geração de áudio: generateAudio (booleano — para modelos de vídeo que suportam áudio nativo)
• Aprimoramento de prompt: enhancePrompt (booleano — passa por um LLM antes da geração)
• Parâmetros específicos do modelo: extra (objeto de formato livre — use picsart_model_params para ver o que um modelo aceita)

Os resultados retornam como results: [{ url, metadata? }]. Os ativos são URLs, nunca base64. Cada resultado também inclui um resource_link para que o agente possa referenciá-lo em chamadas de ferramentas subsequentes.

FAQ

O servidor MCP exige uma chave de API separada?

Não. Ele usa a mesma sessão OAuth da CLI. Execute gen-ai login uma vez; o servidor MCP captura essas credenciais automaticamente.

Posso usar MCP e a CLI na mesma máquina ao mesmo tempo?

Sim. Ambos usam o mesmo arquivo de credenciais (~/.gen-ai/credentials.json) e o mesmo saldo de créditos. Executá-los em paralelo não é problema.

O agente conectou, mas as ferramentas não aparecem.

Reinicie o agente após adicionar a configuração MCP. A maioria dos agentes carrega a lista de ferramentas na inicialização, não dinamicamente.

Quais modelos funcionam via MCP?

Todos os 201 modelos do catálogo. Não existe um subconjunto específico para MCP. Use picsart_list_models para filtrar por modo ou provedor, ou navegue pelo Catálogo de Modelos.

O agente pode salvar arquivos gerados no Drive?

Sim. Passe "saveToDrive": true nos argumentos de picsart_generate, ou use picsart_drive para enviar um arquivo local ou URL. Veja Arquivos e Drive.

Como sei quanto um modelo custa antes de executá-lo?

Chame picsart_preflight com o ID do modelo e os parâmetros que você planeja usar. Ele valida o payload e retorna uma estimativa de créditos sem executar a geração.

O que acontece se meu saldo de créditos acabar no meio da geração?

Verifique seu saldo com picsart_credits e recarregue em picsart.com antes de tentar novamente.