wp-mcp
wp-mcp
![]()
Claude Code를 완전한 WordPress 운영 도구로 바꿔 주는 MCP 서버 — 콘텐츠, 미디어, 플러그인, 테마, 그리고 직접 테마 파일 편집까지 — SSH/WP-CLI가 없는 공유 호스팅을 포함한 모든 사이트에서 작동합니다.
작동 방식
두 부분으로 나뉩니다:
bridge/wp-mcp-connector.zip— 사이트당 한 번 업로드하면 되는 작은 WordPress 플러그인입니다. 토큰 기반 연결,wp-content로 범위가 제한된 파일 엔드포인트, 플러그인/테마 설치 프로그램, 그리고 손상된 PHP 편집으로 사이트가 다운된 경우에도 백업을 복원할 수 있는 독립형rescue.php를 제공합니다.server.mjs— Claude Code에 등록되는 MCP 서버입니다. 플러그인 및 WordPress 핵심 REST API와 통신합니다.
연결 수명 주기 (전체 보안 모델)
사이트에
wp-mcp-connector.zip을 업로드하고(플러그인 → 새로 추가 → 업로드) 활성화합니다.wp-admin → 설정 → WP MCP → 토큰 생성 (만료 기간 선택: 1시간 / 8시간 / 24시간 / 7일). 토큰은 한 번만 표시됩니다. 새 토큰은 이전 토큰을 대체합니다.
Claude에게
connect to https://example.com with token wpmcp_xxx, call it "clientx"라고 말합니다.작업: 테마 파일 편집, 플러그인 설치, 게시글 작성 등 무엇이든 합니다.
disconnect from clientx라고 말합니다 — 토큰은 사이트에서 폐기되고 로컬에서도 잊혀집니다.다음 세션: 새 토큰을 생성하고 다시 연결합니다.
어디에도 상시 저장된 자격 증명은 없습니다. sites.json(gitignore 처리됨, chmod 600)에는 현재 연결된 사이트만 보관됩니다.
Related MCP server: AutoWP MCP Server
설정 (이 Mac에서 한 번만)
cd ~/mcp/wp-mcp && npm install
claude mcp add --scope user wordpress -- node ~/mcp/wp-mcp/server.mjs도구
도구 | 기능 |
| 연결 수명 주기 |
| 게시글, 페이지, 모든 커스텀 포스트 타입 |
| 로컬 파일 → 미디어 라이브러리 |
| 목록 / 설치 (wp.org slug 또는 zip URL) / 활성화 / 비활성화 / 업데이트 / 삭제 |
| 목록 / 설치 / 활성화 / 삭제 |
|
|
| 자동 |
| 변경 후 알려진 페이지 캐시를 비웁니다 (Jetpack Boost, WP Super Cache / W3TC, LiteSpeed) |
| 원시 REST 탈출구 ( |
안전 참고 사항
기존 파일을 덮어쓰는 모든
wp_file_write는 먼저<file>.wpmcp-bak를 저장합니다.functions.php편집으로 사이트가 하얀 화면이 되어도wp_file_restore는 계속 작동합니다.rescue.php는 WordPress를 전혀 로드하지 않고 실행되기 때문입니다.파일 접근은
wp-content로 제한됩니다. 전체 WP 루트(예:wp-config.php편집)를 허용하려면define('WPMCP_ALLOW_FULL', true);를 wp-config.php에 추가하세요.HTTPS 사이트만 사용하세요 — 토큰이 헤더로 전송됩니다.
일부 공유 호스트는
Authorization헤더를 제거합니다. 서버는 또한X-WPMCP-Token을 보내며, 이는 테스트된 모든 환경에서 정상 전달됩니다.멀티사이트에서는 플러그인/테마 설치에 최고 관리자(super-admin)의 토큰이 필요합니다.
wp_content_create/wp_content_update에 전달된 HTML은 기본적으로 raw-HTML 블록으로 감싸지므로 WordPress의 autop 필터가 구조화된 마크업을 재구성할 수 없습니다 (autop_safe: false를 전달하면 이 동작을 해제할 수 있습니다).모든 요청은 브라우저와 유사한 User-Agent를 보냅니다. 일부 공유 호스트 WAF는 브라우저가 아닌 에이전트를 이유가 불분명한 403으로 거부합니다.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
This server cannot be deployed
Maintenance
Related MCP Connectors
Manage WordPress blogs and WooCommerce shops from Claude, ChatGPT, Cursor and other MCP apps.
Run every WordPress site you look after from Claude or ChatGPT. Nothing goes live until you approve it, every change gets a receipt you can undo, and the whole fleet sits in one tamper-evident log.
Hosted WordPress MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Run all of WordPress from Claude, ChatGPT or Cursor: SEO, security, your WooCommerce shop and Elementor pages, on up to 10 websites in one connector. Start free. SEO: titles, descriptions and focus keywords for every page, post and product. Security & updates: core, plugin and theme updates with a live test, site health and HTTPS checks, users and roles. WooCommerce shop: products, prices, orders, coupons and customers. Elementor and many more page builders: texts, links and images. Blog posts, pages, media, comments and menus. 10 websites in one connector: all your sites in the same chat. Deploy (Agency): build a site locally and push it to your own server. Just say it: "Write SEO titles for every product." "Install all updates and check that the site still works." "Show today's orders and create a weekend coupon." You choose what your AI may change, with one switch. Install the free AlphaBridge MCP plugin from WordPress.org, connect and approve on your own site. No account, no key to copy.
Related MCP Servers
- AlicenseCqualityAmaintenanceEnables comprehensive WordPress site management through natural language in Claude Desktop, supporting multiple sites with 59 tools for content creation, media management, user administration, and performance monitoring.711,772 npm114MIT
- AlicenseBqualityCmaintenanceConnects Claude to WordPress sites through the REST API, enabling AI-assisted content creation, publishing, media management, user administration, and site maintenance tasks through natural language.4717 npm23MIT
- AlicenseCqualityDmaintenanceEnables Claude Code to read, edit, and manage WordPress pages, posts, shortcodes, and media via the WordPress REST API.8011 npm3MIT
- AlicenseNot gradedqualityCmaintenanceEnables Claude Code to directly manage WordPress sites via natural language, including posts, pages, categories, tags, media, and multiple site support.MIT