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는 어떻게 만드나요?

  1. WordPress 관리자 → Users → Profile로 이동합니다.
  2. 스크롤을 내려 Application Passwords 섹션을 찾습니다.
  3. 이름(예: "WPControl")을 입력하고 Add New Application Password를 클릭합니다.
  4. 생성된 비밀번호를 복사합니다. 이 비밀번호는 다시 볼 수 없습니다.

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. 대시보드에 "사이트 한도 초과" 배너가 표시됩니다.
  2. 가장 먼저 등록한 1개 사이트만 활성 상태로 유지됩니다.
  3. 나머지 사이트는 비활성화되지만 데이터는 삭제되지 않습니다.
  4. 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 형식으로 내보낼 수 있습니다.