wpagent-mcp

Claude — 또는 MCP 호환 클라이언트 — 가 WordPress 사이트를 실제로 조작할 수 있게 해주는 MCP 서버입니다: 플러그인, 콘텐츠, 테마, 메뉴, 미디어, 사용자, WooCommerce, Elementor 및 WP-CLI.

무료 WpAgent 브리지 플러그인을 통해 REST API로 사이트와 통신하며, 모든 요청은 HMAC-SHA256으로 서명됩니다. 사이트 자격 증명이 사용되지 않으며, 어떤 데이터도 제3자 서비스를 거치지 않습니다. 연결은 클라이언트 → 사용자의 WordPress로 직접 이루어집니다.

설치

사전에 설치할 것은 없습니다. 아래 구성이 필요 시 자동으로 가져옵니다.

1. WordPress 사이트에 WpAgent 플러그인을 설치하고 활성화하세요.

2. WordPress 관리자에서 WpAgent를 열고 API 키를 생성하세요. 어시스턴트에 부여할 권한을 선택하세요. 읽기 전용 키로 시작하는 것이 안전합니다.

3. MCP 클라이언트에 서버를 추가하세요. Claude Desktop의 경우 claude_desktop_config.json에서:

{
  "mcpServers": {
    "wpagent": {
      "command": "npx",
      "args": ["-y", "wpagent-mcp"],
      "env": {
        "WP_SITE_URL": "https://your-site.com",
        "WP_API_KEY_ID": "wpaia_xxxxxxxxxxxx",
        "WP_API_SECRET": "the secret shown once when you generated the key"
      }
    }
  }
}

Claude Code의 경우:

claude mcp add wpagent \
  --env WP_SITE_URL=https://your-site.com \
  --env WP_API_KEY_ID=wpaia_xxxxxxxxxxxx \
  --env WP_API_SECRET=... \
  -- npx -y wpagent-mcp

환경 변수

Related MCP server: wp-mcp-control-server

할 수 있는 작업

할 수 없는 작업

API에는 임의의 PHP에 대한 경로, 데이터베이스에 대한 경로, wp-config.php에 대한 경로가 없습니다. WP-CLI 실행은 사이트 소유자가 서버에서 define('WPAIA_ENABLE_WPCLI', true);를 추가하지 않는 한 비활성화되며, 추가하더라도 허용 목록에 등록된 명령만 실행됩니다 — db, eval, eval-file, shell, server, config 및 package는 항상 거부됩니다.

안전

• 모든 요청은 HMAC-SHA256으로 서명되고 타임스탬프가 포함됩니다. 5분이 지난 요청은 거부됩니다.

• 권한은 키별로 부여되며 모든 라우트에서 확인되므로 읽기 전용 키는 읽기 전용으로 유지됩니다.

• 모든 호출은 WordPress 관리자에서 읽을 수 있는 감사 로그에 기록됩니다.

• WordPress에서 키를 해지하면 즉시 적용됩니다.

파괴적인 작업 전에는 어시스턴트에게 확인을 요청하고, 최신 백업을 유지하세요. 지시하면 콘텐츠를 삭제할 수 있기 때문입니다.

관련 자료

• WpAgent — 동일한 브리지로 구축된 호스팅 대시보드, 무료 읽기 전용 티어 제공

• 브리지 플러그인은 GPL-2.0-or-later이고, 이 서버는 MIT입니다.

라이선스

MIT © KipDev