WP Rocket MCP Server: AI 도구로 캐시와 설정 다루기

WP Rocket MCP Server를 켜면 Claude 같은 AI 도구가 관리자 화면 대신 캐시를 지우고 설정을 바꿉니다. MCP는 AI 도구가 프로그램을 직접 다루게 하는 연결 규격이며, 애플리케이션 비밀번호로 연결하고 끊는 방법과 열리는 기능 12개를 정리했습니다.

MCP가 무엇인지는 Claude MCP 기본 개념 글에서 확인할 수 있습니다.

1️⃣ WP Rocket MCP Server란?

WP Rocket MCP Server는 [설정 → WP Rocket → Tools] 탭 맨 위에 있으며, [Connect your AI tool to WP Rocket]이라고 적혀 있습니다. 켜고 끄는 스위치는 없고, [How to set up MCP] 버튼은 도움말 문서를 엽니다.

WP Rocket 3.23(2026년 7월 9일)부터 모든 라이선스에 포함되었으며, WP Rocket을 켜 두면 MCP 서버도 함께 열립니다. 워드프레스 6.9부터 코어에 들어간 Abilities API에 기능 12개를 등록하고, MCP Adapter도 플러그인 안에 들어 있어 따로 설치할 것이 없습니다.

2️⃣ WP Rocket MCP Server 연결 방법

가장 간단한 방법은 Claude에 사이트를 커스텀 커넥터로 추가하는 OAuth 연결이며, 비밀번호나 구성 파일 없이 워드프레스 관리자 승인만 거칩니다. claude.ai 웹과 Claude 데스크톱 모두 같은 순서입니다.

1. Claude [사용자 지정 → 커넥터]에서 [추가 → 커스텀 커넥터 추가]를 누릅니다.
2. 이름에 사이트 이름을, MCP 서버 URL에 [https://내 도메인/wp-json/mcp/mcp-oauth-server]를 넣고 [계속]을 누릅니다.

3. 인증 방식은 감지된 기본값 그대로 두고 [추가]를 누른 뒤 [연결]을 누릅니다.
4. 워드프레스 승인 화면에서 [Allow]를 누릅니다. 관리자 계정으로 로그인되어 있지 않으면 로그인부터 합니다.

연결되면 커넥터 화면에 도구 3개가 보이며, 기본값은 모두 [승인 필요]입니다. 무료 계정은 커스텀 커넥터를 하나만 만들 수 있어 사이트 하나만 연결되며, 여러 사이트는 Pro나 Max 계정이 필요합니다.

새 채팅에서 사이트에서 사용할 수 있는 MCP 도구를 물으면, Claude가 도구를 쓰기 전에 [거부 · 항상 허용 · 한 번만 허용]을 먼저 묻습니다.

연결 중에 아래 이미지와 같은 오류가 발생하여

원인 분석 결과, REST API 설정 시 발생하는 오류로 확인되었습니다.

🔧 Perfmatters 사용 시 생기는 REST API 오류 해결

Perfmatters에서 [REST API 끄기]를 [로그아웃 사용자]로 켜 둔 사이트는 승인과 연결까지 끝나도 커넥터에 도구가 하나도 나오지 않고, 잠시 뒤 [연결 문제]로 바뀝니다. Perfmatters가 Claude의 요청을 로그인하지 않은 방문자로 보고, MCP가 토큰을 확인하기 전에 막기 때문입니다.

워드프레스 REST API: 로그아웃 상태만 막는 이유

[Perfmatters → 코드]에서 새 PHP 스니펫을 만들고, 아래 코드를 [<?php] 줄 없이 넣어 켠 상태로 저장합니다. MCP 주소 한 곳만 예외로 빼는 코드라 다른 REST API 차단은 그대로 남습니다.

⚙️ Perfmatters 설정 화면새 코드 스니펫

perfmatters

⚙General

JSJavaScript

✎CSS

◷Preloading

▣Lazy Loading

AFonts

◍CDN

▥Analytics

</>Code①

🔧Tools

☰Database

🔑License

?Support

<> Code

All Snippets / MCP REST API exception

ActiveSave Snippet④

Name②

MCP REST API exception

Location

Everywhere⌄

Type

PHPJSCSSHTML

Code③Copy✓

<?php

1// Let WP Rocket MCP (OAuth) requests through the Perfmatters REST API restriction

2add_filter('perfmatters_rest_api_exceptions', function($exceptions) {

3 $exceptions[] = '/mcp/mcp-oauth-server';

4 return $exceptions;

5});

1. ①[Code] 메뉴에서 [New Snippet]을 누릅니다.
2. ②이름을 적고 [Location]은 [Everywhere], [Type]은 [PHP] 그대로 둡니다.
3. ③이 화면의 [Copy]로 코드를 가져와 [<?php] 줄 아래 코드 칸에 붙여 넣습니다.
4. ④스위치를 [Active]로 켜고 [Save Snippet]을 누릅니다.

저장한 뒤 Claude 커넥터 화면에서 [다시 연결]을 누르면 도구 3개가 나타납니다.

이번 WP Rocket MCP Server REST API Error는 Perfmatters를 사용하는 독자용이지만 이미 Claude를 쓰는 독자는 다른 플러그인에 REST API 설정으로 인한 동일한 오류 메시지가 나온다면 이 코드를 참조하여, Claude에게 고쳐달라고 요청하여, 본인의 워드프레스 사이트에 맞는 버전으로 반영하여 사용할 수 있습니다.

Claude 데스크톱에서는 애플리케이션 비밀번호로도 연결할 수 있습니다. 워드프레스 [사용자 → 프로필 → 애플리케이션 비밀번호]에서 비밀번호를 만들고, Claude 데스크톱 [설정 → 개발자]의 구성 파일에 아래 항목을 넣은 뒤 앱을 다시 엽니다.

{
  "mcpServers": {
    "wp-rocket-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@automattic/mcp-wordpress-remote@latest"
      ],
      "env": {
        "WP_API_URL": "https://내-도메인/wp-json/mcp/mcp-adapter-default-server",
        "WP_API_USERNAME": "내-사용자-이름",
        "WP_API_PASSWORD": "xxxx xxxx xxxx xxxx xxxx xxxx",
        "OAUTH_ENABLED": "false"
      }
    }
  }
}

윈도우는 npx 명령이 돌아야 하므로 Node.js가 필요합니다. 연결을 끊을 때는 그 애플리케이션 비밀번호만 폐기하면 됩니다.

3️⃣ AI 도구가 할 수 있는 일

WP Rocket 기능 12개는 Claude에 보이는 MCP 도구 세 개([Discover Abilities]·[Get Ability Info]·[Execute Ability])를 거쳐 실행되며, 기능은 설정·캐시·Rocket Insights 세 갈래입니다.

설정 바꾸기는 허용 목록에 있는 옵션만 가능하며, 아래 화면에서 [AI 불가]로 표시한 다섯 개는 바꾸지 못합니다.

4️⃣ 사용 예

testpilotweb.com에 연결한 뒤 Claude에게 [홈페이지 캐시만 지워 줘]라고 하자, 승인 창에 실행할 기능(wp-rocket/clear-url-cache)과 주소가 먼저 표시되었습니다.

[한 번만 허용]을 누르자 서버에서 홈페이지 캐시 파일만 지워졌으며, 다른 글의 캐시는 그대로 남았습니다.

설정은 관리자 화면에 들어가지 않고 물어서 확인할 수 있으며, [지금 Delay JavaScript execution이 켜져 있어?]라고 묻자 설정 값과 제외 목록 상태를 답했습니다.

한 채팅에서 처음 쓸 때는 기능 목록과 설명을 읽는 승인 창이 먼저 두 번 뜨며, 읽기 기능도 [Execute Ability]를 거치므로 설정을 읽을 때도 승인 창이 뜹니다.

5️⃣ 주의할 점

AI 도구가 설정을 바꾸거나 캐시를 지우는 작업은 사용자가 승인해야 실행됩니다. 애플리케이션 비밀번호는 만든 화면에서 언제든 폐기할 수 있습니다.

캐시 상태 확인과 사전 로드 추정은 WP Rocket의 [Preload Cache]가 켜져 있어야 결과가 나옵니다.

연결이 안 될 때는 구성 파일부터 봅니다. 항목 사이의 쉼표를 빠뜨렸거나, 주소·사용자 이름·비밀번호 자리를 바꾸지 않고 저장한 경우가 많습니다.

🧭 WP Rocket 관련 글 글 16 · 도구 3

🗂️ What is WP?

▸🚀 What is WP Rocket6

📋 WP Rocket 설정 가이드 📄 WP Rocket MCP Server 📄 WP Rocket 한글 URL 📄 nginx njs 📄 WP Rocket 다국어 캐시 📄 gclid 캐시

▸📂 속도 테스트·비교3

📄 WP Rocket 속도 테스트 📝 캐시·최적화 플러그인 📝 속도 개선 사례

▸📂 캐시 개념2

📋 캐시: 정의와 모든 분야 📄 웹사이트 캐시 & 서버 내부 캐시

▸📂 호스팅2

📋 BEST 호스팅 TOP 7 📄 빠른 호스팅 2026

🧰 추천 도구3

🛠️ 워드프레스 감지 🛠️ 후이즈 도메인 조회 🛠️ 내 아이피 확인

📄 WP Rocket With Perfmatters 📄 Perfmatters 가이드

WordPress · Perfmatters

WP Rocket With Perfmatters 사용 방법: 최적화 기능 설정 가이드

WP Rocket과 Perfmatters를 함께 쓸 때의 설정 방법입니다.

글 보기 →현재 콘텐츠

WordPress · Perfmatters

Perfmatters 플러그인 리뷰 & 가이드: 5년 동안 사용한 워드프레스 성능 최적화 설정 방법

Perfmatters 메뉴별 권장 설정과 Script Manager 사용 방법입니다.

글 보기 →현재 콘텐츠

WordPress · WP Rocket

WP Rocket이란: 종합 캐시 플러그인의 주요 기능과 단점과 장점

페이지를 캐시 파일로 응답하는 WP Rocket의 동작과 요금을 정리한 글입니다.

글 보기 →현재 콘텐츠

WordPress · WP Rocket

WP Rocket 설정 가이드: 메뉴별 기본 세팅과 20% Promo Code

WP Rocket 메뉴별 기본 세팅과 요금을 정리한 글입니다.

글 보기 →현재 콘텐츠

WordPress · MCP

WP Rocket MCP Server: AI 도구로 캐시와 설정 다루기

AI 도구에서 WP Rocket 캐시와 설정을 다루는 방법입니다.

글 보기 →현재 콘텐츠

WordPress · WP Rocket

WP Rocket 한글 URL

한글 주소 요청의 인코딩 대소문자 때문에 nginx가 캐시 파일을 찾지 못하는 원인과 njs로 고치는 방법입니다.

글 보기 →현재 콘텐츠

Server · nginx

nginx njs: 모듈 설치와 js_set 설정, reload 적용으로 자바스크립트 변수 만들기

nginx 설정 안에서 자바스크립트 함수로 변수를 만드는 njs 모듈을 설치하고 js_set 변수를 reload로 적용하는 방법입니다.

글 보기 →현재 콘텐츠

WordPress · WP Rocket

WP Rocket 다국어 캐시

임시글 저장 때 번역판 캐시가 언어 폴더째 삭제되는 원인과 그것을 막는 코드입니다.

글 보기 →현재 콘텐츠

Server · 캐시

gclid 캐시: 광고 클릭 쿼리와 페이지 캐시 키, 첫 바이트 실측

광고 클릭 주소 끝에 붙는 gclid 쿼리를 무시하고 쿼리 없는 주소의 캐시 파일로 응답하는 동작을 첫 바이트로 측정한 글입니다.

글 보기 →현재 콘텐츠

WordPress · 속도 테스트

워드프레스 캐시 플러그인 WP Rocket 속도 테스트: 설정 전·후 성능 최적화 비교 분석

WP Rocket 설정 전과 후의 속도를 재서 비교한 글입니다.

글 보기 →현재 콘텐츠

WordPress · 캐시 플러그인

워드프레스 캐시 플러그인 및 최적화 플러그인

워드프레스 캐시 플러그인과 최적화 플러그인을 나눠 정리한 글입니다.

글 보기 →현재 콘텐츠

WordPress · 속도 개선

워드프레스 속도 개선 사례: 캐시 계층을 정리 후 검색 노출 Recovery(2026-08)

캐시 계층을 정리한 뒤 검색 노출이 돌아온 사례입니다.

글 보기 →현재 콘텐츠

Cache · 개념

캐시: 정의와 캐싱이 사용되는 모든 분야

CPU부터 브라우저까지 캐시가 쓰이는 분야를 하나의 트리로 정리한 글입니다.

글 보기 →현재 콘텐츠

WordPress · 캐시

웹사이트 캐시 & 서버 내부 캐시: 워드프레스 캐시가 작동하는 방식

워드프레스 요청이 브라우저·CDN·페이지 캐시·OPcache·Redis를 거치는 순서를 시뮬레이터로 보여 줍니다.

글 보기 →현재 콘텐츠

WordPress · 호스팅

BEST 워드프레스 호스팅 비교: 2026년 호스팅 TOP 7 추천

워드프레스 호스팅 7곳의 요금과 구성을 비교한 글입니다.

글 보기 →현재 콘텐츠

WordPress · 호스팅 속도

빠른 워드프레스 호스팅 2026: 벤치마크로 비교한 8곳의 속도

벤치마크 숫자로 워드프레스 호스팅 8곳의 속도를 비교한 글입니다.

글 보기 →현재 콘텐츠

도구 · 워드프레스

워드프레스 테마 확인 · 플러그인 감지

마음에 드는 사이트의 주소를 넣으면 테마·플러그인·호스팅이 나옵니다.

도구 열기 →

도구 · 도메인

후이즈 도메인 조회 · 네임서버 확인

도메인 등록 정보와 만료일, 네임서버와 DNS 레코드를 한 화면에서 확인합니다.

도구 열기 →

도구 · IP

내 아이피 확인: 공인 IP와 위치 조회

호스팅 방화벽에 등록할 내 공인 IP와 위치를 확인합니다.

도구 열기 →

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