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·Perfmatters 관련 글 글 7 · 도구 3

🗂️ WordPress

▸📂 WP Rocket·Perfmatters4

📋 WP Rocket 설정 가이드 📄 Perfmatters 가이드 📄 WP Rocket With Perfmatters 📄 WP Rocket MCP Server

▸📂 속도 테스트·비교3

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

🧰 추천 도구3

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

WordPress · WP Rocket

WP Rocket 설정 가이드: 직관적 UI, 워드프레스 캐시 플러그인 $59의 가치

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

글 보기 →

WordPress · Perfmatters

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

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

글 보기 →

WordPress · Perfmatters

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

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

글 보기 →

WordPress · MCP

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

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

현재 콘텐츠

WordPress · 속도 테스트

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

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

글 보기 →

WordPress · 캐시 플러그인

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

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

글 보기 →

WordPress · 속도 개선

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

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

글 보기 →

도구 · 워드프레스

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

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

도구 열기 →

도구 · 도메인

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

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

도구 열기 →

도구 · IP

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

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

도구 열기 →

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