PubAX › kordoc › Claude·Cursor·VS Code에서 HWP 파일 읽게 하기

Claude·Cursor·VS Code에서 HWP 파일 읽게 하기

kordoc을 MCP 서버로 등록하면 AI가 파일 경로만 받아서 HWP·PDF·엑셀을 읽고, 두 문서를 비교하고, 양식을 채웁니다. 파일은 내 컴퓨터 밖으로 나가지 않습니다.

1. 한 줄 설치

복사npx -y kordoc setup

Claude Desktop·Claude Code·Cursor·Codex 등 설치된 클라이언트를 찾아서 MCP를 등록합니다. 클라이언트를 다시 켜면 도구가 보입니다.

VS Code·Cursor는 버튼으로

VS Code에 설치Cursor에 설치

Claude Code 플러그인

복사/plugin marketplace add chrisryugj/kordoc
/plugin install kordoc@kordoc

직접 등록

설정 파일의 mcpServers에 아래 내용을 넣습니다.

복사{ "mcpServers": { "kordoc": { "command": "npx", "args": ["-y", "kordoc", "mcp"] } } }

Windows의 Claude Desktop이 명령을 못 찾으면 아래처럼 바꿉니다.

복사"command": "cmd", "args": ["/c", "npx", "-y", "kordoc", "mcp"]

이렇게 물어봅니다

• "다운로드 폴더의 공고문.hwp 요약해줘"
• "작년 계획서.hwp와 올해 계획서.hwpx에서 바뀐 부분만 표로 보여줘"
• "이 기안문 양식에 제목이랑 본문 채워서 저장해줘"

접근 범위 제한

KORDOC_ROOT=폴더를 주면 AI가 그 폴더 안의 파일만 열 수 있습니다. 외부 통신을 막으려면 KORDOC_OFFLINE=1도 같이 줍니다.

claude.ai 웹 채팅은 내 컴퓨터 파일에 닿지 않으므로 이 방법은 Claude Desktop·Claude Code 같은 설치형 클라이언트에서 씁니다.