使用 MCP 將 AI 助理連接至 PrintTiler
透過相容的本機 AI 用戶端在 PrintTiler 準備分頁版面。檔案存取、預覽與 PDF 匯出由您掌控。
快速開始
- 在 PrintTiler 啟用 MCP（預設關閉）。
- 授權資料夾並設定相容的本機 STDIO 用戶端。
- 檢查狀態與預覽；匯出 PDF 前先核准。
工作流程範例
以下提示僅供示例，並非實際對話紀錄。
讀取 PrintTiler 目前狀態，回報實際分頁欄數、列數與頁數。不要變更任何內容。開啟 /Users/me/Documents/poster.png（已授權的輸入檔）。設定 A4 直向、Custom Fit、橫向 2 頁、直向 3 頁。預覽並回報實際頁數；等比例鎖定可能影響頁數。停止，不要匯出。檢查準備狀態與預覽，然後停止並詢問我是否同意。只有在我同意後，才匯出 PDF 至 /Users/me/Documents/output.pdf.
頁面網格可能受等比例鎖定影響：請檢查預覽的實際頁數；2 × 3 不保證六頁。
使用情境與 Prompt
複製現成提示，將預留位置換成已授權的 Mac 絕對路徑，再貼到 MCP 用戶端。這些情境用於準備或檢視版面：多數在預覽後停止，匯出情境會等您明確同意，而 MCP 不會列印——實際列印仍在 App 中手動進行。
教室或居家海報
將一張影像沿 A4 直向分頁成兩欄寬（across = 2），回報實際列數與頁數，並在匯出或列印前停止。
查看 Prompt
讀取 PrintTiler 目前狀態。開啟 <INPUT_PATH> 的影像並確認已就緒。設定 A4 直向、Custom Fit、across=2（兩欄寬），保持目前的長寬比鎖定不變。回報實際欄數、列數與頁數，並顯示預覽中的第一個輸出拼貼。在匯出前停止，不要列印。預覽只會傳回一個輸出拼貼，不是組裝完成的整張海報。
比較 A4 直向與 Letter 橫向
以目前設定比較兩種支援的紙張，然後先還原原紙張，等您選擇。
查看 Prompt
以目前的 PrintTiler 文件讀取狀態，記下目前紙張與方向。保持相同貼合模式與目前的邊界與重疊。比較 A4 直向與 Letter 橫向；兩者皆支援。分別回報實際頁數並顯示第一個輸出拼貼。還原原本的紙張與方向，然後問我選哪一個。不要匯出。請選擇印表機實際裝載的紙張；這不保證紙張數量較少。
寬幅橫向插圖
以 Fit Width 將寬幅橫向插圖貼合 Letter 橫向寬度，並查看實際預覽，可能只有一頁。
查看 Prompt
開啟 <INPUT_PATH> 的橫向插圖並確認已就緒。設定 Letter 橫向、Fit Width。回報實際欄數、列數與頁數，並顯示預覽中的第一個輸出拼貼。在此停止，不要匯出。選擇下一步前，請先檢查預覽與實際頁數。
從單一 PDF 來源頁製作海報
只將 PDF 的來源第 2 頁分頁到 A4 直向、回報頁數，並在匯出前停止。
查看 Prompt
開啟 <INPUT_PDF_PATH> 的 PDF，確認已就緒並查看來源頁數；若少於 2 頁就停止。選擇來源 PDF 第 2 頁（從 1 起算）。設定 A4 直向、Custom Fit、across=2（兩欄寬），保持目前的長寬比鎖定不變。回報實際頁數並顯示第一個輸出拼貼。停止，不要匯出。這只會分頁選取的來源頁，不會批次處理整份 PDF。
取得明確同意後匯出
檢視網格與第一個輸出拼貼，只有您同意後才匯出新 PDF。
查看 Prompt
從 PrintTiler 讀取目前文件、來源頁、就緒狀態與實際網格，並顯示第一個輸出拼貼。停止並要求我明確同意。只有我同意後，才匯出到 <OUTPUT_PDF_PATH> 的新檔案。若該檔案已存在，請停止並要求我提供新名稱，不要覆寫。先檢查目的地並只匯出一次；逾時後不要自動重試。不要列印。<OUTPUT_PDF_PATH> 代表整個絕對 .pdf 路徑，請勿再附加副檔名。
將 <INPUT_PATH>、<INPUT_PDF_PATH>、<OUTPUT_PDF_PATH> 換成已授權的 Mac 絕對路徑，並先完成 MCP 設定。這些是示意用的提示範本，不是實際執行過的對話紀錄。預覽可能將影像內容與版面中繼資料傳送給您的助理或其供應商。MCP 請求執行期間請勿手動編輯文件。目前的長寬比鎖定不會被更動，要求的網格也不保證固定頁數。MCP 不會列印。若用戶端提供語音輸入可使用，但 PrintTiler 不是語音介面。
MCP 不會列印。 MCP 預設關閉，並透過相容的本機 STDIO 用戶端運作。請授權資料夾；預覽內容可能會與助理／服務提供者分享。
需求
需要 macOS 12 以上的 PrintTiler 1.14.0 以上版本，以及已安裝且可信任、支援本機 STDIO 伺服器的 MCP 用戶端。本指南適用本機用戶端，不適用遠端網頁連接器。PrintTiler 服務不需額外安裝 Python、Node 或 Swift；用戶端須先行安裝。
設定用戶端
- 在 PrintTiler 開啟 Settings → MCP → Enable。MCP 預設關閉，App 會記住您的選擇。
- 開啟 Settings → MCP → Setup MCP…，選擇用戶端。複製 App 產生的實際執行檔路徑；App 不一定安裝在 /Applications。
- 點擊 Setup MCP 左下角的 File Access…。使用 Add Folder… 授權輸入資料夾讀取權限與輸出資料夾讀寫權限。兩份清單分開管理；Remove 可撤銷所選資料夾的授權。
- 依下方對應用戶端的步驟完成設定，再關閉 Setup MCP，然後讓助理使用工具。
Claude Desktop
- 開啟 Settings → Developer → Edit Config。Mac 設定檔為 ~/Library/Application Support/Claude/claude_desktop_config.json。
- 將產生的 mcpServers.printtiler 項目合併至有效 JSON，保留其他伺服器與設定。儲存並完整重新啟動 Claude Desktop；只關閉視窗不算重新啟動。
Claude Code
- 在目標專案目錄開啟終端機，複製並執行 PrintTiler 產生的指令。預設 local 範圍僅適用目前使用者與目前專案，不是所有專案。
- 在同一目錄重新啟動 Claude Code，以 /mcp 或 claude mcp list 檢查 printtiler。已有項目應更新，請勿重複新增。
ChatGPT (Codex)
- 在桌面 App 的 Codex 模式開啟 Settings → MCP Servers → Add server，選擇 STDIO。這不是網頁 ChatGPT 的遠端連接器。
- 分別複製 App 產生的欄位：Name 為 printtiler，Command 為實際執行檔路徑，Arguments 為 --mcp-stdio。儲存並重新啟動用戶端。GUI 沒有工具逾時設定，請勿尋找 210 秒選項。
Codex CLI
- 開啟 ~/.codex/config.toml；若使用自訂 CODEX_HOME，則開啟 $CODEX_HOME/config.toml。只新增或更新一次 [mcp_servers.printtiler]，保留其他區段。
- 產生的 TOML 包含 tool_timeout_sec = 210。儲存並重新啟動 Codex CLI，以 /mcp 或 codex mcp list 檢查。其他用戶端若可設定逾時，應設為超過伺服器的 180 秒。
設定格式
以 App 產生的設定值為準；以下描述僅供說明。JSON 用戶端使用 STDIO 命令與引數；TOML 用戶端使用伺服器表格及逾時。務必複製「設定 MCP」顯示的目前值。不需要遠端伺服器網址或「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檔案存取與隱私
「檔案存取…」分開管理清單：輸入資料夾唯讀，輸出資料夾可讀寫。可新增或移除多個資料夾。未列出的輸入資料夾會要求授權資料夾（目錄層級）。覆寫既有檔案時，若用戶端支援 elicitation，會要求確認；否則使用 macOS 儲存面板。新檔案存於已授權輸出資料夾時可能不再詢問。預覽範例可能將影像內容與版面中繼資料傳送給助理，並受服務提供者政策約束。PrintTiler 不會將檔案上傳至其伺服器。MCP 不會列印：沒有列印工具。可在「設定 > MCP」關閉並撤銷資料夾授權。
使用五項工具
五項工具：printtiler_get_state、printtiler_open_document、printtiler_set_layout、printtiler_preview、printtiler_export_pdf。工具操作目前最前景文件視窗；請勿同時編輯。安全順序為讀取狀態、開啟已授權本機檔案、設定版面、預覽，再匯出 PDF。要求 3×2 網格不保證恰好六頁；匯出前先確認預覽實際欄數、列數與頁數。
若 PrintTiler 未執行，第一次實際工具呼叫可開啟 App。MCP 必須先前已啟用；工具呼叫絕不會默默啟用它。
提示範例
範例：「讀取目前狀態。開啟 /Users/me/Documents/input.png。設定 A4 直向、Custom Fit、橫向 3 頁、直向 2 頁。顯示預覽並回報實際欄數、列數與頁數。停止並詢問我是否同意。只有獲得我的同意後，才匯出至 /Users/me/Documents/output.pdf。」將範例路徑換成已授權的本機絕對路徑。逾時後重試前先檢查輸出檔。
疑難排解
若 App 移動過，請複製新產生的設定。若設定視窗忙碌，工具呼叫前先關閉「設定 MCP」。權限遭拒時，透過 App 授權資料夾；不要以 chmod 繞過權限。設定無效時，檢查用戶端是否支援本機 STDIO，並隔離其設定。並非所有 Claude 或 Codex 品牌用戶端都經過測試或保證相容。伺服器逾時為 180 秒（含對話框）；用戶端應設定更長時間（產生的 Codex 值為 210 秒）。逾時後重試前先檢查是否已產生輸出。
PDF 列印 · 重疊設定 · A4 尺寸
另請參閱 PDF、重疊與紙張尺寸指南，以及隱私權政策。
