English繁體中文简体中文日本語한국어EspañolFrançaisDeutschPortuguêsItalianoPolskiNederlands
Mac App Store

使用 MCP 将 AI 助手连接到 PrintTiler

使用兼容的本地 AI 客户端在 PrintTiler 中准备分页布局。文件访问、预览和 PDF 导出均由您掌控。

快速开始

  1. 在 PrintTiler 启用 MCP（默认关闭）。
  2. 授权文件夹并配置兼容的本地 STDIO 客户端。
  3. 检查状态和预览；导出 PDF 前先批准。

工作流程示例

以下提示仅供示例，并非实际对话记录。

  1. 读取 PrintTiler 当前状态，报告实际分页列数、行数和页数。不要更改任何内容。
  2. 打开 /Users/me/Documents/poster.png（已授权的输入文件）。设置 A4 纵向、Custom Fit、横向 2 页、纵向 3 页。预览并报告实际页数；纵横比锁定可能影响页数。停止，不要导出。
  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；客户端需预先安装。

配置客户端

  1. 在 PrintTiler 中打开 Settings → MCP → Enable。MCP 默认关闭，App 会记住您的选择。
  2. 打开 Settings → MCP → Setup MCP…，选择客户端。复制 App 生成的实际可执行文件路径；App 不一定安装在 /Applications。
  3. 点击 Setup MCP 左下角的 File Access…。使用 Add Folder… 授权输入文件夹读取权限和输出文件夹读写权限。两个列表独立管理；Remove 可撤销选中文件夹的授权。
  4. 按下方对应客户端的步骤完成配置，再关闭 Setup MCP，然后让助手使用工具。

Claude Desktop

  1. 打开 Settings → Developer → Edit Config。Mac 配置文件为 ~/Library/Application Support/Claude/claude_desktop_config.json。
  2. 将生成的 mcpServers.printtiler 条目合并到有效 JSON，保留其他服务器和设置。保存并完全重启 Claude Desktop；只关闭窗口不算重启。

Claude Code

  1. 在目标项目目录打开终端，复制并运行 PrintTiler 生成的命令。默认 local 范围仅适用于当前用户和当前项目，不是所有项目。
  2. 在同一目录重启 Claude Code，以 /mcp 或 claude mcp list 检查 printtiler。已有条目应更新，不要重复添加。

ChatGPT (Codex)

  1. 在桌面 App 的 Codex 模式打开 Settings → MCP Servers → Add server，选择 STDIO。这不是网页 ChatGPT 的远程连接器。
  2. 分别复制 App 生成的字段：Name 为 printtiler，Command 为实际可执行文件路径，Arguments 为 --mcp-stdio。保存并重启客户端。GUI 没有工具超时设置，不要寻找 210 秒选项。

Codex CLI

  1. 打开 ~/.codex/config.toml；使用自定义 CODEX_HOME 时打开 $CODEX_HOME/config.toml。只添加或更新一次 [mcp_servers.printtiler]，保留其他区段。
  2. 生成的 TOML 包含 tool_timeout_sec = 210。保存并重启 Codex CLI，以 /mcp 或 codex mcp list 检查。其他客户端若可设置超时，应设为超过服务器的 180 秒。

配置格式

以 App 生成的配置值为准；以下仅作说明。JSON 客户端使用 STDIO 命令和参数；TOML 客户端使用服务器表格及超时。务必复制“设置 MCP”中当前显示的值。不需要远程服务器 URL 或“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。”将示例路径替换为已授权的本地绝对路径。超时后重试前先检查输出文件。

在 Mac App Store 查看 PrintTiler

故障排除

如果 App 移动过，请复制新生成的配置。设置窗口忙碌时，工具调用前先关闭“设置 MCP”。权限被拒时通过 App 授权文件夹；不要用 chmod 绕过权限。配置无效时，检查客户端是否支持本地 STDIO，并隔离其配置。并非所有 Claude 或 Codex 品牌客户端都经过测试或保证兼容。服务器超时为 180 秒（含对话框）；客户端应允许更长时间（生成的 Codex 值为 210 秒）。超时后重试前检查是否已生成输出。

PDF 打印 · 重叠设置 · A4 尺寸

另请参阅 PDF、重叠和纸张尺寸指南，以及隐私政策。

准备好打印更大的图片了吗？

下载 PrintTiler，自信地开始打印超大图片。

Download on the Mac App Store
4.7 评分200+ Mac App Store 评分原生 macOS一次购买