클로드와 워드프레스를 연결하는 방법은 클로드 데스크톱의 npx 프록시와 커스텀 커넥터 두 가지인데, 2026년 9월 기준으로 커넥터 방식은 동작하지 않습니다. 서버는 정상 응답하지만 워드프레스 MCP 플러그인이 2025-03-26 판 프로토콜에 멈춰 있어 규격이 맞지 않습니다. 저장소가 2026년 1월에 개발을 멈췄기 때문입니다. 데스크톱에서 npx 프록시를 쓰는 방식은 정상 동작합니다.
클로드에게 “이 글 워드프레스에 올려줘”라고 말하면 그대로 올라갑니다. 관리자 화면을 열 필요가 없어요.
연결하는 길이 두 가지인데 하나만 됩니다. 왜 하나만 되는지 끝까지 파봤습니다.
이 글은 2026년 9월 3일, 워드프레스 6.9.7과 MCP 플러그인 0.2.5, 클로드 데스크톱 환경에서 직접 확인한 내용입니다.
워드프레스 쪽 준비 — 플러그인과 토큰
어느 길로 가든 워드프레스에 MCP 플러그인이 있어야 합니다. 워드프레스 플러그인 저장소에는 없고 Automattic 의 GitHub 저장소에서 받습니다.
여기에 함정이 두 개 있습니다. 저는 둘 다 밟았습니다.
첫째, 초록색 Code 버튼이 아니라 Releases 탭
GitHub 첫 화면의 초록색 Code → Download ZIP 을 누르면 소스가 통째로 받아집니다. 개발용 파일까지 들어 있어서 워드프레스가 거부해요. 이런 오류가 납니다.
Plugin contains a top-level bin/ directoryReleases 탭으로 들어가 거기 있는 zip 을 받으셔야 합니다. 크기부터 다릅니다. 소스 통째는 566kB 였고 배포용은 179kB 였어요.
둘째, 클로드가 아니라 워드프레스
클로드에도 「플러그인 업로드」 화면이 있습니다. 이름이 똑같아서 거기에 올리기 쉬운데 완전히 다른 물건입니다. 잘못 올리면 이렇게 나옵니다.
claude.ai-hosted plugins may not ship bin/ executables올려야 할 곳은 내 사이트 관리자 화면입니다.
내도메인.com/wp-admin → 플러그인 → 새로 추가 → 플러그인 업로드받기 전에 알아 두실 것이 있습니다. 이 저장소는 2026년 1월 19일에 아카이브됐습니다. 개발이 멈췄다는 뜻이고, 보안 문제가 나와도 고쳐지지 않습니다. 이 플러그인은 사이트에 관리자급 권한을 여는 물건이라 그 점을 알고 쓰셔야 합니다. 제가 확인한 최신 판은 0.2.5입니다.
설치하면 설정 → MCP 메뉴가 생깁니다.
Delete Tools 는 꺼 두시길 권합니다. 클로드가 글을 지울 수 있게 되는 설정이에요. 만드는 것과 고치는 것만 열어도 충분합니다.
그다음 Authentication Tokens 탭에서 토큰을 만듭니다. 유효기간은 최대 24시간입니다.
여기서 두 가지를 조심하십시오.
- 토큰은 화면을 벗어나면 다시 못 봅니다. 바로 복사해 두세요
- 남에게 보이면 안 됩니다. 이 토큰 하나로 내 권한 그대로 글을 쓰고 고칠 수 있습니다. 저는 화면을 찍다가 토큰이 그대로 나온 적이 있어서 바로 무효화했습니다. 목록에서 Revoke 를 누르면 됩니다
플러그인이 직접 못 박아 둔 것도 있습니다. 이 토큰은 MCP 전용입니다. 워드프레스 REST API 나 다른 인증에는 통하지 않습니다.
지금 되는 방식 — npx 프록시
제가 쓰는 방식입니다. 클로드 데스크톱 설정 → 개발자 → 로컬 MCP 서버에서 구성 파일을 고칩니다.
구성 파일에는 이렇게 적습니다.
복사해서 쓰실 수 있게 옮겨 적습니다.
{
"mcpServers": {
"내사이트": {
"command": "npx",
"args": ["-y", "@automattic/mcp-wordpress-remote@latest"],
"env": {
"WP_API_URL": "https://내도메인.com/",
"JWT_TOKEN": "여기에_발급받은_토큰"
}
}
}
}내사이트 자리에는 알아보기 쉬운 이름을 아무거나 넣으시면 됩니다. 여러 곳을 다루신다면 같은 덩어리를 이름만 바꿔 늘리시면 돼요. 고친 뒤에는 클로드 데스크톱을 껐다 켜야 반영됩니다.
이 방식은 잘 됩니다. 저는 이대로 계속 쓰고 있어요.
커넥터로 해본 첫 시도 — OAuth 벽
그런데 이 방식이 좀 번거롭습니다. 구성 파일을 손으로 고쳐야 하고, 데스크톱 앱에서만 됩니다.
요즘 클로드에는 커스텀 커넥터가 있습니다. 주소만 넣으면 연결되는 방식이에요. 플러그인이 /wp-json/wp/v2/wpmcp/streamable 주소를 제공하니 이걸 넣으면 되겠다 싶었습니다.
여기서 첫 신호가 나왔습니다.
클로드는 OAuth 로그인 창을 찾으러 갔습니다. 그런데 워드프레스 플러그인에는 그런 게 없습니다. 토큰만 받거든요.
제가 직접 확인해 봤습니다. 클로드가 찾는 주소들이 전부 없었습니다.
/.well-known/oauth-protected-resource 404
/.well-known/oauth-authorization-server 404인증을 없음으로 바꾼 두 번째 시도
다행히 빠져나갈 길이 화면에 있습니다. 인증 항목에 「없음」이 있는데 설명이 이렇습니다.
로그인 없음. 개방형 액세스 서버나 OAuth 대신 API 키를 사용하는 서버에 선택하세요.
워드프레스 MCP 가 정확히 그 경우입니다. 「없음」을 고르고 요청 헤더에 토큰을 직접 넣었습니다.
화면에도 안내가 나옵니다. 값에 인증 방식을 포함하세요. 예: Bearer your-token. 설정은 완벽했습니다.
「서버 URL 을 확인하고 서버가 실행 중인지 확인하세요」라고 합니다. 그런데 서버는 멀쩡히 돌고 있었습니다.
서버를 직접 찔러본 결과
여기서 포기하지 않고 원인을 찾아봤습니다. 토큰을 하나 만들어서 서버에 MCP 요청을 직접 보내봤어요.
결과가 이랬습니다.
"protocolVersion": "2025-03-26"
"serverInfo": {"name": "WordPress MCP Server", "version": "0.2.5"}
"capabilities": tools, resources, prompts 전부 제공200 으로 정상 응답이 왔습니다. 도구도 리소스도 프롬프트도 전부 제공한다고 합니다. 서버는 아무 문제가 없었어요.
그러면서 두 가지 의심도 지웠습니다.
- 인증 문제가 아닙니다. 토큰을 넣으니 바로 통과했습니다
- 클라우드플레어 탓도 아닙니다. 파이썬 기본 요청만 막고, 브라우저나 노드처럼 보이는 요청은 전부 통과시켰습니다
진짜 원인 — 프로토콜 판 2025-03-26
서버 응답에서 걸리는 곳은 딱 한 줄이었습니다.
"protocolVersion": "2025-03-26"
1년 전 규격입니다. 클로드 커넥터는 더 최신 판을 기대합니다. 서버는 살아 있는데 말이 안 통하는 상태였어요.
왜 안 따라갔는지도 찾았습니다. 이 플러그인의 저장소가 2026년 1월 19일에 아카이브됐습니다. 개발이 멈춘 겁니다. 후속은 워드프레스 공식 저장소의 mcp-adapter 로 넘어갔고, 워드프레스 6.9 부터는 코어에 들어왔습니다.
제 사이트에서도 확인됩니다. 옛 플러그인 주소와 코어 주소가 나란히 열려 있습니다.
옛 플러그인 /wp-json/wp/v2/wpmcp
/wp-json/wp/v2/wpmcp/streamable
워드프레스 코어 /wp-json/mcp
/wp-json/wp-abilities/v1코어 쪽이 자리를 잡으면 커넥터로도 될 가능성이 있습니다. 다만 2026년 9월 지금은 아직입니다.
정리 — 데스크톱에서, npx 로
결론은 이렇습니다.
| 방식 | 되나 |
|---|---|
| 클로드 데스크톱 + npx 프록시 | 됩니다 |
| 커스텀 커넥터에 주소 입력 | 안 됩니다 |
| 모바일 클로드 앱 | 안 됩니다. 커넥터만 되는데 그게 안 되니까요 |
번거로워 보이던 npx 프록시가 군더더기가 아니었습니다. 규격 차이를 사이에서 통역해 주는 다리였어요. 그래서 그건 되고 커넥터는 안 되는 겁니다.
커넥터를 처음 다뤄 보신다면 클로드에 MCP 커넥터 연결하는 법에 기본 절차를 적어 두었습니다.
출처 — 공식 문서와 제 서버 응답
저장소 아카이브 사실과 전송 방식은 Automattic 과 워드프레스 공식 저장소에서 2026년 9월 3일에 확인했습니다. 프로토콜 판과 서버 정보, 주소별 응답 코드는 제 사이트에 직접 요청을 보내 받은 값입니다.
마지막으로 한 번 더 말씀드립니다. 토큰은 비밀번호와 같습니다. 화면을 찍어 올리실 때 가려지는지 꼭 보시고, 새어 나갔다 싶으면 목록에서 바로 무효화하십시오.
자주 묻는 질문
워드프레스 MCP 플러그인은 어디서 받나요?
워드프레스 플러그인 저장소에는 없고 Automattic 의 GitHub 저장소 Releases 탭에서 zip 을 내려받아 직접 업로드합니다. 초록색 Code 버튼으로 받으면 개발용 파일이 섞여 있어 설치가 거부되고, 클로드에도 같은 이름의 「플러그인 업로드」 화면이 있어 헷갈리기 쉬우니 반드시 내 사이트의 wp-admin 에서 올리셔야 합니다. 다만 이 저장소는 2026년 1월 19일에 아카이브되어 개발이 멈춘 상태입니다.
클로드 커스텀 커넥터로 워드프레스를 연결할 수 있나요?
2026년 9월 기준으로는 안 됩니다. 서버는 정상 응답하지만 플러그인이 2025-03-26 판 프로토콜에 멈춰 있어 클로드 커넥터와 규격이 맞지 않습니다. 클로드 데스크톱에서 npx 프록시를 쓰는 방식은 정상 동작합니다.
모바일 클로드 앱에서도 되나요?
안 됩니다. 모바일에서는 커넥터 방식만 쓸 수 있는데 그것이 동작하지 않기 때문입니다. 데스크톱 앱에서 구성 파일을 고쳐 쓰셔야 합니다.
커넥터가 연결되지 않을 때 인증 설정은 어떻게 하나요?
인증을 「없음」으로 고르고 요청 헤더에 authorization 이름으로 값을 넣습니다. 값은 Bearer 다음에 한 칸 띄우고 토큰을 적습니다. 다만 이렇게 해도 프로토콜 판이 맞지 않으면 연결되지 않습니다.
토큰이 노출되면 어떻게 하나요?
즉시 무효화하십시오. 워드프레스 관리자의 MCP 설정 Authentication Tokens 탭에서 해당 토큰의 Revoke 를 누르면 됩니다. 이 토큰 하나로 내 권한 그대로 글을 쓰고 고칠 수 있으므로 화면을 공유하실 때 특히 조심해야 합니다.
