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 클라이언트가 필요합니다. 이 안내는 로컬 클라이언트용이며 원격 웹 커넥터용이 아닙니다. PrintTiler 서비스에는 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에서 끄고 폴더 권한을 취소하세요.

다섯 도구 사용

도구는 printtiler_get_state, printtiler_open_document, printtiler_set_layout, printtiler_preview, printtiler_export_pdf의 다섯 가지입니다. 현재 앞에 있는 문서 창을 대상으로 하므로 동시에 편집하지 마세요. 상태 확인→승인된 로컬 파일 열기→레이아웃 설정→미리보기→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 크기
• 개인정보