Claude로 WordPress를 관리하는 오픈소스 MCP 플러그인 개발기

실용적 조언

대규모 자동 수정 작업을 수행하기 전 반드시 dry_run 모드를 사용하여 Claude가 수행할 변경 사항을 미리 검토하라.
보안을 위해 전용 Editor 역할을 가진 별도의 WordPress 사용자 계정을 생성하고 애플리케이션 비밀번호를 사용하여 연결하라.
플러그인 내부에 MCP 어댑터가 포함되어 있으므로 추가적인 npm 설치나 종속성 관리 없이 바로 사용 가능하다.

섹션별 상세

기존 WordPress MCP 솔루션들이 읽기 전용이거나 유료 서비스에 종속되어 있다는 한계를 극복하기 위해 직접 플러그인을 개발했다. 주말 동안 Claude와 Codex를 활용한 바이브 코딩(Vibe-coding)을 통해 WordPress Abilities API를 기반으로 28개의 MCP 기능을 구현했다.

포스트와 페이지의 생성, 편집, 예약, 삭제뿐만 아니라 미디어 관리와 카테고리/태그 관리까지 포함하는 포괄적인 콘텐츠 관리 기능을 제공한다. 특히 블록 단위 편집 기능을 통해 전체 문서를 덮어쓰지 않고도 특정 부분만 정밀하게 수정할 수 있는 구조를 갖췄다.

콘텐츠 품질 관리 도구인 audit-post와 repair-post 기능을 내장했다. 이를 통해 깨진 링크나 구식 HTML 마크업을 자동으로 탐지하고, HTTP를 HTTPS로 전환하거나 레거시 HTML을 구텐베르크 블록으로 변환하는 등의 자동 수리 작업을 수행한다.

LLM과의 데이터 호환성을 위해 Markdown과 WordPress 구텐베르크 블록 간의 양방향 자동 변환 엔진을 구현했다. Claude는 익숙한 Markdown 형식으로 작업하고, 플러그인이 이를 WordPress가 이해하는 블록 구조로 변환하여 저장하는 방식이다.

AI의 자동화 작업 중 발생할 수 있는 위험을 방지하기 위해 dry_run 모드와 동시성 제어 장치를 도입했다. dry_run 모드는 실제 커밋 전에 변경 사항을 미리 확인할 수 있게 하며, expected_modified_gmt 값을 확인하여 여러 사용자가 동시에 수정할 때 발생하는 데이터 덮어쓰기를 방지한다.

용어 해설

모델 컨텍스트 프로토콜(Model Context Protocol): — AI 모델이 외부 데이터 소스나 도구와 표준화된 방식으로 상호작용할 수 있도록 Anthropic이 제안한 개방형 프로토콜이다. 이를 통해 LLM은 로컬 파일, 데이터베이스, API 등에 직접 접근하여 복잡한 작업을 수행한다.
구텐베르크 블록(Gutenberg Block): — WordPress의 현대적인 편집 시스템으로, 모든 콘텐츠 요소를 개별적인 블록 단위로 관리한다. 텍스트, 이미지, 버튼 등을 독립적인 객체로 취급하여 구조화된 데이터 관리를 가능하게 한다.
바이브 코딩(Vibe Coding): — 엄격한 설계나 전통적인 코딩 방식 대신, AI 에이전트와 대화하며 직관적으로 기능을 구현하고 수정해 나가는 새로운 개발 패러다임이다. 개발자는 고수준의 의도를 전달하고 AI가 실제 구현을 담당한다.
서버 측 요청 위조 보호(SSRF Protection): — 공격자가 서버를 대리인으로 삼아 내부 네트워크나 외부 시스템에 비정상적인 요청을 보내는 것을 방지하는 보안 기법이다. 미디어 업로드 등 외부 URL을 처리하는 기능에서 필수적인 안전 장치이다.

언급된 도구

Claude Code추천

터미널 기반의 자율 AI 코딩 에이전트

MCP (Model Context Protocol)추천

AI 모델과 외부 도구 간의 연결 표준

WordPress Abilities API중립

WordPress 6.9 이상에서 제공되는 기능 등록 API

언급된 리소스

GitHubGitHub - anotherpanacea-wordpress-mcp