AI 에이전트가 이제 PDF를 생성할 수 있습니다

대규모 언어 모델 (Large language models)은 Markdown을 생성하는 데 매우 뛰어납니다. 하지만 이들이 하지 못하는 것은 해당 Markdown을 세련되고 브랜드화된 PDF로 변환하는 것입니다. 이는 항상 수동적인 단계였습니다 — 출력을 복사하고, 어딘가에 붙여넣고, 서식을 조정하고, 내보내는 과정 말입니다.

PaperQuire v0.3.0은 이 단계를 완전히 제거합니다. 이제 앱에 Model Context Protocol (MCP) 서버가 내장되어 있습니다. Claude, ChatGPT, Copilot 또는 기타 MCP 호환 AI 에이전트는 PaperQuire를 도구 (tool)로서 직접 호출하여 Markdown을 전문적인 문서로 렌더링할 수 있습니다.

MCP란 무엇인가요?

MCP는 AI 애플리케이션이 표준 JSON-RPC 인터페이스를 통해 외부 도구를 호출할 수 있게 해주는 개방형 프로토콜입니다. 이를 "AI 도구를 위한 USB-C"라고 생각하세요 — 하나의 프로토콜로 많은 도구를 사용할 수 있습니다. PaperQuire를 MCP 서버로 구성하면, AI 에이전트가 그 기능을 자동으로 발견하고 대화 중에 이를 호출할 수 있습니다.

작동 방식

CLI 서브커맨드로 MCP 서버를 실행하세요:

paperquire mcp-server

서버는 네 가지 도구를 제공합니다:

• render — 전체 템플릿 및 브랜딩 지원과 함께 Markdown을 PDF로 변환
• list_templates — 내장된 8개의 모든 템플릿 확인
• show_template — 템플릿의 디자인 토큰 (design tokens), 커버 스타일 및 페이지 설정을 검사
• batch_render — 한 번의 호출로 여러 문서를 렌더링 (Pro)

또한 프로젝트의 .paperquire.yml 설정을 반환하는 paperquire://config 리소스를 제공하므로, 에이전트가 렌더링 전에 사용자가 선호하는 템플릿과 브랜딩을 확인할 수 있습니다.

설정

Claude Desktop

Claude Desktop 설정(~/Library/Application Support/Claude/claude_desktop_config.json)에 다음을 추가하세요:

{
  "mcpServers": {
    "paperquire": {
...

Claude Desktop을 재시작하면 MCP 패널에서 PaperQuire의 도구들을 볼 수 있습니다.

Claude Code

프로젝트의 .mcp.json에 추가하세요:

{
  "mcpServers": {
    "paperquire": {
...

VS Code (GitHub Copilot)

.vscode/mcp.json에 추가하세요:

{
  "mcp": {
    "servers": {
...

에이전트에게 요청할 수 있는 작업

설정이 완료되면 다음과 같은 요청을 할 수 있습니다:

"2분기 프로젝트 상태 보고서를 작성하고 브랜드 디자인이 적용된 PDF로 렌더링해줘."

"PaperQuire에는 어떤 템플릿이 있어? 기술 설계 (technical design) 템플릿을 보여주고, 그걸 사용해서 내 사양서 (spec)를 렌더링해줘."

"내 docs/ 폴더에 있는 모든 마크다운 (markdown) 파일들을 기업용 템플릿을 사용하여 PDF로 렌더링해줘."

에이전트가 콘텐츠를 생성하고, PaperQuire의 MCP 도구를 호출한 뒤, 파일 경로를 결과로 보고합니다. 수동 작업은 필요 없습니다.

아키텍처 (Architecture)

MCP 서버는 PaperQuire의 기존 Electron 기반 렌더링 파이프라인 (render pipeline)을 재사용합니다. 이는 데스크톱 앱의 라이브 미리보기 (live preview) 및 PDF 내보내기 (export) 뒤에서 작동하는 것과 동일한 Chromium 엔진을 사용함을 의미합니다. 즉, MCP로 렌더링된 PDF는 GUI 또는 CLI에서 얻는 결과와 동일합니다.

주목할 만한 몇 가지 설계 결정 사항은 다음과 같습니다:

• 장기 실행 렌더러 (Long-running renderer) — 명령마다 렌더러를 생성하고 파괴하는 CLI와 달리, MCP 서버는 하나를 활성화된 상태로 유지하며 모든 도구 호출에 걸쳐 재사용합니다. 첫 번째 렌더링에는 몇 초가 소요되지만, 이후 렌더링은 매우 빠릅니다.
• 표준 출력 (Stdout) 격리 — MCP는 JSON-RPC를 위해 stdout을 독점적으로 사용합니다. PaperQuire는 프로토콜을 방해하지 않도록 stdout에 출력되는 Chromium의 시작 노이즈를 억제합니다.
• 렌더링 잠금 (Render lock) — Chromium 렌더러는 싱글 스레드 (single-threaded)이므로, 동시 도구 호출은 Promise 기반의 뮤텍스 (mutex)를 통해 직렬화됩니다.

무료 티어 (Free tier)

동일한 일일 제한이 적용됩니다: 하루 3회의 무료 렌더링. 무제한 렌더링 및 일괄 내보내기 (batch export)를 원하시면 Pro로 업그레이드하세요.

이용 방법

• v0.3.0 다운로드 (macOS, Windows 또는 Linux용)
• MCP 설정 가이드 (전체 구성 및 도구 참조용)
• CLI 레퍼런스 (mcp-server를 포함한 모든 명령용)

또는 Homebrew를 통해 설치하세요:

brew install --cask paperquire/paperquire/paperquire