Collega un assistente IA a PrintTiler con MCP

Avvio rapido

1. Attiva MCP in PrintTiler (disattivato per impostazione predefinita).
2. Autorizza le cartelle e configura un client STDIO locale compatibile.
3. Controlla stato e anteprima; approva prima di esportare il PDF.

Esempio di flusso

Prompt illustrativi, non una trascrizione reale.

1. Leggi lo stato attuale di PrintTiler e indica colonne, righe e pagine effettive. Non modificare nulla.

2. Apri /Users/me/Documents/poster.png (file di input autorizzato). Imposta A4 verticale, Custom Fit, 2 pagine in orizzontale e 3 in verticale. Mostra l’anteprima e indica il totale effettivo; il blocco delle proporzioni può influirvi. FERMATI: non esportare.

3. Controlla lo stato e l’anteprima, poi FERMATI e chiedi la mia approvazione. Esporta il PDF in /Users/me/Documents/output.pdf solo dopo la mia approvazione.

La griglia richiesta può rispettare il blocco delle proporzioni: controlla il conteggio effettivo nell’anteprima; 2 × 3 non garantisce sei pagine.

Requisiti

PrintTiler 1.14.0 o successivo su macOS 12 o successivo e un client MCP locale affidabile già installato che supporti server STDIO. Questa guida riguarda i client locali, non i connettori Web remoti. Il servizio PrintTiler non richiede installazioni aggiuntive di Python, Node o Swift; il client deve essere installato.

Configurare il client

1. In PrintTiler apri Settings → MCP → Enable. MCP è disattivato per impostazione predefinita e l’app ricorda la scelta.
2. Apri Settings → MCP → Setup MCP… e scegli il client. Copia il percorso effettivo dell’eseguibile generato dall’app; non presumere che sia in /Applications.
3. Premi File Access… in basso a sinistra in Setup MCP. Add Folder… autorizza le cartelle di input in lettura e quelle di output in lettura/scrittura. Gli elenchi sono separati; Remove revoca il permesso selezionato.
4. Segui le istruzioni del client qui sotto e chiudi Setup MCP prima di chiedere all’assistente di usare gli strumenti.

Formati di configurazione

I valori generati dall’app sono quelli corretti; quanto segue è illustrativo. I client JSON usano comando e argomenti STDIO; quelli TOML una tabella server e un timeout. Copia sempre i valori correnti mostrati da Configura MCP. Non serve un URL server remoto né un avvio “open -a”.

{
  "mcpServers": {
    "printtiler": {
      "command": "<executable path shown by Setup MCP>",
      "args": ["--mcp-stdio"]
    }
  }
}

[mcp_servers.printtiler]
command = "<executable path shown by Setup MCP>"
args = ["--mcp-stdio"]
tool_timeout_sec = 210

Accesso ai file e privacy

Accesso ai file… gestisce elenchi separati: cartelle input in sola lettura e output in lettura/scrittura. Puoi aggiungere o rimuovere più cartelle. Una cartella input non autorizzata richiede l’autorizzazione a livello di directory. La sovrascrittura di file esistenti richiede conferma tramite elicitation se supportata dal client, altrimenti usa il pannello di salvataggio macOS. Un nuovo file in una cartella output autorizzata può essere salvato senza altri dialoghi. L’anteprima d’esempio può trasmettere all’assistente contenuto immagine e metadati del layout; valgono le policy del provider. PrintTiler non carica file sui propri server. MCP non stampa: non esiste uno strumento di stampa. Disattiva in Impostazioni > MCP e revoca gli accessi alle cartelle quando vuoi.

Usare i cinque strumenti

Gli strumenti sono cinque: printtiler_get_state, printtiler_open_document, printtiler_set_layout, printtiler_preview e printtiler_export_pdf. Operano sulla finestra del documento in primo piano; evita modifiche simultanee. Sequenza sicura: leggi stato, apri file locale autorizzato, imposta layout, visualizza anteprima, esporta PDF. Una griglia 3×2 non garantisce esattamente sei pagine: verifica colonne, righe e pagine effettive prima di esportare.

Se PrintTiler non è in esecuzione, la prima chiamata effettiva a uno strumento può aprire l’app. MCP deve essere stato abilitato prima; una chiamata non lo abilita mai di nascosto.

Esempio di prompt

Esempio: «Leggi lo stato attuale e apri /Users/me/Documents/input.png. Imposta A4 verticale, Custom Fit, 3 pagine in larghezza e 2 in altezza. Mostra l’anteprima e colonne, righe e pagine effettive. FERMATI e chiedi la mia approvazione. Solo dopo il mio consenso esporta in /Users/me/Documents/output.pdf». Sostituisci i percorsi con percorsi assoluti locali autorizzati. Dopo un timeout controlla l’output prima di riprovare.

Risoluzione dei problemi

Se hai spostato l’app, copia la configurazione appena generata. Se la finestra di configurazione è occupata, chiudila prima degli strumenti. In caso di permesso negato, autorizza la cartella nell’app; non aggirare con chmod. Per configurazioni non valide, verifica il supporto STDIO locale del client e isola la configurazione. Non tutti i client con nome Claude o Codex sono testati o garantiti compatibili. Timeout server 180 secondi, dialoghi inclusi; il client deve attendere di più (valore Codex generato: 210). Dopo il timeout verifica l’output prima di riprovare.

Stampa PDF · Sovrapposizione · Formato A4

Consulta anche le guide PDF, sovrapposizione e formato carta, oltre all’informativa sulla privacy.

• Stampa PDF
• Sovrapposizione
• Formato A4
• Privacy