Conecta un asistente de IA a PrintTiler con MCP

Inicio rápido

1. Activa MCP en PrintTiler (está desactivado de forma predeterminada).
2. Autoriza carpetas y configura un cliente STDIO local compatible.
3. Revisa el estado y la vista previa; aprueba antes de exportar el PDF.

Flujo de ejemplo

Prompts ilustrativos; no son una transcripción real.

1. Lee el estado actual de PrintTiler e informa las columnas, filas y páginas reales. No cambies nada.

2. Abre /Users/me/Documents/poster.png (entrada autorizada). Configura A4 vertical, Custom Fit, 2 páginas horizontales y 3 verticales. Previsualiza e informa el total real; el bloqueo de aspecto puede cambiarlo. DETENTE: no exportes.

3. Comprueba el estado y la vista previa, DETENTE y pide mi aprobación. Solo después de que apruebe, exporta un PDF a /Users/me/Documents/output.pdf.

La cuadrícula solicitada puede respetar el bloqueo de proporción: comprueba el recuento real en la vista previa; 2 × 3 no garantiza seis páginas.

Requisitos

PrintTiler 1.14.0 o posterior en macOS 12 o posterior y un cliente MCP local de confianza ya instalado que admita servidores STDIO. Esta guía es para clientes locales, no conectores web remotos. El servicio de PrintTiler no requiere instalar Python, Node ni Swift; el cliente sí debe estar instalado.

Configurar el cliente

1. En PrintTiler, abre Settings → MCP → Enable. MCP está desactivado de forma predeterminada y la app recuerda tu elección.
2. Abre Settings → MCP → Setup MCP… y elige el cliente. Copia la ruta real del ejecutable generada por la app; no supongas que está en /Applications.
3. Pulsa File Access… en la esquina inferior izquierda de Setup MCP. Con Add Folder… autoriza carpetas de entrada para lectura y de salida para lectura/escritura. Son listas separadas; Remove revoca el permiso elegido.
4. Sigue las instrucciones del cliente correspondiente y cierra Setup MCP antes de pedir al asistente que use herramientas.

Formatos de configuración

Los valores generados por la app son la referencia; lo siguiente es ilustrativo. Los clientes JSON usan comando y argumentos STDIO; los TOML, una tabla de servidor y tiempo de espera. Copia siempre los valores actuales de Configurar MCP. No hace falta una URL remota ni un lanzador “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

Acceso a archivos y privacidad

Acceso a archivos… mantiene listas separadas: carpetas de entrada de solo lectura y de salida de lectura/escritura. Puedes añadir o quitar varias. Una carpeta de entrada no incluida solicita autorización a nivel de directorio. Para sobrescribir un archivo existente se pide confirmación mediante elicitation si el cliente lo admite; si no, se usa el panel de guardado de macOS. Un archivo nuevo en una carpeta de salida autorizada puede guardarse sin otro diálogo. La vista previa de ejemplo puede enviar contenido de imagen y metadatos de diseño al asistente; se aplican las políticas del proveedor. PrintTiler no carga archivos en sus servidores. MCP no imprime: no existe herramienta de impresión. Desactívalo en Ajustes > MCP y revoca permisos de carpetas cuando quieras.

Usar las cinco herramientas

Hay cinco herramientas: printtiler_get_state, printtiler_open_document, printtiler_set_layout, printtiler_preview y printtiler_export_pdf. Actúan sobre la ventana del documento en primer plano; no la edites simultáneamente. Secuencia segura: consultar estado, abrir archivo local autorizado, configurar diseño, previsualizar y exportar PDF. Una cuadrícula 3×2 no garantiza seis páginas exactas: comprueba columnas, filas y páginas reales antes de exportar.

Si PrintTiler no está abierto, la primera llamada real a una herramienta puede abrir la app. MCP debe haberse activado previamente; una llamada nunca lo activa sin avisar.

Ejemplo de instrucción

Ejemplo: «Lee el estado actual y abre /Users/me/Documents/input.png. Configura A4 vertical, Custom Fit, 3 páginas de ancho y 2 de alto. Muestra la vista previa y las columnas, filas y páginas reales. DETENTE y pide mi aprobación. Solo después de que apruebe, exporta a /Users/me/Documents/output.pdf». Sustituye las rutas por rutas absolutas locales autorizadas. Tras un tiempo de espera agotado, revisa el resultado antes de reintentar.

Solución de problemas

Si moviste la app, copia la configuración recién generada. Si la ventana de configuración está ocupada, ciérrala antes de usar herramientas. Ante un permiso denegado, autoriza la carpeta en la app; no lo eludas con chmod. Para una configuración inválida, comprueba el soporte STDIO local del cliente y aísla su configuración. No todos los clientes llamados Claude o Codex están probados ni tienen compatibilidad garantizada. El servidor espera 180 segundos, incluidos los diálogos; el cliente debe esperar más (Codex genera 210). Tras un tiempo agotado, comprueba si ya existe la salida antes de reintentar.

Impresión PDF · Solapamiento · Tamaño A4

Consulta también las guías de PDF, solapamiento y tamaño de papel, y la política de privacidad.

• Impresión PDF
• Solapamiento
• Tamaño A4
• Privacidad