워드프레스 MCP Server: Adapter 플러그인으로 Claude Code 연결

워드프레스 MCP Server는 워드프레스 사이트의 기능을 MCP(Model Context Protocol) 형식으로 열어, Claude 같은 AI가 도구로 호출할 수 있게 하는 연결 지점입니다. 사이트가 할 수 있는 일은 워드프레스 6.9부터 코어에 포함된 Abilities API에 등록되고, Adapter 플러그인이 이 목록을 MCP 도구로 바꿔 AI에 제공합니다.

Adapter 플러그인 0.7.0을 설치한 뒤 Claude Code를 연결하는 과정을 정리했습니다.

1️⃣ 애플리케이션 비밀번호 생성

MCP Adapter의 기본 서버는 워드프레스 사용자로 인증된 요청만 처리하며, Claude Code에는 로그인 비밀번호 대신 애플리케이션 비밀번호를 등록합니다. 관리자 화면 [Users] > [Profile]의 [Application Passwords]에서 이름을 입력하고 [Add Application Password]를 누르면 생성됩니다. 값은 생성할 때 한 번만 표시되므로 바로 복사합니다.

테스트에는 관리자 계정을 사용했지만, 운영 중인 사이트라면 필요한 권한만 가진 전용 사용자를 만들어 그 계정으로 생성하는 편이 맞습니다. Claude Code가 실행하는 작업은 모두 그 사용자의 권한 안에서 처리되기 때문입니다.

2️⃣ Claude Code에 워드프레스 MCP 서버 등록

워드프레스 공식 문서는 HTTP 연결에 Node.js 프록시 [@automattic/mcp-wordpress-remote]를 안내하지만, Claude Code는 HTTP MCP를 직접 지원해 프록시 없이 등록합니다. 테스트한 리눅스 서버에도 Node.js는 설치되어 있지 않았습니다.

인증 값은 [사용자명:애플리케이션 비밀번호]를 Base64로 변환한 문자열이며, 터미널에서 아래 명령으로 만듭니다.

printf '%s' '사용자명:애플리케이션 비밀번호' | base64

변환한 값을 [Basic] 뒤에 넣어 등록하며, 주소는 사이트 도메인 뒤에 [/wp-json/mcp/mcp-adapter-default-server]를 붙인 기본 서버 주소입니다.

claude mcp add --transport http --scope user wordpress https://example.com/wp-json/mcp/mcp-adapter-default-server --header "Authorization: Basic 인증값"

명령의 [wordpress]는 등록 이름이며, [인증값] 자리에 변환한 문자열을 넣습니다. [–scope user]로 등록하면 어느 폴더에서 연 세션이든 이 연결을 사용합니다.

3️⃣ 연결 확인과 실행 가능한 Ability

[claude mcp list]를 실행해 등록 이름 줄 끝에 [✔ Connected]가 표시되면 연결된 것이며, 워드프레스 도구는 새로 연 세션부터 표시됩니다.

claude mcp list
wordpress: https://example.com/wp-json/mcp/mcp-adapter-default-server (HTTP) - ✔ Connected

연결되었으니 사이트 정보 조회도 바로 될 것으로 생각하기 쉽지만, 기본 서버는 [mcp.public] 표시가 있는 Ability만 실행합니다. 테스트 사이트에서 조회된 Ability는 WP Rocket이 공개한 12개로, 캐시 비우기와 캐시 상태 확인, 페이지 성능 점수 조회가 포함되어 있었습니다. 새 세션에서 WP Rocket 캐시 상태를 요청하자 [wp-rocket/get-cache-health]가 실행되어 프리로드 완료 4개, 대기 0개를 반환했습니다.

워드프레스 코어의 사이트 정보, 사용자 정보, 환경 정보 Ability는 [is not exposed via MCP (mcp.public!=true)] 오류로 실행되지 않았습니다. 코어 Ability는 [wp_register_ability_args] 필터로 [mcp.public]을 켜야 열리며, 방법은 워드프레스 공식 개발자 블로그에 안내되어 있습니다.

🔢 FAQ & 추천 콘텐츠

🔗 추천 콘텐츠

유뉴 도구 워드프레스 테마 확인 · 플러그인 감지 주소만 넣으면 그 사이트가 쓰는 테마와 플러그인, 호스팅까지 나옵니다. 빠른 사이트를 만났을 때 무엇으로 만들었고 어디에 올려 뒀는지 확인해 보세요. 도구 열기 →

MCP WP Rocket MCP Server AI 도구가 관리자 화면 대신 캐시를 지우고 설정을 바꾸는 연결 방법입니다. MCP Claude MCP 기본 개념과 설정 MCP가 무엇이고 Claude에 어떻게 연결하는지 기본 구조를 설명합니다. Linux Claude MCP Linux 서버 연결 SSH로 리눅스 서버를 Claude에 연결하는 설정 방법입니다.

ℹ️ 제휴 안내
본 사이트의 콘텐츠에는 제휴 링크가 포함되어 있습니다. 방문자가 이 링크를 통해 상품 또는 서비스를 구매하면 본 사이트는 판매처로부터 수수료를 지급받습니다. 이 과정에서 구매자가 지불하는 금액^{(이벤트 할인 시 금액이 내려갑니다↓)}은 오르지 않습니다. 게시된 가격·할인·재고 정보는 작성 시점 기준이며 실제와 다를 수 있으므로, 구매 전 판매처에서 최종 확인하시기 바랍니다. 상품 선정과 평가는 자체 기준에 따라 작성되며, 수수료 지급 여부가 소개 순서나 평가 내용에 영향을 주지 않습니다.