MCP — conecte um agente de IA

Um agente como o Claude controla este editor diretamente.

Com login, isso também funciona em photovim.com. Obtenha um código de conexão abaixo e execute uma linha no seu próprio computador. O código vale por alguns minutos e se conecta somente à sua aba.

O que muda

O que o agente cria continua sendo um documento editável, não uma única imagem achatada.

  • O texto chega como camadas de texto e o fundo como uma camada própria, então mudar o texto ou uma cor é feito ali mesmo.
  • O que o agente faz é uma etapa de desfazer. Se não gostar, Ctrl+Z desfaz.
  • Roda na aba que você está vendo — mesmo documento, mesmo histórico de desfazer.

Obter um código de conexão

Mantenha uma aba do editor aberta, obtenha um código e cole a linha abaixo em um terminal no seu próprio computador. O código expira em alguns minutos.

Faça login para obter um código

Conectar sem instalar (remoto)

Como no Canva e no Figma, basta uma URL. Não precisa de Node. No Claude Code, a linha abaixo é tudo de que você precisa; quando você obtém um código, o campo é preenchido.

claude mcp add --transport http photovim https://photovim.com/mcp --header "Authorization: Bearer código de conexão"

Outros clientes usam a URL https://photovim.com/mcp com um cabeçalho Authorization: Bearer código, ou https://photovim.com/mcp/código se não puderem enviar cabeçalhos. Remotamente não há open_file (ele usa um caminho no seu computador), e export retorna png/jpg/webp apenas como imagens.

Conectar com o pacote (npx)

Adicione o seguinte à configuração MCP do seu cliente. Basta ter Node 22 ou mais recente — nada para instalar. Quando você obtiver um código acima, o campo do código será preenchido.

{
  "mcpServers": {
    "photovim": {
      "command": "npx",
      "args": ["-y", "@photovim/mcp", "--url", "wss://photovim.com/cable", "--code", "código de conexão"]
    }
  }
}

Por cliente

Claude Code
Coloque em .mcp.json na sua pasta de trabalho, ou adicione com claude mcp add photovim -- npx -y @photovim/mcp --url … --code ….
Claude Desktop · Cursor
Adicione como está em mcpServers no claude_desktop_config.json e reinicie o Claude Desktop.
Codex
O mesmo command e args em [mcp_servers.photovim] no ~/.codex/config.toml.

Como saber se está conectado

Veja MCP, à direita de Ajuda na barra de menus do editor. O ponto no botão mostra o estado atual.

  • Verde — conectado. Quando um agente executa algo, o nome dele também aparece.
  • Amarelo — conectando, ou reconectando depois que a conexão caiu.
  • Vermelho — não foi possível entrar. Verifique o token ou o servidor.

O que já funciona

Abrir e salvar documentos, seleções, criar, organizar, transformar e ajustar camadas, adicionar e editar texto, pintar traçados de pincel, remover fundos, selecionar assuntos, geração com IA, desfazer — 34 ferramentas no total.

FerramentaO que fazTipo
Conectar
list_tabsAbas do editor abertas agoraLeitura
attachConecta a uma aba do editor — as ferramentas seguintes rodam nela (mesmo documento, mesmo desfazer)Seleção
get_capabilitiesO que este editor pode fazer agora — formatos, nomes de ajustes, modelosLeitura
Documento
open_fileAbre uma imagem, PSD, .photovim ou TIFF em uma nova abaAlteração (entra no Desfazer)
new_documentCria um documento vazioAlteração (entra no Desfazer)
list_documentsDocumentos abertos (abas)Leitura
select_documentEscolhe um documento (aba)Seleção
exportSalva o documento em um arquivo (.png .jpg .webp .psd .photovim)Leitura
Visualizar
get_stateEstado do documento — tamanho, revisão, árvore de camadas, seleção, níveis de desfazerLeitura
list_layersLista e estado das camadas (igual a get_state)Leitura
screenshotA composição atual em PNGLeitura
Seleção
rect_selectSeleção retangular (coordenadas do documento)Seleção
select_subjectEncontra o assunto com o modelo no navegador e o seleciona (a foto não sai do computador)Seleção
deselectLimpa a seleçãoSeleção
selection_to_maskTransforma a seleção na máscara da camada ativaAlteração (entra no Desfazer)
Camadas
select_layerTorna uma camada ativa (por id ou índice)Seleção
add_layerAdiciona uma camada vazia no topoAlteração (entra no Desfazer)
set_layer_propsNome, visibilidade, opacidade e modo de mesclagem da camadaAlteração (entra no Desfazer)
move_layerMove uma camada (dx/dy relativo ou x/y absoluto)Alteração (entra no Desfazer)
reorder_layerAltera a ordem das camadasAlteração (entra no Desfazer)
transform_layerRedimensiona ou gira uma camada (camadas de texto e objeto inteligente mantêm seus valores)Alteração (entra no Desfazer)
Pixels e ajustes
fill_selectionPreenche a seleção (ou a camada inteira) com uma cor — camadas de texto, forma e objeto inteligente são recusadas sem rasterize: trueAlteração (entra no Desfazer)
paint_strokesPinta traçados de pincel um a um (pontos, cor, tamanho, opacidade, dureza) — você pode vê-los surgir no editorAlteração (entra no Desfazer)
apply_adjustmentAplica um ajuste à camada ativa (brilho, níveis, curvas, matiz…) — camadas de texto e de forma são recusadas sem rasterize: true; objetos inteligentes recebem como filtro inteligenteAlteração (entra no Desfazer)
remove_backgroundRemove o fundo com o modelo no navegadorAlteração (entra no Desfazer)
resize_imageRedimensiona a imagem (todas as camadas juntas)Alteração (entra no Desfazer)
cropCorta o documento em um retânguloAlteração (entra no Desfazer)
Texto
add_textCria uma camada de textoAlteração (entra no Desfazer)
edit_textAltera o conteúdo, a posição ou a formatação de uma camada de textoAlteração (entra no Desfazer)
Geração com IA
list_ai_modelsModelos disponíveis para geração com IA, os créditos que cada execução custa e seus créditos restantesLeitura
generate_imageEdita com IA (seleção ou imagem inteira), cria uma nova imagem a partir de texto ou remove — o resultado vai para uma nova camada. Modelos de crédito gastam seus créditosAlteração (entra no Desfazer)
ai_job_statusContinua aguardando uma geração demorada e obtém o resultado (novas camadas, créditos gastos)Leitura
Lote e desfazer
batchExecuta vários comandos como um pacote — uma etapa de desfazer. Com onError=rollback, uma falha reverte o pacote inteiroAlteração (entra no Desfazer)
undoDesfaz a última açãoAlteração (entra no Desfazer)

Limites

Os limites são por pessoa. Um comando conta como uma chamada; um batch conta cada uma de suas etapas. Leituras e gravações contam igual. Acima do limite, o comando recebe na hora uma resposta de "limite atingido".

Agora (todos)
Por minuto300 chamadas
Por dia20,000 chamadas
Agentes conectados ao mesmo tempo10

Ainda não: resultados de uma só vez, como "faça um banner para mim", estão planejados. Hoje você controla as 34 ferramentas uma de cada vez.

Voltar ao editor