에이전트에게 보고서를 Markdown 형식으로 작성하고, 그 파일을 PDF와 DOCX로 변환하도록 요청하세요. GroupDocs.Conversion.Mcp 서버와 Claude, Cursor 또는 GitHub Copilot을 사용하면 두 단계를 하나의 대화에서 로컬로 수행할 수 있으며, 두 번째 단계는 브라우저가 아니라 레이아웃 엔진을 통해 실행됩니다:
릴리스 요약을 summary.md에 작성한 다음 PDF와 Word로 변환하세요.
구성 및 문제 해결이 포함된 단계별 버전은 문서에 있습니다: MCP 서버를 사용하여 Markdown을 PDF 또는 Word로 내보내는 방법.
AI가 작성한 콘텐츠가 내보내기 단계가 필요한 이유
에이전트는 기본적으로 Markdown으로 작성합니다. 결과를 받는 사람들은 보통 Markdown을 원하지 않습니다: 클라이언트는 PDF를 기대하고, 동료는 편집하고 댓글을 달 수 있는 Word 파일을 기대합니다. 이 격차를 해소하기 위해서는 헤드리스 브라우저로 HTML을 인쇄하거나, LaTeX 툴체인을 사용하거나, 워드 프로세서에 수동으로 붙여넣는 방법이 사용되었습니다. 각각은 유지해야 할 종속성을 추가하거나 매주 반복해야 하는 수동 단계를 만들게 됩니다.
MCP 변환 서버는 이러한 종속성을 제거합니다. 에이전트는 이미 Markdown을 보유하고 있으므로 파일에 기록하고 엔진에 해당 파일을 변환하도록 요청합니다.
전달 워크플로우는 어떻게 보이나요?
주간 상태 보고서, 회의 요약 또는 릴리스 노트와 같은 반복 문서에 대해 다음 단계를 따르세요.
-
서버를 전달 폴더에 지정합니다. 에이전트가 쓰고 변환할 수 있는 폴더로
GROUPDOCS_MCP_STORAGE_PATH를 설정합니다. 선택적으로GROUPDOCS_MCP_OUTPUT_PATH를 설정하여 완성된 파일을 초안과 구분합니다. -
에이전트에게 원본 자료를 제공합니다. 메모를 붙여넣거나 요약할 파일을 알려줍니다.
-
파일 이름으로 Markdown 파일을 요청합니다.
이번 주 요약을 status.md에 작성하세요.
-
내보내기를 요청합니다.
status.md를 PDF로 변환하고, DOCX로도 변환하세요.
보통 에이전트는 각 대상마다
convert를 한 번씩 호출하며,format: "pdf"와 그 다음format: "docx"를 사용합니다. -
폴더에서 출력물을 검토합니다. 응답에는 저장된 각 파일의 이름이 포함됩니다.
-
다음 주에 다시 실행합니다. 서버는 이전 내보내기를 교체하지 않으므로 지난 주 파일은 그대로 유지되고 새 파일은 별도의 이름을 갖게 됩니다.
| 단계 | 에이전트가 결정 | 엔진이 수행 |
|---|---|---|
| 내용 | 요약 내용과 헤드 | 없음 |
| 파일 이름 및 형식 | status.md, 그 다음 PDF와 DOCX |
없음 |
| 렌더링 | format이 설정된 convert 호출 |
표, 목록 및 코드 블록을 배치 |
| 결과 | 응답에서 저장된 파일 이름을 읽음 | 네이티브 PDF와 네이티브 DOCX를 작성 |
브라우저 인쇄와 달리 엔진이 수행하는 작업은 무엇인가요?
Markdown을 PDF로 변환하는 것은 가장자리에서 어려움이 있습니다: 다중 페이지 표, 중첩 목록, 코드 블록, 이미지 및 페이지 구분. 브라우저 인쇄 파이프라인은 페이지 레이아웃을 근사합니다. GroupDocs.Conversion 엔진은 이를 조판하고 기업 문서 워크플로우에서 사용되는 동일한 렌더링을 제공합니다. 출력은 하나의 소스에서 두 형식 모두 제공됩니다. DOCX는 헤드라인, 목록 및 표 스타일이 적용된 네이티브 편집 가능한 Word 문서이며, 페이지의 이미지가 삽입된 것이 아닙니다.
설정 방법은?
Claude Desktop, Claude Code, Cursor 또는 GitHub Copilot이 포함된 VS Code에서 서버를 한 번 등록하세요; 각 클라이언트에 대한 구성 파일은 docs hub에 나와 있습니다. 아래 항목은 Claude Desktop 형식입니다.
{
"mcpServers": {
"groupdocs-conversion": {
"type": "stdio",
"command": "dnx",
"args": ["GroupDocs.Conversion.Mcp", "--yes"],
"env": {
"GROUPDOCS_MCP_STORAGE_PATH": "/path/to/reports",
"GROUPDOCS_MCP_OUTPUT_PATH": "/path/to/reports/delivered"
}
}
}
}
dnx는 .NET 10 SDK가 필요합니다. Docker 이미지도 제공됩니다: ghcr.io/groupdocs-conversion/conversion-net-mcp:latest. 등록 후 클라이언트를 재시작하세요.
작동하는 다른 프롬프트:
meeting-notes.md를 DOCX로 변환하여 팀이 편집할 수 있게 하세요.
이 Markdown 보고서를 PDF와 Word 모두로 내보내세요.
예시 세션
이는 convert 도구의 문서화된 동작을 기반으로 만든 축약된 예시 세션이며, 스크린샷이 아닙니다.
You: Write the release summary to summary.md, then convert it to PDF.
Agent: [writes summary.md to the storage folder]
Agent: [calls convert with file.filePath = "summary.md", format = "pdf"]
Agent: Done. The PDF is saved as summary.pdf in your output folder.
채팅 없이 전달을 실행해야 하면 어떻게 하나요?
채팅 세션은 매주 금요일 17:00에 실행되어야 하는 작업의 올바른 트리거가 아닙니다. 동일한 엔진은 .NET용 라이브러리로도 제공되며, n8n walkthrough는 사람이 입력하는 대신 자동화 도구가 서버를 호출하는 방법을 보여줍니다. 각 보고서를 사람이 검토할 때는 채팅 워크플로우를 사용하고, 아무도 개입하지 않아도 될 때는 스크립트 기반 워크플로우를 사용하세요.
제한 사항은 무엇인가요?
- 평가 모드. 라이선스가 없으면 변환된 출력에 평가 워터마크가 포함되므로 클라이언트에 전달되는 보고서는 먼저 라이선스가 필요합니다. 하나의 서버 프로세스는 최대 15개의 문서만 열 수 있습니다. 실제 전달 전에
get_license_status를 실행하려면 “what is the license status of the conversion server?“를 물어보세요. - 내용 검토 없음. 엔진은 받은 내용을 그대로 포맷합니다. 에이전트가 잘못된 내용을 작성하면 PDF에도 그대로 포함되므로, 내보내기 전에 Markdown의 사실을 확인하세요.
- 가장 어려운 레이아웃을 먼저 확인하세요. 주간 자동화를 진행하기 전에 가장 넓은 표와 가장 긴 코드 블록이 포함된 실제 보고서를 한 번 내보내 보세요.
FAQ
Claude가 자신의 답변을 PDF로 저장할 수 있나요?
예. 답변을 저장 폴더의 .md 파일에 작성하도록 요청한 다음 해당 파일을 변환하세요. 이는 하나의 프롬프트에서 두 번의 도구 호출을 의미합니다.
Markdown을 DOCX로 변환하면 실제 Word 문서가 생성되나요?
예. 출력은 페이지의 이미지가 아닌 네이티브 편집 가능한 DOCX입니다.
Markdown을 PDF로 내보내기 위해 헤드리스 브라우저나 LaTeX가 필요합니까?
아니요. 변환은 로컬 머신의 GroupDocs.Conversion 엔진을 통해 실행되므로 둘 다 필요하지 않습니다.
더 깊이 알아보기
- 문서, 표준 사용 방법: MCP 서버를 사용하여 Markdown을 PDF 또는 Word로 내보내는 방법
- 문서 허브: GroupDocs.Conversion MCP Server
- 시작하기: AI 에이전트가 스스로 문서를 변환하면 안 되는 이유
- 관련: PDF를 LLM 준비용 Markdown으로 변환하는 3가지 방법 (그리고 로컬이 왜 좋은가)
- 관련: 전체 폴더, 하나의 프롬프트: Claude와 MCP를 이용한 배치 변환
- 공지: AI 에이전트가 이제 로컬에서 문서를 변환할 수 있습니다. GroupDocs.Conversion MCP 소개
- 온프레미스 및 보안 모델: AI 문서 처리용 3가지 아키텍처와 파일을 네트워크 내부에 보관하는 방법
- 질문: GroupDocs Conversion 포럼
- 소스: GitHub의 GroupDocs.Conversion.Mcp