Office Word MCP

왜 쓰나요

핵심 기능

적절한 스타일과 제목으로 처음부터 .docx 생성
기존 문서를 구조화된 아웃라인으로 읽기
셀 단위 제어로 표 추가/수정
문서 전체에서 검색 및 바꾸기
이미지 삽입 및 정렬/크기 조절 적용

라이브 데모

실제 사용 모습

office-word-mcp.replay ▶ 준비됨

0/0

설치

클라이언트 선택

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "office-word-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "office-word-mcp-server",
        "word_mcp_server"
      ]
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config 열기. 저장 후 앱 재시작.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "office-word-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "office-word-mcp-server",
        "word_mcp_server"
      ]
    }
  }
}

Cursor는 Claude Desktop과 동일한 mcpServers 스키마 사용. 프로젝트 설정이 전역보다 우선.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "office-word-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "office-word-mcp-server",
        "word_mcp_server"
      ]
    }
  }
}

Cline 사이드바의 MCP Servers 아이콘 클릭 후 "Edit Configuration" 선택.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "office-word-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "office-word-mcp-server",
        "word_mcp_server"
      ]
    }
  }
}

Claude Desktop과 같은 형식. Windsurf 재시작 후 적용.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "office-word-mcp",
      "command": "uvx",
      "args": [
        "--from",
        "office-word-mcp-server",
        "word_mcp_server"
      ]
    }
  ]
}

Continue는 맵이 아닌 서버 오브젝트 배열 사용.

~/.config/zed/settings.json

{
  "context_servers": {
    "office-word-mcp": {
      "command": {
        "path": "uvx",
        "args": [
          "--from",
          "office-word-mcp-server",
          "word_mcp_server"
        ]
      }
    }
  }
}

context_servers에 추가. 저장 시 Zed가 핫 리로드.

claude mcp add office-word-mcp -- uvx --from office-word-mcp-server word_mcp_server

한 줄 명령. claude mcp list로 확인, claude mcp remove로 제거.

사용 사례

실전 활용법: Office Word MCP

완성도 높은 Word 문서로 주간 상태 보고서 자동 생성

👤 .docx로 납품하는 PM, 분석가, 컨설턴트 ⏱ ~25 min beginner

언제 쓸까: 클라이언트가 Markdown이나 PDF가 아닌 Word를 요구하고 매주 복사-붙여넣기를 반복하고 싶지 않을 때.

사전 조건

스타일을 복사할 템플릿 문서 — 표준 보고서를 ~/templates/status-report.docx로 저장

흐름

템플릿 열기

Use word-mcp. Open ~/templates/status-report.docx and tell me its structure (headings + table count).✓ 복사됨

→ 아웃라인 반환 — H1, H2 목록, 표 크기
이번 주 데이터로 채우기

Save a copy as week-of-2026-04-27.docx. Replace placeholder tables with this week's numbers (paste data). Leave the cover page intact.✓ 복사됨

→ 복사본 저장, 표 업데이트, 표지 유지
요약 단락 추가

Under 'Executive Summary', insert 3 paragraphs covering top wins, blockers, and asks. Match the existing paragraph style.✓ 복사됨

→ 올바른 스타일로 단락 추가됨

결과: 수동 형식 지정 없이 매주 재생성되는 납품 준비 완료 Word 보고서.

함정

커스텀 템플릿 폰트가 임베딩되지 않음 — python-docx는 참조를 작성하므로 수신자에게 폰트가 없다면 Word UI에서 임베딩하거나 시스템 폰트 사용

함께 쓰기: filesystem

주석과 함께 계약서 초안 수정하기

👤 제3자 초안을 검토하는 법률 인접 역할 ⏱ ~30 min intermediate

언제 쓸까: 계약서 초안을 받고 Claude에게 위험한 조항을 앵커된 주석으로 표시하게 하고 싶을 때.

흐름

문서 수집

Read contract.docx. List the section headings and any clauses with payment terms or liability caps.✓ 복사됨

→ 섹션 인덱스와 강조된 조항
위험 지점에 주석 추가

For each risky clause, add a comment from 'Claude' explaining the concern and a suggested redline.✓ 복사됨

→ Word에서 열면 주석이 표시됨

결과: 실제 법률 자문에 전달할 준비가 된 마크업 초안.

함정

긴 단락에서 앵커 위치가 어긋남 — 단락이 아닌 문장 단위로 앵커 지정; Word에서 다시 열어 검증

메일 머지 방식: CSV에서 50개의 개인화된 편지 생성

👤 개인화된 커뮤니케이션을 발송하는 운영/HR/관리직 ⏱ ~20 min beginner

언제 쓸까: 수신자 목록과 템플릿 편지가 있고 사람별로 .docx를 원할 때.

사전 조건

CSV로 된 수신자 목록 — 컬럼: name, email, custom_field

흐름

필드 매핑

Open template.docx. Show me every {{placeholder}} and ask which CSV column maps to each.✓ 복사됨

→ 플레이스홀더 목록, 매핑 프롬프트
머지 실행

For each row in recipients.csv, render template.docx into ./output/<lastname>.docx. Confirm count at the end.✓ 복사됨

→ N개 파일 작성, 행과 파일 수 일치 보고

결과: 이메일에 첨부할 준비가 된 수신자별 .docx 파일.

함정

이름의 특수문자가 파일명을 깨뜨림 — 저장 전 슬러그화

함께 쓰기: filesystem

조합

다른 MCP와 조합해 10배 효율

office-word-mcp + office-powerpoint-mcp

하나의 소스에서 Word 보고서와 매칭 슬라이드 덱 생성

Take the same data — produce status.docx for the long form and status.pptx for the readout.✓ 복사됨

office-word-mcp + filesystem

CSV 입력을 읽고 행별 docx 출력 작성

Read recipients.csv via filesystem; render template.docx per row via word-mcp.✓ 복사됨

도구

이 MCP가 노출하는 것

도구	입력	언제 호출
create_document	filename, title?, author?	새 문서 시작
get_document_text	filename	기존 내용 읽기
add_paragraph	filename, text, style?	본문 텍스트 추가
add_heading	filename, text, level	섹션 구조
add_table	filename, rows, cols, data?	표 형식 내용
search_and_replace	filename, find, replace	대량 텍스트 변경 / 템플릿 채우기
add_comment	filename, paragraph_index, text, author	수정 작업

비용 및 제한

운영 비용

API 쿼터: 해당 없음 — 로컬
호출당 토큰: 호출당 100~500
금액: 무료 (MIT)
팁: 전체 문서 재작성 스트리밍 대신 search_and_replace 사용

보안

권한, 시크릿, 파급범위

최소 스코프: filesystem-read filesystem-write

자격 증명 저장: 없음

데이터 외부 송신: 없음

개인 법률 문서를 LLM 세션을 통해 전달할 때는 주의 필요

문제 해결

자주 발생하는 오류와 해결

저장 시 PermissionError

파일이 Word에서 열려 있음 — Claude가 쓰기 전에 닫기

스타일이 적용되지 않음

python-docx에서 스타일 이름은 대소문자를 구분; 원본 템플릿의 스타일 이름 확인

주석이 표시되지 않음

Word에서 주석 창이 열려 있는지 확인; 주석은 .docx XML에 올바르게 저장됨

대안

Office Word MCP 다른 것과 비교

대안	언제 쓰나	단점/장점
Office PowerPoint MCP	문서가 아닌 슬라이드가 필요할 때	다른 표면, 같은 개발자
Excel MCP Server	스프레드시트가 필요할 때	Excel은 표 형식용, Word는 산문용

왜 쓰나요

핵심 기능

라이브 데모

실제 사용 모습

설치

클라이언트 선택

사용 사례

실전 활용법: Office Word MCP

완성도 높은 Word 문서로 주간 상태 보고서 자동 생성

사전 조건

흐름

함정

주석과 함께 계약서 초안 수정하기

흐름

함정

메일 머지 방식: CSV에서 50개의 개인화된 편지 생성

사전 조건

흐름

함정

조합

다른 MCP와 조합해 10배 효율

도구

이 MCP가 노출하는 것

비용 및 제한

운영 비용

보안

권한, 시크릿, 파급범위

문제 해결

자주 발생하는 오류와 해결

대안

Office Word MCP 다른 것과 비교

더 보기

리소스