Claude Desktop WP MCP 플러그인 연결은 워드프레스 운영자가 반드시 알아야 할 자동화 기술입니다. 대시보드를 열지 않아도 Claude에게 말 한 마디로 글을 쓰고, 이미지를 올리고, 카테고리를 설정해 발행까지 완료할 수 있습니다.
MCP(Model Context Protocol)는 AI 에이전트가 외부 서비스와 구조화된 방식으로 소통하는 오픈 표준입니다. 워드프레스에 이 표준을 구현한 플러그인을 설치하면 Claude가 워드프레스를 직접 조작하는 두뇌 역할을 합니다. 이 글에서는 Claude Desktop과 WP MCP Ultimate 플러그인을 연결하는 전체 과정을 단계별로 완벽하게 정리합니다.
목차
- Claude Desktop WP MCP 플러그인이란 무엇인가
- 연결 전 준비물 — 필수 환경 체크리스트
- STEP 1 — WP MCP Ultimate 플러그인 설치
- STEP 2 — 애플리케이션 비밀번호 발급
- STEP 3 — Claude Desktop 설정 파일 수정
- STEP 4 — 연결 테스트와 오류 해결
- 실전 활용 — Claude에게 내릴 수 있는 명령어 총정리
- WP MCP Ultimate가 제공하는 58가지 기능 분류
- 보안 설정과 운영 시 주의사항
- 에버그린 인사이트 — AI와 CMS의 연결이 만드는 미래
- Q&A — 가장 많이 묻는 3가지
- 함께 읽으면 좋은 글
1. Claude Desktop WP MCP 플러그인이란 무엇인가
1-1. MCP가 필요한 이유
Claude Desktop WP MCP 플러그인 연결의 핵심을 이해하려면 MCP 개념부터 알아야 합니다. 기존에 AI가 워드프레스를 다루려면 REST API 엔드포인트·인증 헤더·요청 형식·응답 구조를 모두 알고 있어야 했습니다. 실제로 이것을 AI에게 맡기면 매 요청마다 오류가 발생했습니다.
MCP는 이 복잡성을 해결하는 표준 인터페이스입니다. 마치 USB 포트처럼 어떤 MCP 지원 AI 도구든 MCP 서버를 갖춘 서비스에 꽂으면 즉시 해당 서비스의 기능 목록을 자동으로 파악하고 실행합니다. 복잡한 API 명세를 사람이 중간에서 번역할 필요가 없어집니다.
개인적으로 MCP가 AI 자동화 역사에서 가장 혁신적인 발명 중 하나라고 생각합니다. 사람이 “글 써줘”라고 말하면 AI가 직접 워드프레스에 접속해 글을 써서 발행까지 완료하는 것, 이것이 MCP 없이는 불가능했습니다.
1-2. WP MCP Ultimate가 기존 방법과 다른 점
기존에는 워드프레스에 AI를 연결하려면 MCP Adapter 플러그인·MCP Expose Abilities 플러그인·Abilities API 폴리필, 세 개를 동시에 설치해야 했습니다. 세 개 플러그인이 서로 충돌하거나 워드프레스 업데이트 후 하나가 깨지면 전체가 망가졌습니다. WP MCP Ultimate는 이 세 가지를 하나로 통합해 단일 설치·단일 관리·단일 업데이트 구조를 만들었습니다.
2. 연결 전 준비물 — 필수 환경 체크리스트
2-1. 필수 환경 요건
| 항목 | 요건 | 확인 방법 |
|---|---|---|
| Claude Desktop | 최신 버전 설치 | claude.ai/download |
| 워드프레스 버전 | 6.9 이상 권장 | 관리자 → 업데이트 |
| HTTPS | 반드시 적용 | 브라우저 자물쇠 아이콘 |
| 워드프레스 계정 | 관리자(Administrator) 권한 | 사용자 → 프로필 |
| PHP 버전 | 8.0 이상 | 도구 → 사이트 상태 |
이 표는 Claude Desktop과 WP MCP 플러그인을 연결하기 전에 반드시 확인해야 하는 5가지 환경 요건을 정리한 것입니다. 특히 HTTPS가 적용되지 않은 사이트는 MCP 연결 자체가 거부되므로 가장 먼저 확인해야 합니다.
3. STEP 1 — WP MCP Ultimate 플러그인 설치
3-1. GitHub에서 플러그인 다운로드
GitHub WP MCP Ultimate 저장소에 접속해 최신 릴리스의 zip 파일을 다운로드합니다. Releases 탭에서 최신 버전을 선택하세요.
3-2. 워드프레스 관리자에서 설치
워드프레스 관리자 → 플러그인 → 새 플러그인 추가 → 플러그인 업로드 → zip 파일 선택 → 지금 설치 → 활성화 순서로 진행합니다.
3-3. 고유주소 새로 고침
플러그인 설치 후 MCP 엔드포인트가 정상 등록되려면 고유주소 설정을 새로 고침해야 합니다. 설정 → 고유주소 → 저장 버튼을 클릭하세요. 이 단계를 빠뜨리면 엔드포인트 접속 시 404 오류가 발생합니다.
4. STEP 2 — 애플리케이션 비밀번호 발급
4-1. MCP Ultimate 대시보드에서 자동 생성
워드프레스 관리자 → 도구 → MCP Ultimate 메뉴로 이동합니다. Generate(생성) 버튼을 클릭하면 애플리케이션 비밀번호가 자동으로 만들어지고 Claude Desktop 설정에 바로 붙여넣을 수 있는 설정 코드 스니펫이 함께 생성됩니다.
4-2. 생성된 정보 복사
대시보드에서 다음 세 가지 값을 복사해 두세요.
사이트 URL: 예) https://내사이트.com
관리자 아이디: 예) admin
애플리케이션 비밀번호: 예) xxxx xxxx xxxx xxxx xxxx xxxx
개인적으로 이 비밀번호를 별도 메모 앱이나 비밀번호 관리자(1Password·Bitwarden 등)에 즉시 저장해 두는 것을 강력히 권장합니다. 이 값을 잃으면 새로 생성해야 하며 기존 연결이 모두 끊어집니다.
4-3. 엔드포인트 정상 확인
브라우저에서 https://내사이트.com/wp-json/mcp/v1 에 접속했을 때 JSON 응답(중괄호로 시작하는 텍스트)이 나오면 플러그인이 정상 작동 중입니다. 404가 나오면 고유주소 새로 고침을 다시 실행하세요.
5. STEP 3 — Claude Desktop 설정 파일 수정
5-1. 설정 파일 위치
Claude Desktop의 MCP 설정은 JSON 파일로 관리됩니다. 운영체제별 파일 경로는 다음과 같습니다.
Mac: ~/Library/Application Support/Claude/claudedesktopconfig.json
Windows: %APPDATA%\Claude\claudedesktopconfig.json
파일이 없다면 직접 생성하면 됩니다.
5-2. 설정 파일 작성
텍스트 편집기(메모장·VS Code·Sublime Text)로 파일을 열고 아래 형식으로 작성합니다. WP MCP Ultimate 대시보드에서 복사한 스니펫을 그대로 붙여넣으면 대부분의 값이 자동 완성됩니다.
{
"mcpServers": {
"wordpress": {
"command": "node",
"args": ["경로/to/mcp-server.js"],
"env": {
"WP_URL": "https://내사이트주소.com",
"WP_USERNAME": "관리자아이디",
"WP_APP_PASSWORD": "생성된-애플리케이션-비밀번호"
}
}
}
}
5-3. Claude Desktop 재시작
설정 파일 저장 후 Claude Desktop을 완전히 종료하고 다시 실행해야 변경 사항이 적용됩니다. Mac은 Cmd+Q로 완전 종료, Windows는 트레이 아이콘 우클릭 → 종료 후 재시작하세요.
6. STEP 4 — 연결 테스트와 오류 해결
6-1. 연결 확인 명령어
Claude Desktop 채팅창에 다음 내용을 입력해 연결을 확인합니다.
“내 워드프레스 사이트에 연결됐어? 최근 발행된 글 3개 제목을 보여줘.”
Claude가 실제 글 목록을 가져오면 연결 성공입니다. “도구를 찾을 수 없습니다”가 뜨면 설정 파일 경로나 값을 재확인하세요.
6-2. 자주 발생하는 오류와 해결법
| 오류 | 원인 | 해결법 |
|---|---|---|
| 404 Not Found | 고유주소 미갱신 또는 플러그인 비활성화 | 설정 → 고유주소 → 저장 |
| 401 Unauthorized | 비밀번호 오류 또는 권한 부족 | 애플리케이션 비밀번호 재생성 |
| Connection Refused | HTTP 사이트 또는 방화벽 차단 | HTTPS 확인·서버 방화벽 설정 |
| Tool Not Found | Claude Desktop 재시작 미실시 | 완전 종료 후 재시작 |
이 표는 Claude Desktop과 WP MCP 연결 시 자주 발생하는 오류와 해결법을 정리한 것입니다. 가장 많이 발생하는 오류는 404와 Tool Not Found이며, 각각 고유주소 갱신과 Claude Desktop 재시작으로 대부분 해결됩니다.
7. 실전 활용 — Claude에게 내릴 수 있는 명령어 총정리
7-1. 블로그 글 작성 및 발행
연결이 완료되면 Claude에게 자연어로 명령을 내립니다. 아래는 실제로 사용할 수 있는 명령어 예시입니다.
“국민연금 수령액 계산법을 주제로 SEO 최적화 블로그 글을 4,000자 이상 작성해서 카테고리는 경제, 태그는 국민연금·노후준비로 설정하고 초안으로 저장해줘.”
“지금 저장된 초안을 검토한 뒤 메타 디스크립션과 슬러그를 추가하고 발행해줘.”
“2025년 이전에 쓴 500자 미만 글을 모두 찾아서 최신 내용으로 업데이트해줘.”
7-2. 이미지와 미디어 관리
“이 URL의 이미지를 미디어 라이브러리에 업로드하고 alt 텍스트를 ‘국민연금 수령액 계산 예시’로 설정해줘.”
“최근 30일 동안 사용하지 않는 미디어 파일 목록을 보여줘.”
7-3. 대량 작업 자동화
개인적으로 Claude Desktop과 WP MCP를 연결했을 때 가장 놀라웠던 기능이 배치 처리라고 생각합니다. “카테고리 X에 있는 글 전부의 SEO 제목을 검토해서 50자 이내로 수정해줘”라는 한 줄 명령으로 수십 개 글을 한 번에 처리할 수 있습니다.
8. WP MCP Ultimate가 제공하는 58가지 기능 분류
8-1. 기능 도메인별 분류
| 도메인 | 주요 기능 | 기능 수 |
|---|---|---|
| 콘텐츠 (글·페이지) | 작성·수정·발행·초안·삭제·조회 | 12가지 |
| 미디어 | 업로드·alt 텍스트·삭제·조회 | 8가지 |
| 분류 체계 | 카테고리·태그 생성·수정·할당 | 6가지 |
| 사용자 관리 | 권한·역할·목록 조회 | 5가지 |
| 플러그인·테마 | 활성화·비활성화·목록 | 7가지 |
| 설정·옵션 | 사이트 설정 조회·수정 | 8가지 |
| 댓글 | 승인·삭제·조회 | 6가지 |
| 메뉴·위젯 | 생성·수정·할당 | 6가지 |
이 표는 WP MCP Ultimate가 지원하는 58가지 기능을 8개 도메인으로 분류한 것입니다. 콘텐츠 관리 12가지가 가장 많으며 대부분의 워드프레스 운영 작업을 Claude 채팅창 하나에서 처리할 수 있습니다.
9. 보안 설정과 운영 시 주의사항
9-1. 애플리케이션 비밀번호 보안 관리
애플리케이션 비밀번호는 Claude Desktop 설정 파일에 평문으로 저장됩니다. 이 파일이 외부에 노출되면 워드프레스 사이트 전체가 위험에 처할 수 있습니다.
보안을 위해 반드시 지켜야 할 사항은 다음과 같습니다. 설정 파일이 있는 폴더를 클라우드 동기화(Dropbox·구글 드라이브)에서 제외하세요. 비밀번호는 환경 변수로 분리 관리하는 방법도 있습니다. MCP 전용 워드프레스 계정을 별도로 만들고 최소 권한만 부여하는 것이 가장 안전합니다.
9-2. 자동화 실행 전 반드시 백업
Claude가 대량 작업을 실행하기 전에는 반드시 워드프레스 전체 백업을 먼저 진행하세요. “500개 글을 전부 수정해줘”라는 명령 이후 되돌리기가 어렵습니다. UpdraftPlus 또는 All-in-One WP Migration 플러그인으로 자동화 실행 전 스냅샷을 남기세요.
10. 에버그린 인사이트 — AI와 CMS의 연결이 만드는 미래
10-1. 왜 이 연결은 불가피한 방향인가
워드프레스는 전 세계 웹사이트의 43%를 구동하는 CMS입니다. AI는 글쓰기·분석·최적화의 핵심 도구가 됐습니다. 이 두 가지가 연결되지 않는다면 인간이 AI의 출력물을 복사해 CMS에 붙여 넣는 비효율적인 미들맨 역할을 계속해야 합니다. MCP는 이 미들맨을 제거합니다.
개인적으로 MCP 표준이 확산되는 속도가 예상보다 훨씬 빠르다고 생각합니다. 워드프레스 7.0부터 MCP 지원이 코어에 내장되면서 별도 플러그인 없이도 AI 에이전트와 연결할 수 있는 구조가 됩니다. 이 방향을 먼저 이해하고 익숙해진 운영자가 앞으로의 경쟁에서 유리한 위치를 점하게 됩니다.
10-2. 미래에도 통하는 3가지 원칙
원칙 1 — MCP 표준을 익히세요. 특정 플러그인이나 도구가 아니라 MCP 개념 자체를 이해하면 어떤 AI 도구·CMS 조합에서도 같은 원리로 자동화를 구축할 수 있습니다.
원칙 2 — 자동화는 검토와 함께 운영하세요. AI가 글을 쓰고 발행까지 자동으로 하더라도 최종 품질 검토는 인간이 해야 합니다. 완전 자동화가 아닌 반자동화가 지금 시점에서 가장 현실적인 전략입니다.
원칙 3 — 보안을 자동화의 전제 조건으로 설정하세요. AI 에이전트에게 CMS 접근 권한을 부여하는 것은 강력하지만 그만큼 보안 리스크도 커집니다. 최소 권한 원칙과 정기 백업을 자동화 운영의 기본 루틴으로 삼으세요.
11. Q&A — 가장 많이 묻는 3가지
Q1. 자체 호스팅(WordPress.org) 사이트에서도 작동하나요?
A. 네, WP MCP Ultimate는 자체 호스팅 WordPress.org 사이트에서 완벽하게 작동합니다. WordPress.com 네이티브 커넥터와 달리 WP MCP Ultimate는 어떤 호스팅 환경에서도 설치 가능한 독립 플러그인입니다. 카페24·가비아·Kinsta·SiteGround 등 어떤 호스팅이든 워드프레스 6.9 이상·HTTPS 환경이라면 문제없이 사용할 수 있습니다.
Q2. Claude 외에 다른 AI 도구에서도 같은 플러그인으로 연결할 수 있나요?
A. 가능합니다. WP MCP Ultimate는 MCP 오픈 표준을 구현한 플러그인이므로 Cursor·Windsurf·기타 MCP 지원 AI 클라이언트에서도 동일하게 연결됩니다. Claude Desktop이 현재 가장 널리 사용되지만 MCP 지원 도구는 계속 늘어나고 있습니다.
Q3. 월 비용이 발생하나요?
A. WP MCP Ultimate 플러그인 자체는 무료 오픈소스(GPL-2.0)입니다. Claude Desktop 앱도 무료로 설치할 수 있습니다. 다만 Claude를 실제로 활용하려면 Anthropic의 Claude Pro 또는 API 플랜 구독이 필요합니다. Claude Pro 기준 월정액이 발생하며 이것이 사실상 유일한 비용입니다.
12. 함께 읽으면 좋은 글
이 글은 정보 제공 목적이며 플러그인 버전 업데이트·워드프레스 버전 변경에 따라 세부 설정이 달라질 수 있습니다. 최신 정보는 공식 GitHub 저장소에서 확인하세요.