Connecter un assistant IA à PrintTiler avec MCP
Un client IA local compatible permet de préparer une mise en page en mosaïque dans PrintTiler. Vous gardez le contrôle des fichiers, de l’aperçu et de l’export PDF.
Démarrage rapide
- Activez MCP dans PrintTiler (désactivé par défaut).
- Autorisez les dossiers et configurez un client STDIO local compatible.
- Vérifiez l’état et l’aperçu ; approuvez avant l’export PDF.
Exemple de workflow
Prompts illustratifs uniquement, pas une transcription réelle.
Lis l’état actuel de PrintTiler et indique les colonnes, lignes et pages réelles. Ne modifie rien.Ouvre /Users/me/Documents/poster.png (entrée autorisée). Règle A4 portrait, Custom Fit, 2 pages en largeur et 3 en hauteur. Prévisualise et indique le nombre réel de pages ; le verrouillage des proportions peut le modifier. ARRÊTE-TOI : n’exporte pas.Vérifie l’état et l’aperçu, puis ARRÊTE-TOI et demande mon accord. Exporte le PDF vers /Users/me/Documents/output.pdf uniquement après mon accord.
La grille demandée peut respecter le verrouillage des proportions : vérifiez le nombre réel dans l’aperçu ; 2 × 3 ne garantit pas six pages.
Scénarios de prompts pour le flux MCP
Copiez un prompt prêt, remplacez les espaces réservés par des chemins Mac absolus autorisés, puis collez-le dans votre client MCP. Ces exemples préparent ou vérifient des mises en page : la plupart s’arrêtent à l’aperçu, l’exemple d’export attend votre approbation explicite et MCP n’imprime pas — l’impression réelle reste manuelle dans l’app.
Affiche pour classe ou maison
Répartissez une image sur deux colonnes de largeur (across = 2) en A4 portrait, indiquez les lignes et pages réelles et arrêtez-vous avant tout export ou impression.
Voir le prompt
Lis l’état actuel de PrintTiler. Ouvre l’image dans <INPUT_PATH> et vérifie qu’elle est prête. Règle A4 portrait avec Custom Fit across=2 (deux colonnes en largeur), sans modifier le verrouillage du ratio actuel. Indique les colonnes, lignes et pages réelles, et affiche une première tuile de sortie depuis l’aperçu. ARRÊTE-TOI avant l’export et n’imprime pas.L’aperçu renvoie une tuile de sortie, pas l’affiche assemblée.
Comparer A4 portrait et Letter paysage
Comparez les deux papiers pris en charge avec les réglages actuels, puis restaurez le papier d’origine jusqu’à votre choix.
Voir le prompt
Avec le document PrintTiler actuel, lis l’état et note le papier et l’orientation actuels. Garde le même mode d’ajustement ainsi que la marge et le chevauchement actuels. Compare A4 portrait et Letter paysage ; les deux sont pris en charge. Pour chacun, indique le nombre réel de pages et affiche une première tuile de sortie. Restaure le papier et l’orientation d’origine, puis demande-moi lequel utiliser. N’exporte pas.Choisissez le papier réellement chargé dans l’imprimante ; cela ne promet pas moins de feuilles.
Illustration panoramique
Ajustez une illustration panoramique à la largeur Letter paysage avec Fit Width et vérifiez l’aperçu réel, qui peut tenir sur une seule page.
Voir le prompt
Ouvre l’illustration paysage dans <INPUT_PATH> et vérifie qu’elle est prête. Règle Letter paysage avec Fit Width. Indique les colonnes, lignes et pages réelles, et affiche une première tuile de sortie depuis l’aperçu. ARRÊTE-TOI ici et n’exporte pas.Vérifiez l’aperçu et le nombre réel de pages avant de choisir l’étape suivante.
Affiche depuis une page source PDF
Répartissez uniquement la page source 2 d’un PDF sur des pages A4 portrait, indiquez le nombre et arrêtez-vous avant l’export.
Voir le prompt
Ouvre le PDF dans <INPUT_PDF_PATH> et vérifie qu’il est prêt et combien de pages source il contient ; s’il en a moins de 2, arrête-toi. Sélectionne la page source 2 du PDF (base 1). Règle A4 portrait avec Custom Fit across=2 (deux colonnes en largeur), sans modifier le verrouillage du ratio actuel. Indique le nombre réel de pages et affiche une première tuile de sortie. ARRÊTE-TOI et n’exporte pas.Seule la page source sélectionnée est répartie, pas tout le PDF en lot.
Exporter après approbation explicite
Vérifiez la grille et la première tuile, puis exportez vers un nouveau PDF seulement après votre approbation.
Voir le prompt
Lis le document actuel, la page source, l’état de préparation et la grille réelle dans PrintTiler, et affiche une première tuile de sortie. ARRÊTE-TOI et demande mon approbation explicite. Seulement après mon approbation, exporte vers le nouveau fichier dans <OUTPUT_PDF_PATH>. Si ce fichier existe déjà, arrête-toi et demande-moi un nouveau nom au lieu de l’écraser. Vérifie d’abord la destination et n’exporte qu’une fois ; ne réessaie pas automatiquement après un délai. N’imprime pas.<OUTPUT_PDF_PATH> représente tout le chemin absolu .pdf, donc n’y ajoutez pas d’extension.
Remplacez <INPUT_PATH>, <INPUT_PDF_PATH> et <OUTPUT_PDF_PATH> par des chemins Mac absolus autorisés. La configuration MCP est requise au préalable. Ce sont des modèles de prompt illustratifs, pas un enregistrement de conversation exécutée. Un aperçu peut envoyer le contenu de l’image et des métadonnées de mise en page à votre assistant ou à son fournisseur. Ne modifiez pas le document manuellement pendant qu’une requête MCP s’exécute. Le verrouillage du ratio actuel n’est pas modifié et une grille demandée ne garantit pas un nombre fixe de pages. MCP n’imprime pas. Si votre client propose la saisie vocale, vous pouvez l’utiliser, mais PrintTiler n’est pas une interface vocale.
MCP n’imprime pas. MCP est désactivé par défaut et utilise un client STDIO local compatible. Autorisez les dossiers ; le contenu de l’aperçu peut être partagé avec votre assistant/fournisseur.
Prérequis
PrintTiler 1.14.0 ou ultérieur sous macOS 12 ou ultérieur, et un client MCP local fiable déjà installé prenant en charge les serveurs STDIO. Ce guide concerne les clients locaux, pas les connecteurs Web distants. Le service PrintTiler ne nécessite pas d’installation supplémentaire de Python, Node ou Swift ; le client doit être installé.
Configurer le client
- Dans PrintTiler, ouvrez Settings → MCP → Enable. MCP est désactivé par défaut et l’app mémorise votre choix.
- Ouvrez Settings → MCP → Setup MCP… et choisissez le client. Copiez le chemin réel de l’exécutable généré par l’app, sans supposer une installation dans /Applications.
- Cliquez sur File Access… en bas à gauche de Setup MCP. Add Folder… autorise les dossiers d’entrée en lecture et de sortie en lecture/écriture. Les listes sont distinctes ; Remove révoque l’autorisation choisie.
- Suivez les étapes du client ci-dessous, puis fermez Setup MCP avant de demander à l’assistant d’utiliser les outils.
Claude Desktop
- Ouvrez Settings → Developer → Edit Config. Sur Mac, le fichier est ~/Library/Application Support/Claude/claude_desktop_config.json.
- Fusionnez l’entrée générée mcpServers.printtiler dans un JSON valide en conservant les autres serveurs et paramètres. Enregistrez et redémarrez complètement Claude Desktop ; fermer une fenêtre ne suffit pas.
Claude Code
- Ouvrez un terminal dans le répertoire du projet voulu. Copiez et exécutez la commande générée par PrintTiler. La portée local par défaut concerne l’utilisateur et le projet actuels, pas tous les projets.
- Redémarrez Claude Code dans ce répertoire et vérifiez printtiler avec /mcp ou claude mcp list. Mettez à jour une entrée existante plutôt que de la dupliquer.
ChatGPT (Codex)
- Dans le mode Codex de l’app de bureau, ouvrez Settings → MCP Servers → Add server et choisissez STDIO. Ce n’est pas un connecteur distant de ChatGPT Web.
- Copiez chaque champ séparément : Name vaut printtiler, Command est le chemin réel de l’exécutable et Arguments vaut --mcp-stdio. Enregistrez et redémarrez le client. L’interface n’offre pas de réglage du délai des outils ; n’y cherchez pas une option de 210 secondes.
Codex CLI
- Ouvrez ~/.codex/config.toml, ou $CODEX_HOME/config.toml si CODEX_HOME est personnalisé. Ajoutez ou modifiez [mcp_servers.printtiler] une seule fois sans supprimer les autres tables.
- Le TOML généré contient tool_timeout_sec = 210. Enregistrez, redémarrez Codex CLI et vérifiez /mcp ou codex mcp list. Pour les autres clients configurables, choisissez un délai supérieur aux 180 secondes du serveur.
Formats de configuration
Les valeurs générées par l’app font foi ; les indications suivantes sont illustratives. Les clients JSON utilisent une commande et des arguments STDIO ; les clients TOML, une table serveur et un délai. Copiez toujours les valeurs actuelles affichées. Aucun URL serveur distant ni lanceur « open -a » n’est nécessaire.
{
"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 = 210Accès aux fichiers et confidentialité
Accès aux fichiers… distingue les dossiers d’entrée (lecture seule) et de sortie (lecture/écriture) ; plusieurs dossiers peuvent être ajoutés ou retirés. Un dossier d’entrée non autorisé déclenche une demande d’autorisation au niveau du répertoire. L’écrasement d’un fichier existant demande une confirmation via elicitation si le client le prend en charge, sinon utilise la feuille d’enregistrement macOS. Un nouveau fichier dans un dossier de sortie autorisé peut être enregistré sans autre dialogue. L’aperçu illustratif peut transmettre à l’assistant le contenu image et des métadonnées de mise en page ; les règles du fournisseur s’appliquent. PrintTiler ne téléverse pas les fichiers sur ses serveurs. MCP n’imprime pas : aucun outil d’impression. Désactivez-le dans Réglages > MCP et révoquez les accès aux dossiers si nécessaire.
Utiliser les cinq outils
Les cinq outils sont printtiler_get_state, printtiler_open_document, printtiler_set_layout, printtiler_preview et printtiler_export_pdf. Ils ciblent la fenêtre de document au premier plan ; évitez toute modification simultanée. Séquence recommandée : lire l’état, ouvrir un fichier local autorisé, régler la mise en page, prévisualiser, puis exporter le PDF. Une grille 3×2 ne garantit pas exactement six pages : vérifiez colonnes, lignes et pages réelles avant export.
Si PrintTiler n’est pas ouvert, le premier appel réel à un outil peut ouvrir l’app. MCP doit avoir été activé auparavant ; un appel ne l’active jamais discrètement.
Exemple de demande
Exemple : «Lis l’état actuel et ouvre /Users/me/Documents/input.png. Choisis A4 portrait, Custom Fit, 3 pages en largeur et 2 en hauteur. Montre l’aperçu et les colonnes, lignes et pages réelles. ARRÊTE-TOI et demande mon accord. Seulement après mon accord, exporte vers /Users/me/Documents/output.pdf.» Remplacez les chemins par des chemins absolus locaux autorisés. Après expiration du délai, vérifiez le résultat avant de réessayer.
Voir PrintTiler sur le Mac App Store
Dépannage
Si l’app a été déplacée, recopiez la configuration nouvellement générée. Si la fenêtre de configuration est occupée, fermez-la avant les appels d’outils. En cas de refus d’accès, autorisez le dossier dans l’app ; ne contournez pas les permissions avec chmod. Pour une configuration invalide, vérifiez la prise en charge STDIO locale du client et isolez sa configuration. Tous les clients nommés Claude ou Codex ne sont pas testés ni garantis compatibles. Le serveur expire après 180 s, dialogues compris ; le client doit attendre plus (valeur Codex générée : 210 s). Après expiration, vérifiez la sortie avant de réessayer.
Impression PDF · Chevauchement · Format A4
Consultez aussi les guides PDF, chevauchement et format papier, ainsi que la politique de confidentialité.