wp-ssh MCP server
2026년 10월 27일 커밋SSH 접속 없이도 포스트, WooCommerce, Elementor를 포함한 셀프 호스팅 WordPress 사이트를 AI 에이전트가 관리할 수 있도록 지원합니다.
다른 이름 MSSOFTPC/wp-ssh-mcp
- 스타
- 0
- Tools
- —
- 다운로드, 30일
- —
- 최신 버전
- —
- 마지막 커밋
- 2026년 10월 27일
- 라이선스
- GPL-2.0
wp-ssh MCP란?
SSH 접속 없이도 포스트, WooCommerce, Elementor를 포함한 셀프 호스팅 WordPress 사이트를 AI 에이전트가 관리할 수 있도록 지원합니다.
프로젝트 README에서 생성된 요약
wp-ssh MCP server 정보
Claude Desktop, Cursor 또는 Claude Code와 같은 AI 클라이언트를 통해 SSH 접속 없이도 셀프 호스팅 WordPress 사이트를 관리할 수 있습니다. 이 로컬 MCP server는 AI 에이전트와 WordPress 사이트에 설치된 WP SSH 플러그인 사이를 연결하는 브리지 역할을 합니다. 사용자의 컴퓨터에서 직접 실행되므로 비밀 키가 호스팅된 릴레이로 전송되지 않고 로컬 머신에 안전하게 유지됩니다.
사용자는 모드를 read, write 또는 full로 설정하여 액세스 수준을 제어할 수 있습니다. 기본 read 모드에서 AI는 포스트 목록 조회, WooCommerce 주문 확인 또는 사이트 진단과 같은 작업을 수행할 수 있습니다. write 또는 full 모드로 전환하면 콘텐츠 생성, 미디어 업로드 및 플러그인 관리나 파일 쓰기와 같은 고급 작업을 수행할 수 있습니다. 이 서버는 사이트 엔드포인트와의 보안 통신을 위해 HTTPS와 비밀 키를 사용합니다.
활용 사례
- 1사이트 상태 점검 수행AI 에이전트에게 진단 도구를 실행하여 WordPress 웹사이트의 속도를 저하시키는 요인을 찾아달라고 요청하세요.
- 2WooCommerce 판매 데이터 관리최근 고객 주문 내역을 현재 상태별로 분류하여 요약해 달라고 요청하세요.
- 3사이트 간 Elementor 디자인 이전AI에게 특정 Elementor 페이지 디자인을 한 사이트에서 내보낸 후 다른 사이트의 초안으로 가져오도록 지시하세요.
- 4데이터베이스 검색 및 바꾸기 미리보기데이터베이스에 실제 변경 사항을 적용하기 전에 URL 교체가 어떻게 적용될지 AI를 통해 확인하세요.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
wp-ssh MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 wp-ssh MCP 설치
$ claude mcp add wp-ssh-mcp -- npx -y wp-ssh-mcpCursor에 wp-ssh MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"wp-ssh-mcp": {
"command": "npx",
"args": [
"-y",
"wp-ssh-mcp"
]
}
}
}VS Code에 wp-ssh MCP 설치
.vscode/mcp.json
{
"servers": {
"wp-ssh-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"wp-ssh-mcp"
]
}
}
}VS Code CLI에 wp-ssh MCP 설치
$ code --add-mcp '{"name":"wp-ssh-mcp","type":"stdio","command":"npx","args":["-y","wp-ssh-mcp"]}'Claude Desktop에 wp-ssh MCP 설치
claude_desktop_config.json
{
"mcpServers": {
"wp-ssh-mcp": {
"command": "npx",
"args": [
"-y",
"wp-ssh-mcp"
]
}
}
}Codex에 wp-ssh MCP 설치
$ codex mcp add wp-ssh-mcp -- npx -y wp-ssh-mcpCodex config.toml에 wp-ssh MCP 설치
~/.codex/config.toml
[mcp_servers.wp-ssh-mcp] command = "npx" args = ["-y", "wp-ssh-mcp"]
Gemini CLI에 wp-ssh MCP 설치
$ gemini mcp add -s user wp-ssh-mcp npx -- -y wp-ssh-mcpGemini settings.json에 wp-ssh MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"wp-ssh-mcp": {
"command": "npx",
"args": [
"-y",
"wp-ssh-mcp"
]
}
}
}구성
WPSSH_KEYWPSSH_MODEWPSSH_SITESWPSSH_URL
| 이름 | 설명 | 유형 |
|---|---|---|
| WPSSH_KEY | — | |
| WPSSH_MODE | — | |
| WPSSH_SITES | — | |
| WPSSH_URL | — |
자동 검사
2026년 11월 14일에 실행됨전체 보고서 →아직 인증되지 않았습니다. 서버는 80점 이상의 점수, 심각한 결함 없음, 그리고 검사에 충분한 데이터를 갖추어야 합니다. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능mssoftpc/wp-ssh-mcp is public and reachablegithub.com/mssoftpc/wp-ssh-mcp ↗통과
- 패키지가 이 저장소를 소스로 명시wp-ssh-mcp names mssoftpc/wp-ssh-mcp as sourcenpmjs.com/package/wp-ssh-mcp ↗통과
- 빌드 출처(Sigstore 증명)No build attestation published for this release검사되지 않음
- 오픈 소스 라이선스 (OSI)GPL-2.0spdx.org/licenses/GPL-2.0.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-10-27github.com/mssoftpc/wp-ssh-mcp ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음No popular package one edit away from wp-ssh-mcp통과
- 패키지 및 해당 종속성에 중요한 보안 권고 없음검사되지 않음
- 모델에 대한 숨겨진 지침 없음0 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 원격 엔드포인트가 MCP 핸드셰이크에 응답검사되지 않음
README
GitHub에서 보기wp-ssh-mcp: WordPress MCP server for the WP SSH plugin

Let Claude, Cursor, Claude Code and other MCP clients manage your self-hosted WordPress site (posts, WooCommerce, Elementor, diagnostics, files) without SSH access.
wp-ssh-mcp is a small program that runs on your own computer. It turns the WP SSH plugin's HTTPS endpoint into MCP tools, so your AI sees post_list, order_get, elementor_data_set and so on, with proper parameter schemas. No hosted relay, no accounts: your key stays on your machine.
This needs two pieces. The WordPress plugin does the real work on your site;
wp-ssh-mcponly connects your AI app to it.
Claude Desktop / Cursor / Claude Code
│ MCP (local, stdio)
▼
wp-ssh-mcp ← this repo, runs on your computer
│ HTTPS + X-WPSSH-Key
▼
your WordPress site ← WP SSH plugin (separate repo)
Quick start
Step 1: install the plugin on your WordPress site (once per site)
- Get it from MSSOFTPC/wp-ssh (Releases →
wp-ssh.zip). - WordPress admin: Plugins → Add New → Upload Plugin → Activate.
- Tools → WP SSH: tick Enable bridge, copy the Secret key.
Step 2: connect your AI app (see Install for Claude Desktop, Claude Code and Cursor)
claude mcp add my-site -e WPSSH_URL=https://yoursite.com -e WPSSH_KEY=your-key -- npx -y wp-ssh-mcp
Then ask: "Run diagnostics on my site."
Safe by default
The server starts in read mode. Write tools are not even shown to the AI until you opt in.
WPSSH_MODE |
What the AI can do | Action tools |
|---|---|---|
read (default) |
Look, never touch: site info, diagnostics, posts, orders, options, file reads, SELECT queries, dry-run search-replace, Elementor export | 21 |
write |
+ content changes: create/update posts, order status, Elementor data/import, product attributes, cache clear, media upload, menus | 34 |
full |
+ risky: file writes/restore, write SQL, permanent delete, real search-replace, plugin activate/deactivate | 41 |
More safety built in:
- Risky tools are marked destructive, so MCP clients show an approval prompt.
db_queryaccepts one read-only statement only. Writes need the separatedb_query_writetool (full mode).search_replace_previewalways sendsdry_run: true; the model cannot override it.confirm: trueis never added automatically. The model must pass it, and tool descriptions tell it to do so only after your approval.- The plugin's own protections still apply (Read-only mode, IP allowlist, lockout, auto-backups, activity log).
- Refuses plain
http://(except localhost), refuses to follow redirects (the key is never forwarded), and never prints your key.
Install
Requires Node.js 18+ and the WP SSH plugin active on your site (Tools → WP SSH → copy the secret key, tick Enable bridge).
Claude Desktop
Edit claude_desktop_config.json
(macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\):
{
"mcpServers": {
"my-site": {
"command": "npx",
"args": ["-y", "wp-ssh-mcp"],
"env": {
"WPSSH_URL": "https://yoursite.com",
"WPSSH_KEY": "your-64-char-secret-key",
"WPSSH_MODE": "read"
}
}
}
}
Restart Claude Desktop.
Claude Code
claude mcp add my-site -e WPSSH_URL=https://yoursite.com -e WPSSH_KEY=your-key -- npx -y wp-ssh-mcp
Cursor
~/.cursor/mcp.json (or project .cursor/mcp.json): same mcpServers block as above.
Several sites
"env": {
"WPSSH_SITES": "[{\"name\":\"shop\",\"url\":\"https://shop.com\",\"key\":\"...\"},{\"name\":\"blog\",\"url\":\"https://blog.com\",\"key\":\"...\"}]",
"WPSSH_MODE": "read"
}
Every tool then gets a required site parameter (shop or blog).
Run from source
git clone https://github.com/MSSOFTPC/wp-ssh-mcp
cd wp-ssh-mcp
npm install && npm run build
# then use "command": "node", "args": ["/full/path/to/wp-ssh-mcp/dist/index.js"]
Configuration
| Variable | Meaning |
|---|---|
WPSSH_URL, WPSSH_KEY |
One site. URL like https://example.com, key from Tools → WP SSH |
WPSSH_NAME |
Optional name for the single site (default default) |
WPSSH_SITES |
JSON array for several sites (see above) |
WPSSH_MODE |
read (default), write, full |
WPSSH_ALLOW_HTTP |
1 to allow http:// on a trusted private network |
WPSSH_TIMEOUT_MS |
Request timeout, default 30000 |
WPSSH_MAX_CHARS |
Max characters returned per call (default 60000). Big Elementor pages are truncated with a hint |
Example prompts
- "Run diagnostics on my site and tell me what is slowing it down."
- "List draft posts tagged ready and show me before publishing any."
- "Preview a search-replace from
http://old.comtohttps://new.com. Don't apply it." - "Export the Elementor design of page 120 from
shopand import it as a draft onblog." - "Show today's WooCommerce orders and summarise by status."
ChatGPT, n8n, Make, Zapier (no MCP needed)
This repo also ships OpenAPI 3.1 files generated from the same action list:
openapi.json: read + content-write actions (use this one)openapi.full.json: everything, including risky actions (only for agents you fully trust)
Custom GPT: Configure → Actions → Import the file → set the server URL to your site → Authentication: API Key, Custom, header name X-WPSSH-Key.
Note that ChatGPT calls your site from OpenAI's servers, so an IP allowlist is not practical there; keep the plugin in Read-only mode unless you are actively making changes.
Regenerate after changing src/spec.ts: npm run build && npm run gen:openapi.
Privacy
wp-ssh-mcp talks only to the site URLs you configure. No telemetry, no analytics, no third-party servers. What the AI sees is the output of the tools you allow, and it is handled under your AI provider's terms.
Troubleshooting
| Symptom | Fix |
|---|---|
| "wrong or missing secret key" | Re-copy the key from Tools → WP SSH (regenerating invalidates the old one) |
| 403 | Bridge disabled, Read-only mode on in the plugin, or your IP is not on the allowlist |
| 404 | Plugin inactive, or permalinks/REST API blocked by a security plugin or server rule |
| "redirect" error | Use the exact final URL (https vs http, www vs non-www) |
| Tools missing | You are in read mode; set WPSSH_MODE=write or full and restart the client |
| Nothing shows in Claude Desktop | Check JSON syntax, fully restart the app, run npx wp-ssh-mcp --help in a terminal |
Development
npm install
npm test # builds and runs the end-to-end smoke test against a mock endpoint
npm run gen:openapi
src/spec.ts is the single list of actions. Add an action there and both the MCP tool and the OpenAPI schema appear.
License
GPL-2.0-or-later, same as the plugin.
wp-ssh MCP 질문
wp-ssh MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add wp-ssh-mcp -- npx -y wp-ssh-mcp를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
wp-ssh MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
SSH 접속이 필요한가요?
아니요, WP SSH 플러그인의 HTTPS 엔드포인트를 사용하여 SSH 접속 없이도 AI 에이전트가 WordPress 사이트를 관리할 수 있습니다.