Royal MCP

보안 우선 WordPress용 MCP 서버. Claude, ChatGPT, Gemini를 API 키 + OAuth 2.1 인증, 전체 활동 로깅, 기능별 접근 제어와 함께 WordPress 사이트에 연결하세요.

WordPress.org에서 다운로드 · 문서 · Royal Plugins

사이트를 Model Context Protocol 서버로 노출하는 WordPress 플러그인입니다. AI 에이전트 — Claude.ai 웹, Claude Desktop, ChatGPT, 사용자 정의 클라이언트 — 는 모든 호출이 기능 게이팅, 속도 제한, 감사 로그를 거쳐 게시물, 페이지, 미디어, 사용자, 메뉴, WooCommerce 주문, Elementor 페이지를 읽고 쓸 수 있습니다. 공식 WordPress.org 플러그인 디렉토리를 통해 배포됩니다.

빠른 요약

Related MCP server: wp-mcp

기능

WordPress 코어(84개 도구, 항상 사용 가능)

• 콘텐츠 — 게시물, 페이지, 사용자 정의 게시물 유형(전체 CRUD + 개정 + 대표 이미지)

• 분류 — 카테고리, 태그, 사용자 정의 분류, 용어 메타, 게시물-용어 연결

• 미디어 — 탐색, 업로드(URL 또는 base64), 메타데이터 업데이트, 삭제

• 댓글 — 생성, 중재(승인 / 스팸 / 휴지통)

• 사용자 — 표시 이름 + 역할 읽기(이메일과 사용자 이름은 노출되지 않음)

• 메뉴 — 읽기, 항목 생성, 재정렬, 파괴적 쓰기 보호 장치가 있는 업데이트

• 테마 — 사용자 정의 CSS, 테마 모드, 활성 테마 감지

• 사이트 — 고유주소 구조, 옵션(허용 목록), 사이트 정보

• 검색 — 쿼리별 콘텐츠 전체 검색

• SEO — 플러그인이 활성화된 경우 Yoast / Rank Math / AIOSEO 메타 읽기/쓰기

• 진단 — 사이트 상태(한 번의 호출로 WP/PHP/MySQL/플러그인/테마/cron), PHP 오류 로그 꼬리, WP cron 일정, MCP royal_mcp_connection_health(경로, 인증 방법, 세션 ID, 플러그인 버전, Divi + Elementor + Gutenberg의 활성 페이지 빌더 버전 반환)

플러그인 통합(80개 도구, 조건부)

통합된 플러그인이 활성화된 경우에만 자동 등록됩니다.

WordPress Abilities API 브리지(WP 6.9+)

WordPress 6.9에는 Abilities API가 포함되었습니다. 이는 플러그인이 AI 에이전트가 호출할 수 있는 유형화된 기능을 등록할 수 있게 하는 프리미티브입니다. 1.4.38부터 모든 Royal MCP 도구는 WordPress ability로도 등록되어 동일한 핸들러에 세 가지 방법으로 접근할 수 있습니다:

1. 네이티브 — Royal MCP의 /wp-json/royal-mcp/v1/mcp Streamable HTTP 엔드포인트(변경 없음, 항상 사용 가능).

2. WP MCP Adapter — wordpress/mcp-adapter 패키지가 설치된 경우, Royal MCP는 어댑터의 기본 서버와 함께 mcp_adapter_init 훅에 명명된 royal-mcp-server를 등록합니다.

3. WP 코어 REST — WP 코어 엔드포인트를 선호하는 호출자를 위한 /wp-json/wp-abilities/v1/abilities/{name}/run에서의 직접 ability 호출.

동일한 핸들러, 세 가지 전송 방식, 한 세트의 도구별 기능 게이트. 브리지는 royal_mcp_abilities_registration_enabled 옵션으로 비활성화할 수 있습니다(기본값: 켜짐).

우리가 하지 않는 것

명시적 범위 경계 — 통합 모델은 "모든 API 표면을 노출"하는 것이 아니라 "안정적으로 작동하는 좁은 도구"입니다.

• Elementor 위젯 수준의 처음부터 생성 없음. 원자적 위젯(Editor V4)은 불투명하게 통과됩니다. Elementor 자체가 이를 변경할 수 있으므로 원자적 스키마를 디코딩하지 않습니다.

• Beaver Builder / Bricks 페이지 빌더 JSON 쓰기 없음. 표준 게시물 콘텐츠는 읽기/쓰기가 가능하며, 페이지 빌더별 JSON 저장소는 전용 도구로 다루지 않는 한 불투명합니다. (Elementor와 Divi에는 전용 도구가 있습니다 — 위 통합 표 참조.)

• 테마 빌더 템플릿 생성 없음(Elementor 또는 기타).

• 코어 파일 수정 없음 — Royal MCP는 wp-content/themes, wp-includes, wp-admin에 절대 쓰지 않습니다.

• MCP를 통한 플러그인 설치 또는 업그레이드 없음. 발견은 가능, 설치/활성화/비활성화는 불가.

• 원시 SQL 없음. 쿼리는 WP_Query와 $wpdb->prepare()를 통해서만 실행됩니다.

Royal MCP Pro(유료)

무료 플러그인은 개별 사이트 소유자에게 완전한 기능을 제공합니다. Royal MCP Pro는 에이전시와 다중 사이트 운영자를 위해 확장합니다:

• Divi Pro 스위트 — 페이지 복제, 이미지 교체, 템플릿 가져오기, 전체 라이브러리 CRUD, D4→D5 마이그레이터, 전역 프리셋 일괄 적용(8개 도구)

• Elementor Pro 심화 — 무료 통합을 넘어선 추가 Elementor 도구

• 유니버설 감사 로그 — 모든 AI 작업이 귀속 정보와 함께 기록 + 내보내기

• 모든 쓰기에 72시간 실행 취소 — 모든 파괴적 Pro 도구는 실행 취소 토큰을 반환하며, 해당 기간 내에 모든 작업을 되돌릴 수 있습니다

• 표준 WordPress 업데이터를 통한 라이선스 게이트 업데이트 — 외부 라이선스 서버에 대한 런타임 의존성 없음

royalplugins.com/royal-mcp-pro에서 자세히 알아보기

연결

설치

1. WordPress.org에서 설치(권장 — WP 관리자를 통한 자동 업데이트) 또는 GitHub 릴리스 zip을 업로드합니다.

2. Royal MCP → 설정 → API 키 생성을 클릭합니다.

3. 아래에서 클라이언트를 선택합니다.

Claude.ai 웹(OAuth — 권장)

가장 쉬운 방법 — 구성 파일 편집 없음, 클라이언트에 API 키 없음.

1. Claude.ai에서 → 설정 → 커넥터 → 사용자 정의 커넥터 추가.

2. URL: https://yoursite.com/wp-json/royal-mcp/v1/mcp

3. 메시지가 표시되면 OAuth 동의 화면을 승인합니다. Claude.ai가 사이트에 대한 동적 클라이언트 등록 + PKCE 흐름을 처리합니다.

Claude Desktop(.mcpb 원클릭 번들 — 1.4.38의 새로운 기능)

가장 쉬운 Claude Desktop 경로 — mcp-remote 없음, npx 없음, 구성 파일 편집 없음.

1. 최신 GitHub 릴리스에서 royal-mcp-1.4.38.mcpb를 다운로드합니다.

2. .mcpb 파일을 더블 클릭 — Claude Desktop이 설치 프롬프트를 엽니다.

3. 메시지가 표시되면 사이트 URL + API 키를 입력합니다. 연결이 활성화됩니다.

번들에는 Claude Desktop에 이미 포함된 Node ≥18용 제로 의존성 stdio-to-HTTPS 브리지가 포함되어 있습니다. .mcpb 사양은 Claude Desktop MCP Bundles를 참조하세요.

Claude Desktop(mcp-remote를 통한 OAuth)

{
  "mcpServers": {
    "my-wordpress": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://yoursite.com/wp-json/royal-mcp/v1/mcp"]
    }
  }
}

Config path: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) 또는 %APPDATA%\Claude\claude_desktop_config.json (Windows).

Claude Desktop (API key)

OAuth를 건너뛰고 헤더를 통해 인증합니다:

{
  "mcpServers": {
    "my-wordpress": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://yoursite.com/wp-json/royal-mcp/v1/mcp",
        "--header", "X-Royal-MCP-API-Key:YOUR_API_KEY"
      ]
    }
  }
}

ChatGPT

ChatGPT의 사용자 지정 MCP 커넥터는 Claude.ai 웹과 동일한 URL을 사용합니다. ChatGPT의 커넥터 흐름을 따라 https://yoursite.com/wp-json/royal-mcp/v1/mcp를 붙여넣으세요.

Raw HTTP (사용자 지정 클라이언트)

# 1. Initialize a session. -i prints headers so you can grab Mcp-Session-Id.
curl -i -X POST https://yoursite.com/wp-json/royal-mcp/v1/mcp \
  -H "X-Royal-MCP-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "method": "initialize",
    "id": 1,
    "params": {
      "protocolVersion": "2025-11-25",
      "capabilities": {},
      "clientInfo": {"name": "my-app", "version": "1.0"}
    }
  }'

# 2. List available tools using the session id from the response header.
curl -X POST https://yoursite.com/wp-json/royal-mcp/v1/mcp \
  -H "X-Royal-MCP-API-Key: YOUR_KEY" \
  -H "Mcp-Session-Id: <session_id>" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc": "2.0", "method": "tools/list", "id": 2}'

보안 모델

전체 보안 아키텍처: royalplugins.com/support/royal-mcp/

프로젝트 상태

• 활발한 유지보수 — 대략 주간 릴리스. 변경 로그는 releases를 참조하세요.

• MCP 사양 준수 — Streamable HTTP transport (2025-11-25) 구현.

• 이슈 — github.com/royalplugins/royal-mcp/issues. 고객 영향 이슈는 일반적으로 24시간 내에 접수 확인되며 버전 대상을 지정하여 트리아지됩니다.

• 기여 — PR 환영. 플러그인 소스는 이 저장소와 wp.org SVN trunk 모두에 커밋되며, 릴리스는 wp.org 검토 프로세스를 통해 조정됩니다.

추가 자료

• Editing Elementor with Claude: The Four Workflows That Work Today — AI로 Elementor 페이지를 편집하는 네 가지 실제 아키텍처와 각각을 언제 사용해야 하는지. 프롬프트, 예제, clone-and-customize 흐름의 비디오 데모가 포함된 사용자용 버전.

• Editing Elementor with Claude: 4 MCP Architectures — Hashnode의 엔지니어용 버전. elementor_clone_page의 내부 PHP, 여섯 가지 도구 시그니처, HTTP-Basic-vs-OAuth-2.1 인증 모델의 트레이드오프.

관련 프로젝트

• GuardPress — WordPress 보안 강화

• SiteVault — WordPress 백업 및 마이그레이션

• ForgeCache — 캐싱 및 성능

• FormForge — PDF 생성 기능이 있는 폼 빌더

• SEObolt — WordPress용 SEO 툴킷

라이선스

GPLv2 이상 — LICENSE 또는 GNU 사이트 참조.

Royal MCP는 있는 그대로 제공됩니다. API key는 엔드포인트를 보호합니다. 다른 자격 증명처럼 안전하게 관리하세요. AI 플랫폼이 WordPress 사이트에서 수행하도록 허용하는 콘텐츠, 명령 및 작업에 대한 책임은 사용자에게 있습니다.