Claude MCP로 WordPress 자동 운영하기 — 10분 완성 가이드

새벽 2시, 워드프레스 관리자 페이지를 20번째 새로고침하면서 깨달았다. 같은 작업을 매일 반복하고 있다는 사실을. 새 글 업로드, 카테고리 지정, 태그 입력, SEO 메타 데이터 수정, 그리고 미디어 라이브러리에서 이미지 찾기. 30분짜리 단순 반복 작업이 내 창작 시간을 갉아먹고 있었다.

그러다 Anthropic이 공개한 Model Context Protocol(MCP)을 발견했다. Claude Desktop에 WordPress REST API를 연결하는 데 10분 걸렸고, 그날 밤 “2024년 4월 2주차 트렌드 분석 글 초안 3개 draft로 저장해줘”라고 타이핑한 뒤 커피를 내리고 돌아왔을 때, 실제로 세 편의 글이 draft 상태로 올라가 있었다.

그 순간 깨달았다. AI 에이전트가 실제 시스템을 제어하는 시대가 이미 시작됐다는 것을. 이 기록은 MakeMonLab 블로그에 MCP를 적용하면서 겪은 시행착오, 실제 설정 파일, 그리고 아직 아무도 말해주지 않는 함정까지 전부 정리한 결과다.

MCP가 뭐길래 — 5분 개념 정리

Model Context Protocol은 Anthropic이 2024년 11월 공개한 오픈 표준이다. 한 문장으로 요약하면 “AI 모델과 외부 시스템을 연결하는 USB-C 규격”이다. 기존에는 Claude나 GPT가 내 WordPress를 조작하려면 복잡한 커스텀 플러그인, API 래퍼, OAuth 토큰 교환을 직접 구현해야 했다. MCP는 이 모든 걸 표준 프로토콜 하나로 통일했다.

핵심은 세 가지 구성요소다. Host(Claude Desktop), Client(MCP 클라이언트 라이브러리), 그리고 Server(실제 도구를 노출하는 프로세스). WordPress MCP 서버를 실행하면 Claude Desktop이 자동으로 wp_create_post, wp_update_post, wp_list_media 같은 함수를 인식하고, 자연어 명령으로 호출할 수 있게 된다.

왜 이게 혁명적인가. 기존 자동화 툴(Zapier, n8n, Make)은 사전에 정의된 워크플로우만 실행할 수 있었다. MCP는 다르다. “지난주 작성한 초안 중 제목에 2024가 들어간 글만 골라서 카테고리를 inside-lab으로 바꾸고, 썸네일에 골드 배지 오버레이 추가해서 4월 15일 오전 9시 예약 발행” 같은 즉흥 명령이 그대로 실행된다.

설치 전 체크리스트 — 필수 환경 요건

본격적으로 들어가기 전에 환경 요건 5가지를 확인해야 한다. 이걸 건너뛰면 설치 중간에 막히고 원인을 찾느라 2시간씩 날린다.

첫째, Claude Desktop 0.7.0 이상이 설치되어 있어야 한다. 웹 버전 Claude.ai는 MCP 서버를 직접 로드하지 못한다. 이건 아키텍처 제약이라 우회 불가다. 둘째, Node.js 18.x 이상이 필요하다. 대부분의 WordPress MCP 서버가 TypeScript/Node 기반이기 때문. 셋째, WordPress 5.6+와 Application Password 활성화. 일반 관리자 비밀번호를 쓰면 2단계 인증과 충돌한다.

넷째, REST API가 열려 있어야 한다. Wordfence 같은 보안 플러그인이 /wp-json/을 차단하고 있으면 MCP 서버가 연결조차 못 한다. 다섯째, HTTPS 필수. HTTP 사이트에 Application Password를 쓰는 건 비밀번호를 평문으로 전송하는 거나 마찬가지다. Let’s Encrypt 인증서가 없다면 지금 바로 설치하자.

실전 설치 — 10분 완성 가이드

이제 실제 설치 단계다. 나는 @modelcontextprotocol/server-wordpress 공식 구현체를 사용한다. 커뮤니티 서버도 많지만, 업데이트 주기와 보안 패치 측면에서 공식 것이 가장 안전하다.

Gemini 2.5 Flash Image로 블로그 썸네일 자동화 — Python 30줄 구현

1단계 — Application Password 발급. WordPress 관리자 → 사용자 → 프로필 하단 “Application Passwords” 섹션에서 이름을 “Claude MCP”로 입력하고 “Add New Application Password” 클릭. 24자리 비밀번호가 한 번만 표시되니 비밀번호 관리자에 즉시 저장해야 한다. 창을 닫으면 영원히 사라진다.

2단계 — MCP 서버 설치. 터미널에서 npm install -g @modelcontextprotocol/server-wordpress를 실행한다. 전역 설치가 권장되는 이유는 Claude Desktop이 자식 프로세스로 실행할 때 PATH 해석이 꼬이는 경우가 있어서다.

3단계 — claude_desktop_config.json 편집. macOS는 ~/Library/Application Support/Claude/claude_desktop_config.json, Windows는 %APPDATA%\Claude\claude_desktop_config.json에 위치한다. 아래 JSON을 삽입하되, URL과 비밀번호는 본인 것으로 교체한다.

{
  "mcpServers": {
    "wordpress": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-wordpress"],
      "env": {
        "WP_URL": "https://makemonlab.com",
        "WP_USERNAME": "admin",
        "WP_PASSWORD": "xxxx xxxx xxxx xxxx xxxx xxxx"
      }
    }
  }
}

4단계 — Claude Desktop 재시작. 완전히 종료하고 다시 실행한다. 우측 하단 망치 아이콘을 클릭했을 때 “wordpress” 서버가 초록색으로 표시되면 성공이다. 빨간색이면 로그를 확인해야 한다(아래 트러블슈팅 섹션 참고).

MCP 서버 선택 가이드 — 공식 vs 커뮤니티 비교

WordPress MCP 서버는 현재 5종류 이상이 공개돼 있다. 각각 장단점이 명확해서 선택이 중요하다. 내가 3개월간 전부 테스트한 결과를 정리하면 아래와 같다.

내 추천은 운영 사이트는 공식 서버 + wp-cli-bridge 조합이다. 공식으로 콘텐츠 CRUD를 처리하고, 서버 설정이나 DB 쿼리 같은 저수준 작업은 wp-cli-bridge로 넘긴다. 이렇게 분리하면 실수로 프로덕션 DB를 건드릴 위험이 줄어든다.

실전 활용 시나리오 — 매일 쓰는 7가지 패턴

설치만 하고 끝나면 의미가 없다. 실제로 매일 반복되는 작업을 MCP로 어떻게 줄였는지, 구체적인 프롬프트와 함께 공개한다.

Midjourney vs Stable Diffusion vs Gemini 2.5 Flash Image — 실전 품질 비교

아래 차트는 내 실제 작업 로그를 기반으로 한 주간 소요 시간 비교다. MCP 도입 전후 8주 평균치를 비교했다.

자주 쓰는 명령어 — 실전 치트시트

MCP를 제대로 활용하려면 자연어 프롬프트의 패턴을 익혀야 한다. 내가 3개월 동안 축적한 명령어 중 활용 빈도 상위 10개를 표로 정리했다. 바로 복붙해서 쓸 수 있게 작성했다.

한 가지 팁: 숫자를 명시적으로 제시하면 정확도가 올라간다. 최근 글 몇 개보다 최근 10개라고 하면 MCP가 limit 파라미터를 확실히 전달한다.

트러블슈팅 — 내가 겪은 5가지 에러와 해결법

설치가 매끄럽게 끝나지 않을 가능성이 높다. 내가 실제로 마주친 오류들과 검증된 해결법을 공개한다.

첫 번째 에러 — Server wordpress failed to start. 원인의 80%는 claude_desktop_config.json의 JSON 문법 오류다. 콤마, 따옴표를 꼼꼼히 확인하고 VS Code에서 파일을 열어 에러 하이라이팅을 보자. 두 번째로 흔한 원인은 Node.js 버전 호환성이다. node –version으로 18 이상인지 확인.

두 번째 에러 — 401 Unauthorized. Application Password를 복사할 때 공백이 누락됐을 확률이 99%다. 24자리 중간중간 공백이 포함돼 있는데, 이걸 제거하면 인증이 실패한다. 공백 포함 원본을 그대로 붙여넣어야 한다.

노코드 vs AI 코딩 — 1인 SaaS 시작하기 전 반드시 알아야 할 선택 기준

세 번째 에러 — REST API disabled. Wordfence, iThemes Security, Really Simple Security 같은 보안 플러그인이 REST API를 차단한 경우다. 해당 플러그인 설정에서 Disable REST API for non-logged-in users 옵션을 찾아 끄거나, 화이트리스트에 Application Password 사용자를 추가하면 해결된다.

네 번째 에러 — Rate limit exceeded. 공유 호스팅(카페24, 블루호스트 등)에서 자주 발생한다. 호스팅 측 WAF가 분당 요청 수를 제한해서 MCP가 대량 작업을 수행하다 차단된다. VPS로 이전하거나, 프롬프트에서 작업 개수를 나눠 실행해야 한다.

다섯 번째 에러 — Context window exceeded. Claude가 한번에 처리할 수 있는 토큰에는 한계가 있다. 수백 개 글을 일괄 수정하려 하면 에러가 난다. 50개 단위로 쪼개서 요청하는 게 실용적이다. 글 1~50번 처리 후 알려줘, 다음 배치 진행하겠다라고 명시하면 안정적이다.

단점과 한계 — 솔직한 평가

3개월 사용 후 MCP가 만능은 아니다는 결론에 도달했다. 도입 전에 반드시 알아야 할 한계가 있다.

첫 번째 단점 — Claude Desktop 의존성. 현재 MCP를 제대로 쓰려면 Claude Desktop 앱이 필수다. 모바일에서는 작동하지 않는다. 외출 중 급하게 draft를 만들어야 할 때 불편하다. 웹 기반 MCP 지원이 언제 나올지 미정이다.

두 번째 단점 — 비결정적 실행. 같은 프롬프트를 두 번 넣어도 결과가 미세하게 달라질 수 있다. LLM 특성상 피할 수 없는 한계다. 특히 중요한 글 10개 골라줘 같은 주관적 판단이 필요한 명령은 결과 일관성이 낮다. 프로덕션 파이프라인에서는 반드시 사람의 검증 단계가 필요하다.

세 번째 단점 — 보안 리스크. Application Password는 상당히 강력한 권한을 가진다. 실수로 모든 글 삭제해줘라고 입력하면 실제로 삭제될 수 있다. MCP 서버를 읽기 전용으로 제한하는 옵션이 아직 미흡하다. 중요한 작업 전에 DB 백업을 거는 습관을 들여야 한다.

Perplexity vs ChatGPT Search vs Claude Projects — 리서치 업무 실전 비교

네 번째 단점 — 러닝 커브. 프롬프트를 잘 써야 좋은 결과가 나온다. 너무 모호하면 엉뚱한 글을 수정하고, 너무 길면 토큰 초과가 난다. 프롬프트 엔지니어링 자체가 새로운 학습 영역이라는 점을 감수해야 한다.

자주 묻는 질문

Q1. MCP를 쓰면 API 비용이 많이 나오나요?
Claude Pro 구독($20/월) 하나로 대부분의 WordPress 운영이 커버된다. 월 100만 토큰 이상 사용하는 헤비유저라면 Claude API 별도 결제가 필요한데, 일반 블로거 기준으로는 과금 걱정이 거의 없다. 실측 기준 매일 1시간씩 사용해도 월 10~15달러 수준이다.

Q2. 기존 WP 자동화 플러그인(AutoBlogging Pro 등)과 뭐가 다른가요?
기존 플러그인은 사전 정의된 시나리오만 처리한다. MCP는 즉흥 자연어 명령을 받아 처리한다. 예를 들어 3월에 조회수 100 이하인 글만 카테고리를 bakmag으로 옮기고 noindex 처리해줘 같은 복합 조건은 기존 플러그인으로 불가능하지만 MCP로는 한 문장이면 끝난다.

Q3. 보안이 걱정됩니다. 안전한가요?
Application Password는 언제든 즉시 폐기 가능하다. 이상한 동작이 의심되면 WordPress 관리자 → 사용자 → 해당 Application Password의 Revoke 버튼 한 번으로 차단된다. 추가로 fail2ban + Cloudflare WAF를 적용하면 REST API 남용 공격도 막을 수 있다.

Q4. 여러 WordPress 사이트를 동시에 관리할 수 있나요?
가능하다. claude_desktop_config.json의 mcpServers 객체에 wordpress-site1, wordpress-site2처럼 서로 다른 키로 서버를 여러 개 등록하면 된다. 프롬프트에서 site1의 최근 글을 보여줘처럼 사이트 이름을 명시하면 Claude가 알아서 올바른 서버를 호출한다.

— MakeMonLab · 비즈니스 인사이트 & 실전 전략

—

**참고 자료**

– [위키백과](https://ko.wikipedia.org/wiki/Claude_MCP로_WordPress_자동_운영하기)