Pictify
Servidor MCP para imagens geradas por IA, GIFs e PDFs a partir de HTML/CSS, URLs ou modelos reutilizáveis. Lote de até 100 renderizações personalizadas, teste A/B de variantes.
Documentação
@pictify/mcp-server
Um servidor MCP (Model Context Protocol) para Pictify — gere imagens, GIFs, vídeos e PDFs a partir de agentes de IA como Claude, Cursor e Windsurf.
Instalação em uma linha. Sem necessidade de código. Peça ao seu assistente de IA para criar imagens OG, cards para redes sociais, capturas de tela, GIFs animados, faturas em PDF, certificados e muito mais — tudo a partir de linguagem natural.
O que ele pode fazer?
- Gerar imagens a partir de HTML/CSS, URLs ou modelos reutilizáveis (imagens OG, cards para Twitter, banners, capturas de tela de produtos)
- Criar GIFs animados a partir de animações CSS ou gravando páginas web ao vivo
- Renderizar vídeos a partir de modelos, incluindo cenas Remotion criadas por agentes
- Renderizar PDFs a partir de modelos — faturas, certificados, relatórios, etiquetas de envio
- Geração em lote de até 100 imagens personalizadas em uma única solicitação (crachás de equipe, passes de eventos, catálogos de produtos)
- Sistema de modelos com mais de 50 funções de expressão para conteúdo dinâmico (condicionais, manipulação de strings, formatação de datas)
Funciona com Claude (claude.ai + Claude Code + Claude Desktop), Cursor, Windsurf e qualquer cliente compatível com MCP.
Início Rápido
Pré-requisitos
Obtenha sua chave de API:
- Cadastre-se ou faça login em pictify.io
- Acesse API Tokens
- Crie um novo token e copie-o
Claude.ai (Web)
Use o servidor remoto hospedado — sem necessidade de instalação:
- Acesse claude.ai > Configurações > Conectores
- Clique em Adicionar conector personalizado
- URL:
https://mcp.pictify.io - Clique em Configurações avançadas
- Client ID:
pictify - Client Secret: cole seu token de API
- Clique em Adicionar
Claude Code
claude mcp add pictify -e PICTIFY_API_KEY=your_api_key -- npx -y @pictify/mcp-server
Claude Desktop
Adicione ao seu arquivo de configuração:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json - Linux:
~/.config/Claude/claude_desktop_config.json
{
"mcpServers": {
"pictify": {
"command": "npx",
"args": ["-y", "@pictify/mcp-server"],
"env": {
"PICTIFY_API_KEY": "your_api_key"
}
}
}
}
Reinicie o Claude Desktop após salvar.
Cursor
Adicione nas configurações de MCP do Cursor (Configurações > MCP Servers):
{
"mcpServers": {
"pictify": {
"command": "npx",
"args": ["-y", "@pictify/mcp-server"],
"env": {
"PICTIFY_API_KEY": "your_api_key"
}
}
}
}
Windsurf
Adicione nas configurações de MCP do Windsurf:
{
"mcpServers": {
"pictify": {
"command": "npx",
"args": ["-y", "@pictify/mcp-server"],
"env": {
"PICTIFY_API_KEY": "your_api_key"
}
}
}
}
Exemplos
Experimente estes prompts após conectar:
Criar um card para redes sociais:
"Crie uma imagem de card para Twitter para minha postagem de blog intitulada 'Getting Started with MCP' com fundo em gradiente azul, 1200x630."
Capturar tela de um site:
"Tire uma captura de tela de stripe.com em 1440x900."
Renderizar um modelo:
"Liste meus modelos e renderize o modelo blog-header com o título 'Hello World'."
Gerar imagens em lote:
"Use meu modelo team-badge para gerar imagens para estes 10 membros da equipe: ..."
Criar uma fatura em PDF:
"Renderize meu modelo de fatura como PDF com nome da empresa 'Acme Inc', valor '$1,500' e data 'Março de 2026'."
Ferramentas Disponíveis
Geração de Imagens
| Ferramenta | Descrição |
|---|---|
pictify_create_image | Gera uma imagem a partir de HTML/CSS, captura de tela de URL ou modelo |
pictify_create_canvas_image | Gera uma imagem a partir de dados JSON de canvas FabricJS |
pictify_list_images | Lista imagens geradas anteriormente |
pictify_get_image | Obtém detalhes de uma imagem específica por ID |
Criação de GIFs
| Ferramenta | Descrição |
|---|---|
pictify_create_gif | Cria GIF animado a partir de HTML com animações CSS |
pictify_capture_gif | Grava um GIF de uma página web ao vivo ao longo do tempo |
pictify_list_gifs | Lista GIFs gerados anteriormente |
pictify_get_gif | Obtém detalhes de um GIF específico por ID |
Geração de PDF
| Ferramenta | Descrição |
|---|---|
pictify_render_pdf | Gera PDF de página única a partir de um modelo |
pictify_render_multi_page_pdf | Gera PDF de múltiplas páginas a partir de um modelo |
pictify_list_pdf_presets | Lista predefinições de tamanho de página PDF disponíveis |
Gerenciamento de Modelos
| Ferramenta | Descrição |
|---|---|
pictify_list_templates | Lista modelos salvos com filtragem e paginação |
pictify_get_template | Obtém detalhes do modelo |
pictify_get_template_variables | Obtém definições e tipos de variáveis do modelo |
pictify_render_template | Renderiza um modelo com variáveis (suporta variantes de layout) |
pictify_create_template | Cria um novo modelo (HTML ou FabricJS) |
pictify_update_template | Atualiza um modelo existente |
pictify_delete_template | Exclui um modelo |
Operações em Lote
| Ferramenta | Descrição |
|---|---|
pictify_batch_render | Inicia trabalho de renderização em lote (até 100 itens, assíncrono) |
pictify_get_batch_results | Verifica o status do trabalho em lote e obtém URLs de resultados |
pictify_cancel_batch | Cancela um trabalho em lote em execução |
Configuração
| Variável | Descrição | Padrão |
|---|---|---|
PICTIFY_API_KEY | Sua chave de API da Pictify (obrigatória no modo stdio) | — |
PICTIFY_BASE_URL | URL base personalizada da API | https://api.pictify.io |
PICTIFY_DEBUG | Ativa registro detalhado (logging) em stderr | false |
PICTIFY_MCP_SOURCE | Slug que identifica de onde este servidor MCP foi instalado (ex.: mcp.so, glama, smithery, claude_desktop_gallery, github). Enviado como X-Pictify-MCP-Source em cada chamada de API para que a Pictify possa atribuir instalações por diretório. | unknown |
Atribuição de instalação
Ao enviar @pictify/mcp-server para um diretório de MCP, defina
PICTIFY_MCP_SOURCE no trecho de instalação para que possamos atribuir
cadastros a essa listagem. Exemplo para a entrada do diretório mcp.so:
{
"mcpServers": {
"pictify": {
"command": "npx",
"args": ["-y", "@pictify/mcp-server"],
"env": {
"PICTIFY_API_KEY": "your_api_key",
"PICTIFY_MCP_SOURCE": "mcp.so"
}
}
}
}
Para o servidor remoto hospedado (https://mcp.pictify.io), passe o slug como
parâmetro de consulta na URL do conector — o servidor o persiste na
sessão OAuth:
https://mcp.pictify.io?source=mcp.so
Slugs aceitos: letras minúsculas, dígitos, ., -, _, até 64
caracteres. Qualquer outra coisa é descartada para unknown.
Desenvolvimento
git clone https://github.com/pictify-io/pictify-mcp.git
cd pictify-mcp
npm install
npm run build
Teste com o MCP Inspector:
PICTIFY_API_KEY=your_key npm run inspector
Licença
MIT