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와 통신합니다.

연결 수명 주기 (전체 보안 모델)

1. 사이트에 wp-mcp-connector.zip을 업로드하고(플러그인 → 새로 추가 → 업로드) 활성화합니다.

2. wp-admin → 설정 → WP MCP → 토큰 생성 (만료 기간 선택: 1시간 / 8시간 / 24시간 / 7일). 토큰은 한 번만 표시됩니다. 새 토큰은 이전 토큰을 대체합니다.

3. Claude에게 connect to https://example.com with token wpmcp_xxx, call it "clientx"라고 말합니다.

4. 작업: 테마 파일 편집, 플러그인 설치, 게시글 작성 등 무엇이든 합니다.

5. disconnect from clientx라고 말합니다 — 토큰은 사이트에서 폐기되고 로컬에서도 잊혀집니다.

6. 다음 세션: 새 토큰을 생성하고 다시 연결합니다.

어디에도 상시 저장된 자격 증명은 없습니다. 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_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으로 거부합니다.