FAQ
자주 묻는 질문들에 대한 답변입니다.
연결 & 설정
API 키를 어디서 찾나요?
대시보드 → API Keys 메뉴에서 확인할 수 있습니다. 키를 분실한 경우 새 키를 발급하고 기존 키를 비활성화하세요.
'Failed to connect' 오류가 납니다.
- API 키가 올바른지 확인하세요.
wpmcp_로 시작하는 전체 키를 입력해야 합니다. - Windsurf는
serverUrl을 사용하세요 (url아님). - 방화벽이나 VPN이 HTTPS 연결을 차단하고 있지 않은지 확인하세요.
- AI 클라이언트를 완전히 종료 후 재시작해 보세요.
도구가 목록에 나타나지 않아요.
- AI 클라이언트를 재시작한 후 다시 확인하세요.
- WooCommerce, Rank Math 등 플러그인 전용 도구는 해당 플러그인이 설치된 사이트에서만 표시됩니다.
- 대시보드 → Settings → Tool Permissions에서 해당 도구 그룹이 활성화되어 있는지 확인하세요.
Claude Desktop에서 연결이 안 돼요.
Claude Desktop은 url 속성을 직접 지원하지 않습니다. 반드시 mcp-remote 프록시를 사용하거나, Connectors UI에서 OAuth 플로우로 연결하세요.
!
Claude Desktop 설정 파일에
url을 직접 사용하면 앱이 크래시됩니다.WordPress 연결
WordPress Application Password는 어떻게 만드나요?
- WordPress 관리자 → Users → Profile로 이동합니다.
- 스크롤을 내려 Application Passwords 섹션을 찾습니다.
- 이름(예: "WPControl")을 입력하고 Add New Application Password를 클릭합니다.
- 생성된 비밀번호를 복사합니다. 이 비밀번호는 다시 볼 수 없습니다.
WordPress 연결이 실패해요.
- Application Password가 올바른지 확인하세요 (공백 포함 형태:
XXXX XXXX XXXX XXXX XXXX XXXX). - Wordfence, iThemes Security 등 보안 플러그인이 Application Password 인증을 차단하고 있을 수 있습니다. 해당 플러그인의 설정에서 Application Password를 허용하세요.
- 사이트의 REST API가 활성화되어 있는지 확인하세요.
/wp-json/wp/v2/에 접속이 되어야 합니다. - 관리자 계정을 사용하고 있는지 확인하세요.
여러 사이트를 추가할 수 있나요?
플랜에 따라 다릅니다:
- Free: 1개 사이트
- Pro: 최대 10개 사이트
- Agency: 무제한 사이트
멀티사이트 환경에서는 AI 클라이언트에서 "site_name 사이트에서 글 목록 보여줘"와 같이 사이트 이름을 명시하면 됩니다.
플랜 & 결제
월간 쿼터가 언제 리셋되나요?
매월 1일 UTC 00:00에 리셋됩니다. KST 기준으로는 매월 1일 오전 9:00입니다.
Pro에서 Free로 다운그레이드하면 어떻게 되나요?
- 대시보드에 "사이트 한도 초과" 배너가 표시됩니다.
- 가장 먼저 등록한 1개 사이트만 활성 상태로 유지됩니다.
- 나머지 사이트는 비활성화되지만 데이터는 삭제되지 않습니다.
- Pro로 다시 업그레이드하면 모든 사이트가 즉시 복구됩니다.
API 키는 몇 개까지 만들 수 있나요?
- Free: 최대 2개
- Pro: 최대 10개
- Agency: 최대 50개
쿼터를 초과하면 어떻게 되나요?
월간 도구 호출 한도에 도달하면 MCP 도구 호출이 429 Too Many Requests로 거부됩니다. 대시보드에서 현재 사용량을 확인하고 플랜을 업그레이드할 수 있습니다.
보안
WordPress 비밀번호가 안전하게 저장되나요?
네. WordPress Application Password는 AES-256-GCM으로 암호화되어 저장됩니다. WPControl 서버도 복호화된 비밀번호를 로그에 기록하지 않습니다.
API 키를 분실했어요.
대시보드 → API Keys에서 기존 키를 비활성화하고 새 키를 발급하세요. 새 키를 AI 클라이언트 설정에 업데이트하면 즉시 연결됩니다.
내 데이터를 내보낼 수 있나요?
대시보드 → Account → Export Data에서 계정에 저장된 모든 데이터를 JSON 형식으로 내보낼 수 있습니다.