MCP — collega un agente AI

Un agente come Claude controlla direttamente questo editor.

Se hai effettuato l'accesso, funziona anche su photovim.com. Ottieni qui sotto un codice di connessione ed esegui una riga sul tuo computer. Il codice dura pochi minuti e si collega solo alla tua scheda.

Cosa cambia

Ciò che crea l'agente resta un documento modificabile, non un'unica immagine appiattita.

  • Il testo arriva come livelli di testo e lo sfondo come livello a sé, così cambiare una frase o un colore si fa direttamente lì.
  • Ciò che fa l'agente è un solo passo di annullamento. Se non ti piace, Ctrl+Z lo annulla.
  • Viene eseguito nella scheda che stai guardando — stesso documento, stessa cronologia di annullamento.

Ottieni un codice di connessione

Tieni aperta una scheda dell'editor, ottieni un codice e incolla la riga qui sotto in un terminale sul tuo computer. Il codice scade dopo pochi minuti.

Accedi per ottenere un codice

Collegati senza installare (remoto)

Come Canva e Figma, basta un URL. Non serve Node. Per Claude Code basta la riga qui sotto; quando ottieni un codice, lo spazio viene compilato.

claude mcp add --transport http photovim https://photovim.com/mcp --header "Authorization: Bearer codice di connessione"

Gli altri client usano l'URL https://photovim.com/mcp con un'intestazione Authorization: Bearer codice, oppure https://photovim.com/mcp/codice se non possono inviare intestazioni. In remoto non c'è open_file (richiede un percorso sul tuo computer) ed export restituisce png/jpg/webp solo come immagini.

Collegati con il pacchetto (npx)

Aggiungi quanto segue alla configurazione MCP del tuo client. Ti basta Node 22 o successivo — non c'è nulla da installare. Quando ottieni un codice qui sopra, lo spazio del codice viene compilato.

{
  "mcpServers": {
    "photovim": {
      "command": "npx",
      "args": ["-y", "@photovim/mcp", "--url", "wss://photovim.com/cable", "--code", "codice di connessione"]
    }
  }
}

Per client

Claude Code
Inseriscilo in .mcp.json nella tua cartella di lavoro, oppure aggiungilo con claude mcp add photovim -- npx -y @photovim/mcp --url … --code ….
Claude Desktop · Cursor
Aggiungilo così com'è sotto mcpServers in claude_desktop_config.json, poi riavvia Claude Desktop.
Codex
Stessi command e args sotto [mcp_servers.photovim] in ~/.codex/config.toml.

Come capire se è collegato

Guarda MCP, a destra di Aiuto nella barra dei menu dell'editor. Il punto nel pulsante indica lo stato attuale.

  • Verde — collegato. Quando un agente esegue qualcosa, ne viene mostrato anche il nome.
  • Giallo — connessione in corso, o riconnessione dopo un'interruzione.
  • Rosso — impossibile collegarsi. Controlla il token o il server.

Cosa funziona oggi

Apertura e salvataggio dei documenti, selezioni, creazione, disposizione, trasformazione e regolazione dei livelli, aggiunta e modifica del testo, pennellate, rimozione dello sfondo, selezione del soggetto, generazione AI, annullamento — 34 strumenti in tutto.

StrumentoCosa faTipo
Connessione
list_tabsSchede dell'editor aperte in questo momentoLettura
attachCollegati a una scheda dell'editor — gli strumenti successivi vengono eseguiti lì (stesso documento, stessi annullamenti)Selezione
get_capabilitiesCosa può fare ora questo editor — formati, nomi delle regolazioni, modelliLettura
Documento
open_fileApre un'immagine, un PSD, un file .photovim o TIFF in una nuova schedaModifica (va in Annulla)
new_documentCrea un documento vuotoModifica (va in Annulla)
list_documentsDocumenti aperti (schede)Lettura
select_documentSceglie un documento (scheda)Selezione
exportSalva il documento su file (.png .jpg .webp .psd .photovim)Lettura
Vista
get_stateStato del documento — dimensioni, revisione, albero dei livelli, selezione, livelli di annullamentoLettura
list_layersElenco e stato dei livelli (come get_state)Lettura
screenshotLa composizione attuale in PNGLettura
Selezione
rect_selectSelezione rettangolare (coordinate del documento)Selezione
select_subjectTrova il soggetto con il modello nel browser e lo seleziona (la foto non esce mai)Selezione
deselectDeselezionaSelezione
selection_to_maskTrasforma la selezione nella maschera del livello attivoModifica (va in Annulla)
Livelli
select_layerRende attivo un livello (per id o index)Selezione
add_layerAggiunge un livello vuoto in cimaModifica (va in Annulla)
set_layer_propsNome, visibilità, opacità e metodo di fusione del livelloModifica (va in Annulla)
move_layerSposta un livello (dx/dy relativi o x/y assoluti)Modifica (va in Annulla)
reorder_layerCambia l'ordine dei livelliModifica (va in Annulla)
transform_layerRidimensiona o ruota un livello (i livelli di testo e oggetto avanzato conservano i valori)Modifica (va in Annulla)
Pixel e regolazioni
fill_selectionRiempie la selezione (o l'intero livello) con un colore — i livelli di testo, forma e oggetto avanzato sono rifiutati senza rasterize: trueModifica (va in Annulla)
paint_strokesDipinge pennellate una alla volta (punti, colore, dimensione, opacità, durezza) — puoi vederle comparire nell'editorModifica (va in Annulla)
apply_adjustmentApplica una regolazione al livello attivo (luminosità, livelli, curve, tonalità…) — i livelli di testo e forma vengono rifiutati senza rasterize: true; gli oggetti avanzati la ricevono come filtro avanzatoModifica (va in Annulla)
remove_backgroundRimuove lo sfondo con il modello nel browserModifica (va in Annulla)
resize_imageRidimensiona l'immagine (tutti i livelli insieme)Modifica (va in Annulla)
cropRitaglia il documento su un rettangoloModifica (va in Annulla)
Testo
add_textCrea un livello di testoModifica (va in Annulla)
edit_textModifica contenuto, posizione o formattazione di un livello di testoModifica (va in Annulla)
Generazione AI
list_ai_modelsModelli disponibili per la generazione AI, crediti richiesti per ogni esecuzione e crediti rimanentiLettura
generate_imageModifica con l'AI (selezione o intera immagine), crea una nuova immagine da testo o rimuovi — il risultato va su un nuovo livello. I modelli a crediti consumano i tuoi creditiModifica (va in Annulla)
ai_job_statusContinua ad attendere una generazione lunga e ottieni il risultato (nuovi livelli, crediti spesi)Lettura
Batch e annulla
batchEsegue più comandi come un unico blocco — un solo passo di annullamento. Con onError=rollback un errore annulla l'intero bloccoModifica (va in Annulla)
undoAnnulla l'ultima azioneModifica (va in Annulla)

Limiti

I limiti sono per persona. Un comando conta come una chiamata; un batch conta ciascuno dei suoi passi. Letture e scritture contano allo stesso modo. Oltre il limite, il comando riceve subito una risposta "limite raggiunto".

Ora (tutti)
Al minuto300 chiamate
Al giorno20,000 chiamate
Agenti collegati contemporaneamente10

Non ancora: sono previsti risultati in un solo passaggio come "fammi un banner". Per ora usi i 34 strumenti uno alla volta.

Torna all'editor