Documentation

Everything you need to get started with WPControl.

Getting Started

WPControl is an MCP (Model Context Protocol) server that lets you manage your WordPress sites through AI assistants like Claude, ChatGPT, Cursor, Windsurf, and any MCP-compatible client. With 130+ tools covering content, SEO, WooCommerce, plugins, themes, and more — you can control your entire WordPress stack through natural language.

Quick Setup

Create an account and get your API key

Connect your WordPress site

In the dashboard, click "Add Site" and enter your WordPress site URL along with an Application Password. WPControl will connect to your site's REST API securely.

To create a WordPress Application Password, go to your WordPress admin → Users → Profile → Application Passwords. Enter any name (e.g. "WPControl") and click "Add New Application Password".

Connect your AI client

Add WPControl as an MCP server in your preferred AI client using the platform-specific instructions below.

AI Platform Setup

아래 예시의 wpmcp_your_api_key 부분을 대시보드에서 복사한 전체 API 키로 교체하세요. 키는 반드시 전체를 붙여넣어야 합니다 (중간이 ...으로 생략된 키는 동작하지 않습니다).

Claude Code Claude Desktop Cursor Windsurf ChatGPT

🖥️

Claude Code (CLI)

프로젝트 루트에 .mcp.json 파일을 생성하세요. Claude Code는 url과 headers를 네이티브로 지원합니다.

.mcp.json

{
  "mcpServers": {
    "wpcontrol": {
      "type": "url",
      "url": "https://api.wpcontrol.dev/mcp",
      "headers": {
        "Authorization": "Bearer wpmcp_your_api_key"
      }
    }
  }
}

/mcp 엔드포인트(Streamable HTTP)를 사용하세요. SSE(/sse) 방식도 지원되지만, Streamable HTTP가 더 안정적이고 권장됩니다.

설정 후 Claude Code를 재시작하면 자동으로 WPControl MCP 서버에 연결됩니다. "내 워드프레스 글 목록 보여줘"와 같이 자연어로 요청할 수 있습니다.

💬

Claude Desktop

Claude Desktop은 원격 MCP 서버 연결 시 OAuth 인증을 사용합니다. WPControl은 OAuth를 지원하므로, 아래 방법으로 간편하게 연결할 수 있습니다.

방법 1: 원격 MCP (권장)

Claude Desktop → Settings → Developer → Edit Config를 클릭하여 claude_desktop_config.json을 열고 다음을 추가하세요.

claude_desktop_config.json

{
  "mcpServers": {
    "wpcontrol": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://api.wpcontrol.dev/sse",
        "--header",
        "Authorization: Bearer wpmcp_your_api_key"
      ]
    }
  }
}

Claude Desktop에서 "url" 속성을 직접 사용하면 앱이 크래시할 수 있습니다. 반드시 mcp-remote 프록시를 사용하세요.

방법 2: Connector UI (mcp-remote 없이)

Claude Desktop → Settings → Connectors → Add Connector에 아래 URL을 입력합니다. 이 방식은 OAuth 플로우를 거칩니다.

https://api.wpcontrol.dev/sse

설정 후 Claude Desktop을 재시작하세요. MCP 서버 목록에 WPControl이 표시됩니다.

⚡

Cursor

Cursor는 v0.48.0부터 원격 MCP 서버의 headers를 네이티브로 지원합니다. 두 가지 방법으로 설정할 수 있습니다.

방법 1: 설정 UI (권장)

Cursor Settings → MCP → Add new MCP server에서 Type을 sse로 선택하고 URL을 입력하세요.

URL: https://api.wpcontrol.dev/sse

방법 2: 설정 파일 직접 편집

프로젝트 루트에 .cursor/mcp.json을 생성하거나, 전역 설정인 ~/.cursor/mcp.json을 편집하세요.

.cursor/mcp.json

{
  "mcpServers": {
    "wpcontrol": {
      "url": "https://api.wpcontrol.dev/sse",
      "headers": {
        "Authorization": "Bearer wpmcp_your_api_key"
      }
    }
  }
}

Cursor는 SSE(/sse) 엔드포인트를 사용합니다. 설정 후 Cursor를 재시작하거나, MCP 서버 옆의 새로고침 버튼을 클릭하세요.

🏄

Windsurf

Windsurf(Codeium)는 MCP 설정 파일의 키 이름이 다른 클라이언트와 다릅니다.url 대신 serverUrl을 사용해야 합니다.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "wpcontrol": {
      "serverUrl": "https://api.wpcontrol.dev/sse",
      "headers": {
        "Authorization": "Bearer wpmcp_your_api_key"
      }
    }
  }
}

반드시 serverUrl을 사용하세요. url을 사용하면 연결이 되지 않습니다.

🤖

ChatGPT

ChatGPT는 2025년부터 MCP 서버 연결을 지원하며, OAuth 인증만 지원합니다 (Bearer 토큰 직접 입력 불가).

ChatGPT 웹 → Settings → Apps → Developer Mode를 활성화합니다.
Settings → Connected apps → Add를 클릭합니다.
MCP 서버 URL을 입력합니다: https://api.wpcontrol.dev/sse
OAuth 인증 플로우를 따라 WPControl 계정을 연결합니다.

ChatGPT는 설정 파일이 아닌 웹 UI에서만 MCP 서버를 추가할 수 있습니다.

Tool Reference →Changelog Back to Home