Ligue um assistente de IA ao PrintTiler com MCP

Início rápido

1. Ative o MCP no PrintTiler (desligado por predefinição).
2. Autorize pastas e configure um cliente STDIO local compatível.
3. Reveja o estado e a pré-visualização; aprove antes de exportar o PDF.

Exemplo de fluxo

Prompts ilustrativos, não uma transcrição real.

1. Leia o estado atual do PrintTiler e informe as colunas, linhas e páginas reais. Não altere nada.

2. Abra /Users/me/Documents/poster.png (entrada autorizada). Defina A4 vertical, Custom Fit, 2 páginas na horizontal e 3 na vertical. Pré-visualize e informe o total real; o bloqueio de proporção pode afetá-lo. PARE: não exporte.

3. Verifique a prontidão e a pré-visualização, PARE e peça a minha aprovação. Só depois de aprovar, exporte o PDF para /Users/me/Documents/output.pdf.

A grelha pedida pode respeitar o bloqueio de proporção: verifique o total real na pré-visualização; 2 × 3 não garante seis páginas.

Requisitos

PrintTiler 1.14.0 ou posterior no macOS 12 ou posterior e um cliente MCP local de confiança já instalado, com suporte para servidores STDIO. Este guia cobre clientes locais, não conectores Web remotos. O serviço PrintTiler não exige instalação adicional de Python, Node ou Swift; o cliente tem de estar instalado.

Configurar o cliente

1. No PrintTiler, abra Settings → MCP → Enable. MCP está desativado por predefinição e a aplicação recorda a sua escolha.
2. Abra Settings → MCP → Setup MCP… e escolha o cliente. Copie o caminho real do executável gerado pela aplicação; não presuma que está em /Applications.
3. Clique em File Access… no canto inferior esquerdo de Setup MCP. Add Folder… autoriza pastas de entrada para leitura e de saída para leitura/escrita. As listas são separadas; Remove revoga a autorização escolhida.
4. Siga as instruções do cliente abaixo e feche Setup MCP antes de pedir ao assistente que utilize as ferramentas.

Formatos de configuração

Os valores gerados pela aplicação são a referência; o texto abaixo é ilustrativo. Clientes JSON usam comando e argumentos STDIO; clientes TOML usam tabela de servidor e limite de tempo. Copie sempre os valores atuais apresentados. Não é necessário URL de servidor remoto nem iniciador “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

Acesso a ficheiros e privacidade

Acesso a ficheiros… mantém listas separadas: pastas de entrada só de leitura e pastas de saída de leitura/escrita. Pode adicionar ou remover várias pastas. Pastas de entrada não autorizadas solicitam autorização ao nível do diretório. A substituição de ficheiros existentes pede confirmação por elicitation se o cliente suportar; caso contrário, usa o painel de gravação do macOS. Novos ficheiros numa pasta de saída autorizada podem ser gravados sem outro diálogo. A pré-visualização de exemplo pode enviar conteúdo de imagem e metadados de layout ao assistente; aplicam-se as políticas do fornecedor. O PrintTiler não carrega ficheiros para os seus servidores. MCP não imprime: não existe ferramenta de impressão. Desative em Definições > MCP e revogue acessos às pastas quando quiser.

Usar as cinco ferramentas

Existem cinco ferramentas: printtiler_get_state, printtiler_open_document, printtiler_set_layout, printtiler_preview e printtiler_export_pdf. Atuam na janela de documento em primeiro plano; evite editá-la simultaneamente. Sequência segura: consultar estado, abrir ficheiro local autorizado, definir layout, pré-visualizar e exportar PDF. Uma grelha 3×2 não garante exatamente seis páginas: confirme colunas, linhas e páginas reais antes de exportar.

Se o PrintTiler não estiver aberto, a primeira chamada real a uma ferramenta pode abrir a aplicação. MCP tem de ter sido ativado anteriormente; uma chamada nunca o ativa silenciosamente.

Exemplo de pedido

Exemplo: «Consulta o estado atual e abre /Users/me/Documents/input.png. Define A4 vertical, Custom Fit, 3 páginas na largura e 2 na altura. Mostra a pré-visualização e as colunas, linhas e páginas reais. PARE e peça a minha aprovação. Só depois de eu aprovar, exporta para /Users/me/Documents/output.pdf.» Substitua os caminhos por caminhos absolutos locais autorizados. Após um tempo limite, verifique a saída antes de repetir.

Resolução de problemas

Se moveu a aplicação, copie a configuração recém-gerada. Se a janela de configuração estiver ocupada, feche-a antes das ferramentas. Em caso de permissão negada, autorize a pasta na aplicação; não contorne com chmod. Para configuração inválida, confirme o suporte STDIO local do cliente e isole a configuração. Nem todos os clientes Claude ou Codex foram testados nem têm compatibilidade garantida. O servidor expira aos 180 segundos, incluindo diálogos; o cliente deve permitir mais (Codex gera 210). Após expirar, verifique se a saída já foi criada antes de repetir.

Impressão PDF · Sobreposição · Tamanho A4

Consulte também os guias de PDF, sobreposição e tamanho do papel, e a política de privacidade.

• Impressão PDF
• Sobreposição
• Tamanho A4
• Privacidade