# rhwp · HWPX 읽기와 수정 실습

선택 25분. 제공 문서는 KDI 과정용 가상 안내문이며 실제 정책·기관 발표자료가 아니다.

## 1. 화면에서 열기

[rhwp 웹 편집기](https://edwardkim.github.io/rhwp/)에서 파일 메뉴로 inbox/rhwp-practice.hwpx를 선택한다. Codex 인앱 브라우저 또는 일반 브라우저에서 사용한다.

## 2. hwp-mcp 연결

Node.js LTS와 npm/npx를 사전에 준비한다. Codex 설정의 MCP 서버 항목에서 로컬 stdio 서버를 추가한다. 앱 버전에 따라 메뉴 이름이 다르면 [공식 MCP 안내](https://learn.chatgpt.com/docs/extend/mcp?surface=app)를 확인한다.

- 이름: hwp-mcp
- 명령: npx (Windows에서 실행파일을 못 찾으면 npx.cmd의 실제 경로 확인)
- 인자: -y 와 hwp-mcp@0.3.0 (각각 별도 인자)
- API 키: 필요 없음

Codex CLI가 이미 설치된 환경에서는 다음 명령도 사용할 수 있다.

    codex mcp add hwp-mcp -- npx -y hwp-mcp@0.3.0

기존 MCP 서버 설정은 보존한다. 연결 후 새 채팅에서 실제 도구 호출을 확인하고, 도구가 보이지 않으면 앱을 다시 시작한다. 연결 상태와 도구 호출 성공을 구분한다.

## 3. 파일 수정 순서

1. read_hwp: 원본 본문과 표 읽기. 문서에서 검토 전과 표의 검토 예정 확인.
2. replace_hwp_text: 검토 전 → 검토 완료, output/rhwp-text-edited.hwpx로 저장.
3. set_hwp_cell_text: 첫 수정본을 입력으로 사용, table_index=0 / row=1 / col=1을 확인 완료로 변경, output/rhwp-edited.hwpx로 저장.
4. read_hwp: 원본과 최종본 다시 읽어 두 변경과 원본 보존 확인.
5. 웹 편집기에서 최종본을 다시 선택해 본문과 표 모양 확인.

MCP 도구의 file_path와 output_path에는 실제 절대경로를 전달한다. 표 인덱스·행·열은 0부터 센다. 원본은 inbox에 보존하고 결과만 output에 저장한다. 브라우저에 열린 문서와 로컬 파일은 자동 동기화되지 않는다.

## 범위와 확인할 점

- 이번 실습은 본문 치환과 기존 텍스트가 있는 표 셀 수정만 한다.
- hwp-mcp 0.3.0의 빈 셀 수정과 글자 서식에는 검증 중 문제가 발견돼 실습에서 제외한다.
- 저장 성공 메시지 뒤에 재읽기와 화면 확인을 한다. rhwp는 한컴과 동일한 조판을 보장하지 않으며 이미지 누락도 확인한다.
- HTML↔HWPX 변환은 이 모듈에 포함하지 않는다.
- 외부 전송·공유는 실습하지 않는다.

공식 원본: [rhwp](https://github.com/edwardkim/rhwp) · [hwp-mcp](https://github.com/treesoop/hwp-mcp) · [Codex MCP](https://learn.chatgpt.com/docs/extend/mcp?surface=app)