MCP で AI アシスタントを PrintTiler に接続する

クイックスタート

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 は6ページを保証しません。

必要条件

macOS 12 以降の PrintTiler 1.14.0 以降と、ローカル STDIO サーバーに対応するインストール済みの信頼できる MCP クライアントが必要です。本ガイドはローカルクライアント向けで、リモート Web コネクタ向けではありません。サービスに追加の Python、Node、Swift は不要ですが、クライアントは事前にインストールしてください。

クライアント設定

1. PrintTiler で Settings → MCP → Enable を開きます。MCP は初期状態ではオフで、選択した状態は保存されます。
2. Settings → MCP → Setup MCP… を開き、クライアントを選びます。アプリが生成した実際の実行ファイルのパスをコピーしてください。/Applications にあるとは限りません。
3. Setup MCP の左下にある File Access… を押します。Add Folder… で入力フォルダの読み取り権限と出力フォルダの読み書き権限を許可します。リストは別々で、Remove で選んだフォルダの許可を取り消せます。
4. 以下の該当クライアントの手順を完了し、Setup MCP を閉じてからアシスタントにツールを使わせます。

設定形式

アプリが生成した値を正としてください。以下は説明のみです。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」で無効化し、必要に応じてフォルダ許可を取り消してください。

5つのツールを使う

利用できるツールは printtiler_get_state、printtiler_open_document、printtiler_set_layout、printtiler_preview、printtiler_export_pdf の5つです。現在最前面の書類ウィンドウを対象にするため、同時編集は避けます。状態確認、許可済みローカルファイルを開く、レイアウト設定、プレビュー、PDF 書き出しの順に進めます。3×2 の指定は6ページを保証しません。書き出し前に実際の列・行・ページ数を確認してください。

PrintTiler が起動していない場合、最初の実際のツール呼び出しでアプリを開けます。MCP は事前に有効である必要があり、ツールが黙って有効にすることはありません。

プロンプト例

例：「現在の状態を読んでください。/Users/me/Documents/input.png を開き、A4 縦向き、Custom Fit、横 3 ページ、縦 2 ページに設定してください。プレビューと実際の列数、行数、ページ数を表示したら停止し、承認を求めてください。私が承認した後にだけ /Users/me/Documents/output.pdf に書き出してください。」例のパスは許可済みのローカル絶対パスに置き換えます。タイムアウト後は再試行前に出力を確認してください。

トラブルシューティング

アプリを移動した場合は新しい設定をコピーします。設定画面が使用中ならツール呼び出し前に閉じます。権限エラーはアプリでフォルダを許可し、chmod で回避しないでください。無効な設定はクライアントのローカル STDIO 対応を確認し、設定を分離します。Claude/Codex 名の全クライアントがテスト済み・互換保証ではありません。サーバーはダイアログ込み180秒です。クライアントはそれ以上（生成される Codex 値は210秒）に設定してください。タイムアウト後は再試行前に出力を確認します。

PDF 印刷 · 重なり設定 · A4 サイズ

PDF、重なり、用紙サイズのガイドとプライバシーポリシーもご覧ください。

• PDF 印刷
• 重なり設定
• A4 サイズ
• プライバシー