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)
- Renderizar vídeos e GIFs animados 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
Claude.ai (Web)
Use o servidor remoto hospedado — sem instalação, sem chave de API:
- Acesse claude.ai > Configurações > Conectores
- Clique em Adicionar conector personalizado
- URL:
https://mcp.pictify.io - Clique em Adicionar e depois em Conectar — você fará login no Pictify e aprovará o acesso
Nada precisa ser preenchido nas Configurações Avançadas. A conexão aparecerá em Aplicativos conectados nas suas configurações do Pictify, onde você pode desconectá-la a qualquer momento.
Pré-requisitos para o servidor local
O pacote npm autentica com uma chave de API em vez de login pelo navegador:
- Cadastre-se ou faça login em pictify.io
- Acesse API Tokens
- Crie um novo token e copie-o
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 às configurações de MCP do Cursor (Settings > MCP Servers):
{
"mcpServers": {
"pictify": {
"command": "npx",
"args": ["-y", "@pictify/mcp-server"],
"env": {
"PICTIFY_API_KEY": "your_api_key"
}
}
}
}
Windsurf
Adicione às 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 'Começando com 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 'Olá Mundo'."
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 | Gere uma imagem a partir de HTML/CSS, captura de tela de URL ou um modelo |
pictify_get_image | Obtenha detalhes de uma imagem específica por ID |
Histórico de Renderização
| Ferramenta | Descrição |
|---|---|
pictify_list_renders | Liste tudo o que foi renderizado — imagens, GIFs, PDFs e vídeos em um único feed |
Gerenciamento de Modelos
| Ferramenta | Descrição |
|---|---|
pictify_list_templates | Liste modelos salvos com filtragem e paginação |
pictify_get_template | Obtenha detalhes de um modelo |
pictify_get_template_variables | Obtenha definições e tipos de variáveis de um modelo |
pictify_render_template | Renderize um modelo com variáveis — imagens e PDFs (format: 'pdf') |
pictify_multi_size_render | Renderize um modelo em vários tamanhos em uma única chamada |
pictify_create_template | Crie um novo modelo (HTML ou FabricJS) |
pictify_update_template | Atualize um modelo existente |
pictify_delete_template | Exclua um modelo |
pictify_validate_expression | Verifique se uma expressão {{ }} é analisada corretamente antes de usá-la |
pictify_list_expression_functions | Liste as funções disponíveis dentro de expressões |
Operações em Lote
| Ferramenta | Descrição |
|---|---|
pictify_batch_render | Inicie um trabalho de renderização em lote (até 100 itens, assíncrono) |
pictify_get_batch_results | Verifique o status do trabalho em lote e obtenha URLs de resultados |
pictify_cancel_batch | Cancele um trabalho em lote em execução |
Vídeo
| Ferramenta | Descrição |
|---|---|
pictify_list_video_templates | Liste seus modelos de vídeo Remotion |
pictify_get_video_template | Obtenha um modelo de vídeo completo |
pictify_get_video_template_variables | Descubra as variáveis que um modelo de vídeo espera |
pictify_render_video | Renderize um modelo de vídeo em MP4 ou GIF |
pictify_create_video_template | Envie sua própria cena Remotion como modelo |
pictify_generate_video_template | Gere um modelo de vídeo a partir de um prompt de texto |
pictify_update_video_template | Atualize o nome, tamanho, duração ou código de um modelo de vídeo |
pictify_duplicate_video_template | Copie um modelo de vídeo |
pictify_delete_video_template | Exclua um modelo de vídeo |
Configuração
| Variável | Descrição | Padrão |
|---|---|---|
PICTIFY_API_KEY | Sua chave de API do Pictify (obrigatória para o modo stdio) | — |
PICTIFY_BASE_URL | URL base personalizada da API | https://api.pictify.io |
PICTIFY_DEBUG | Ative o registro detalhado 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 o Pictify possa atribuir instalações por diretório. | unknown |
PICTIFY_ANALYTICS_DISABLED | Defina como 1, true ou yes para não enviar nenhuma análise de uso | false |
Hospedar o servidor HTTP por conta própria adiciona MCP_PORT, MCP_PUBLIC_URL (a origem pública, usada para construir o documento de metadados de recursos protegidos) e PICTIFY_AUTH_SERVER_URL (o servidor de autorização OAuth para apontar os clientes, com padrão https://api.pictify.io; PICTIFY_AUTH_SERVER também é aceito).
Análise de uso
Este servidor reporta o uso de ferramentas ao PostHog para que possamos ver quais ferramentas os agentes utilizam e quais falham. Cada chamada registra o nome da ferramenta, seus argumentos e resultado, tempo de execução, se houve erro, a intenção declarada, o nome e versão do seu cliente e — quando uma chave de API resolve para uma conta — seu e-mail e plano.
Argumentos e resultados significam o HTML, URLs, prompts e variáveis de modelo que você envia. Se isso não for aceitável para o seu uso, defina PICTIFY_ANALYTICS_DISABLED=1 e nada será enviado.
Atribuição de instalação
Ao enviar @pictify/mcp-server para um diretório MCP, defina PICTIFY_MCP_SOURCE no trecho de instalação para que possamos atribuir inscrições 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 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