sitepilot-mcp

sitepilot-mcp는 SitePilot MCP 플러그인을 실행하는 WordPress 사이트의 로컬 전송(transport) 및 자격 증명 어댑터입니다. WordPress는 여전히 정책 시행 지점이며, 이 패키지는 사이트의 실시간 tools/list 및 tools/call API 표면을 전달하고 독립적인 도구나 안전 정책을 등록하지 않습니다.

빠른 시작

Node.js 22 이상과 SitePilot MCP 0.4.6 이상을 갖춘 HTTPS WordPress 사이트가 필요합니다.

npx sitepilot-mcp login --url https://wordpress.example --scopes site:read
npx sitepilot-mcp init --client cursor --profile wordpress-example

init 후 클라이언트를 다시 시작하세요. Application Password 로그인이 기본값이며, PKCE를 사용하는 OAuth 2.1을 이용하려면 --oauth를 추가하세요. 저장된 시크릿은 ~/.config/sitepilot/profiles.json에 있으며, OS가 지원하는 경우 모드 0600으로 기록되고, 생성된 클라이언트 구성에는 복사되지 않고 참조됩니다.

저장된 프로필 없이 바로 실행하기:

npx sitepilot-mcp --url https://wordpress.example --user alice --app-pass xxxx-xxxx-xxxx-xxxx
npx sitepilot-mcp --url https://wordpress.example --token opaque-token
npx sitepilot-mcp --profile wordpress-example --transport http --port 8770

HTTP 전송은 루프백에 바인딩되어 /mcp를 제공합니다. 원격 MCP와 OAuth 검색을 지원하는 클라이언트는 이 패키지 없이 https://wordpress.example/wp-json/sitepilot-mcp/v2/mcp에 직접 연결할 수 있습니다.

Related MCP server: WordPress MCP Proxy

명령어

sitepilot-mcp login --url <url> [--oauth] [--scopes a,b] [--label text]
sitepilot-mcp logout --profile <name>
sitepilot-mcp init --client cursor|claude-desktop|claude-code|windsurf|all --profile <name>
sitepilot-mcp doctor --url <url>
sitepilot-mcp tools --url <url> [--json]
sitepilot-mcp call <tool> --input @plan.json [--dry-run]

공통 플래그: --profile, --api-version v1|v2, --timeout, --read-only, --allow-tier 0|1|2|3, --version.

--read-only 및 --allow-tier는 원하지 않는 시도를 피하기 위한 로컬 편의 옵션입니다. 보안 경계가 아닙니다. WordPress 권한, 제한된 자격 증명 범위, 위험 분류, 승인, 낙관적 동시성, 감사 및 롤백은 여전히 플러그인이 최종 결정권을 가집니다.

execute-change 또는 rollback-change를 전달하기 전에 클라이언트는 로컬 --allow-tier 설정을 적용할 수 있도록 get-change-status 호출을 한 번 더 수행합니다. 요청된 변경(mutation)과 그 인자는 그 외에는 변경되지 않은 채 전달되며, 최종 결정은 WordPress가 내립니다.

sitepilot-mcp doctor를 실행하면 안전하지 않은 HTTP, 도달할 수 없는 REST API, 누락되었거나 비활성화된 플러그인, 제거된 Authorization 헤더, 유효하지 않거나 취소된 자격 증명, 불충분한 범위를 판별할 수 있습니다.

라이선스

Apache-2.0. WordPress 플러그인은 별도로 AGPL-3.0-or-later에 따라 라이선스가 부여됩니다.