Picsart GenAI MCP

O servidor MCP do Picsart expõe os modelos disponíveis 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 com os modelos disponíveis usando linguagem natural ou chamadas estruturadas de ferramentas.

É novo no MCP? Comece por O que é MCP?.

O que você precisa

• Uma conta Picsart. Você entra nela pelo navegador na primeira vez que o agente se conecta.
• Créditos nessa conta para gerar conteúdo. Navegar pelo catálogo e consultar custos é grátis.
• Um agente compatível com servidores MCP remotos (HTTP) com autenticação OAuth. Claude, Claude Code, Cursor, VS Code, Codex, ChatGPT e Gemini CLI são compatíveis.

É só isso. O servidor é hospedado pelo Picsart, então não há nada para instalar na sua máquina. Você não precisa do gen-ai CLI, gen-ai login nem de uma chave de API para usar o MCP.

O endereço do servidor é:

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

Como funciona a autenticação

Na primeira vez que seu agente se conecta, o servidor informa que é necessário entrar e direciona o agente para a página de autenticação do Picsart. O agente abre uma janela do navegador, você entra no Picsart e aprova o acesso, e o próprio agente armazena a sessão. A partir daí, todas as chamadas de ferramentas são feitas em seu nome, usando seu saldo de créditos.

Se a sessão expirar, reconecte ou autentique novamente o servidor nas configurações de MCP ou de conectores do agente. As etapas estão em cada guia de integração.

Conecte ao seu agente

Claude (web e desktop)

Acesse Settings → Connectors → Add custom connector, cole https://api.picsart.com/gen-ai/mcp e entre no Picsart na janela que abrir. Em um plano Claude Team ou Enterprise, o proprietário da organização adiciona o conector para todos.

Claude Code

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

Em seguida, execute /mcp no Claude Code, selecione picsart-gen-ai e escolha Authenticate para entrar. Use-o em qualquer conversa:

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

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

Cursor

Adicione o seguinte a .cursor/mcp.json no seu projeto ou a ~/.cursor/mcp.json para todos os projetos:

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

Consulte Integração com Cursor.

Windsurf

Adicione a mcp_config.json (abra pelo menu ... do Cascade → Open MCP config file):

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

Consulte Integração com Windsurf.

VS Code (Copilot)

Adicione a .vscode/mcp.json no seu workspace ou à configuração de MCP do usuário:

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

Consulte Integração com VS Code.

Codex (OpenAI)

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

Consulte Integração com Codex.

ChatGPT e outros clientes MCP

Adicione um conector (às vezes chamado de servidor MCP remoto ou personalizado) com o endereço acima e escolha OAuth como método de autenticação. Consulte Integração com ChatGPT e a lista completa de integrações.

---

Catálogo de ferramentas

A conexão disponibiliza as ferramentas de geração, catálogo e Drive abaixo, além de ferramentas de visualização, um conjunto de painéis criativos guiados e ferramentas picsart_media_* para criar vídeos e imagens a partir de materiais que você já tem.

Vai criar em vez de gerar?

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

Todas as ferramentas ficam disponíveis para o agente após a conexão. As ferramentas que não consomem créditos podem ser chamadas gratuitamente quantas vezes forem necessárias.

Geração

Ferramenta	Finalidade	Consome créditos
picsart_generate	Executar qualquer modelo de ponta a ponta (imagem / vídeo / áudio / texto)	sim
picsart_remove_bg	Remover o fundo de uma imagem	sim
picsart_change_bg	Substituir o fundo de uma imagem com base em um prompt	sim
picsart_enhance	Ampliar / aprimorar uma imagem	sim
picsart_vectorize	Converter uma imagem rasterizada em SVG	sim

Catálogo e custos

Ferramenta	Finalidade	Consome créditos
picsart_list_models	Widget de seleção de modelos para o usuário navegar visualmente	não
picsart_model_catalog	O mesmo catálogo em formato de dados simples, para o agente usar em seu próprio raciocínio	não
picsart_model_params	Esquema de parâmetros de um modelo (tipo, obrigatoriedade, enumeração, mínimo/máximo)	não
picsart_model_choice	Mostrar ao usuário uma lista curta de modelos candidatos em cartões para ele escolher	não
picsart_preflight	Validar um payload de parâmetros e consultar o custo em créditos em uma única simulação gratuita	não
picsart_credits	Saldo atual de créditos e detalhamento das cotas	não
picsart_job_status	Consultar um trabalho iniciado por picsart_generate	não
picsart_render_monitor	Painel de progresso em tempo real para um lote de gerações em andamento	não

Visualização

Ferramenta	Finalidade	Consome créditos
picsart_view_image	Permitir que o agente veja até 6 imagens hospedadas pelo Picsart para avaliar um resultado ou descrever uma referência	não

Drive

Ferramenta	Finalidade	Consome créditos
picsart_drive	Ponto de entrada único para o Picsart Drive, com comportamento definido por action	não

picsart_drive recebe um parâmetro action; não há ferramentas separadas do Drive para cada operação:

action	O que faz
list	Navegar por uma pasta (folderUid omitido = raiz; flat: true lista todos os arquivos)
create_folder	Criar uma pasta (name ou um path separado por barras, pai opcional folderUid, description)
upload	Salvar um arquivo: file (um anexo do chat), url + name (URL HTTPS ou URI data: embutido) ou até 10 de uma vez com files. result.url é uma URL de CDN pronta para ser passada a imageUrls
move	Mover itemUids para targetFolderUid
delete	Mover itemUids para a lixeira (permanent: true para apagar definitivamente)
update	Definir atributos personalizados em um arquivo (itemUid + attributes)

Cada ação retorna a listagem atual da pasta para que o widget do Drive possa renderizá-la. Consulte Arquivos e Drive para saber mais e Arquivos locais → URLs para saber como obter um arquivo do seu disco.

Painéis criativos e criação de mídia

Algumas ferramentas abrem um painel interativo na conversa em vez de responder com texto: o console de configuração de filmes, o painel de lista de cenas, o painel de revisão de recursos, o console de configuração de movimento e o editor de cenas, entre outros. Eles orientam projetos com várias etapas, como um curta-metragem ou um vídeo de motion design. As ferramentas picsart_media_* (upload, modelos de cena, legendas, transcrição, reenquadramento, exportação) pertencem à mesma família documentada em Media Studio → O que você pode fazer. Seu agente descobre todas elas automaticamente; você não precisa chamá-las pelo nome.

Nenhuma ferramenta aceita um caminho do sistema de arquivos

Toda entrada de imagem/vídeo deve ser uma URL. Não existe nenhum parâmetro filePath no contrato MCP. Consulte Arquivos locais → URLs para ver os caminhos que realmente funcionam.

Fluxo de geração recomendado

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

1. picsart_model_catalog (ou picsart_list_models para permitir que o usuário escolha visualmente) → escolher um modelo
2. picsart_model_params → conhecer as entradas do modelo
3. picsart_preflight → validar o payload e consultar o custo em uma única chamada gratuita
4. picsart_generate → iniciar
5. picsart_job_status → obter o resultado (modelos de mídia são executados de forma assíncrona por padrão)

Se você já tiver um ID de modelo, 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",
    "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 consultar 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": {
    "image": "https://example.com/product.jpg"
  }
}

picsart_remove_bg, picsart_change_bg, picsart_enhance e picsart_vectorize recebem uma URL image e selecionam automaticamente um modelo adequado. Passe model para substituí-lo.

Referência de entradas

picsart_generate recebe:

• Obrigatórios: model (ID do modelo), prompt (prompt de texto)
• Opcionais comuns: aspectRatio, resolution, duration, count (de 1 a 10), 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 compatíveis com áudio nativo)
• Aprimoramento de prompt: enhancePrompt (booleano, encaminha o prompt a um LLM antes da geração)
• Drive: saveToDrive (padrão true) e folderUid (pasta do Drive onde salvar o resultado)
• Assíncrono: async (o padrão é true para todos os modelos de mídia: a chamada retorna imediatamente um identificador de trabalho, e o agente consulta picsart_job_status para obter o resultado)
• Parâmetros específicos do modelo: extra (objeto de formato livre; use picsart_model_params para ver o que o modelo aceita)

Os resultados concluídos são retornados como assets: [{ id, type, url, ... }], além de um resource_link para cada arquivo, para que o agente possa referenciá-lo em chamadas de ferramentas posteriores. Os recursos são URLs HTTPS, nunca base64. Modelos de texto retornam o texto gerado.

Perguntas frequentes

Preciso do gen-ai CLI para usar o MCP?

Não. O servidor MCP é hospedado pelo Picsart, e seu agente se conecta a ele por HTTPS. A CLI é uma ferramenta separada para o terminal. Instale-a somente se quiser gerar conteúdo pelo shell ou usar Skills.

O servidor MCP exige uma chave de API?

Não. Você entra com sua conta Picsart pelo agente. Não há nenhuma chave para copiar ou renovar.

Posso usar o MCP e a CLI ao mesmo tempo?

Sim. Eles são autenticados separadamente, mas usam a mesma conta Picsart e o mesmo saldo de créditos.

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

Verifique se você concluiu a autenticação e reinicie ou recarregue o agente. A maioria dos agentes carrega a lista de ferramentas ao se conectar, e não continuamente.

Quais modelos funcionam via MCP?

A referência do catálogo do SDK abrange 251 modelos. A disponibilidade no MCP depende da versão do servidor. Use picsart_model_catalog ou picsart_list_models para filtrar por modo, provedor ou finalidade, ou navegue pelo Catálogo de modelos.

Onde os arquivos gerados são armazenados?

Por padrão, cada resultado de mídia também é salvo no seu Picsart Drive, em uma pasta picsart-genai-mcp na raiz do Drive. Passe folderUid para salvá-lo em outro lugar ou "saveToDrive": false para não salvar. Use picsart_drive para fazer upload de uma URL ou de um anexo do chat. Consulte Arquivos e Drive.

Como descubro o custo de um modelo antes de executá-lo?

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

O que acontece se meus créditos acabarem?

Consulte seu saldo com picsart_credits e adicione créditos em picsart.com antes de tentar novamente.