클라우드웨이즈 API 키 만료 알림 공지 메일 - 'Your Cloudways API key stops working Oct 15'

클라우드웨이즈(Cloudways)를 사용자들은 2026년 10월 15일에 클라우드웨이즈 API 키가 작동을 멈춘다는 내용의 안내 메일("Reminder: Your Cloudways API key stops working Oct 15" 제목)을 받았을 것입니다. 이 이메일과 관련해서 일부 사용자들이 어떤 조치를 취해야 하는지에 대해 여러 채널을 통해 질문을 해왔습니다. 그냥 서버를 생성하고 워드프레스를 추가하여 이용하는 대부분의 사용자에게는 해당 사항이 없습니다.

📍 클라우드웨이즈 할인 프로모 코드 & 가입 방법 (+60% 쿠폰)

API 키/액세스 토큰이 뭔가요?

사람이 로그인 화면에 아이디와 비밀번호를 입력하는 대신, 외부 프로그램이나 자동화 스크립트가 "이 계정을 대신 조작해도 좋다"는 것을 증명하기 위해 사용하는 일종의 디지털 열쇠입니다. 즉, 사람이 직접 로그인해서 쓰는 게 아니라, 프로그램끼리 연결할 때 필요한 것입니다.

조금 쉽게 이해할 수 있도록 비유하자면, 웹사이트 로그인이 "내가 직접 문을 열고 들어가는 것"이라면, API 키는 "내가 없을 때 대신 심부름을 보낸 로봇에게 쥐여주는 열쇠"라고 생각하시면 됩니다. 즉, 사람이 직접 문 앞에서 비밀번호를 대는 게 아니라, 심부름꾼(프로그램)이 "저는 주인이 보내서 왔어요"라고 증명할 때 쓰는 열쇠인 셈입니다.

이번 클라우드웨이즈 공지의 핵심 내용

아마 아래와 같은 알림 메일을 우리나라 시각으로 2026년 9월 21일경에 받았을 것입니다.

이 메일에 앞서 8월 11일경에 아래와 같은 비슷한 공지 메일도 받았을 것입니다.

클라우드웨이즈가 보낸 메일의 요지는 이렇습니다.

1. 기존의 "API 키" 방식은 10월 15일부로 더 이상 작동하지 않습니다.
2. 대신 "액세스 토큰(Access Token)" 방식으로 교체해야 합니다.
3. 이 조치를 하지 않으면, Cloudways API나 MCP(Model Context Protocol)를 통해 연결해둔 자동화 워크플로우나 AI 에이전트 연동이 끊깁니다.
4. 교체 방법은 클라우드웨이즈 계정 → 프로필 메뉴의 "API Integration" → 새 액세스 토큰 발급(권한 범위 선택 가능) → 사용 중인 도구에 새 토큰 반영, 순서로 약 2분이면 완료됩니다.

여기서 핵심은 "API로 연결해둔 자동화 워크플로우나 연동"이라는 부분입니다.

액세스 토큰의 권한 범위 설정

액세스 토큰을 발급받을 때는 용도에 맞는 권한 범위를 선택할 수 있습니다. 기존 API 키는 예외 없이 계정 전체에 대한 전권을 부여했지만, 액세스 토큰은 이를 세 단계로 나눠서 필요한 만큼만 권한을 부여할 수 있게 되었습니다.

조회만 가능하고 변경은 할 수 없는 "Read-Only(읽기 전용)", 선택한 특정 엔드포인트 그룹에만 접근할 수 있는 "Limited Access(제한된 접근)", 그리고 기존 API 키와 동일하게 전체를 제어할 수 있는 "Full Access(전체 접근)" 중에서 고를 수 있습니다.

예를 들어, 단순히 서버 상태나 정보를 조회하는 용도라면 Read-Only만으로 충분하고, 특정 자동화 작업(예: 백업 트리거, 앱 재시작 등)에만 사용한다면 Limited Access로 필요한 기능만 선택하는 것이 안전합니다. 서버 생성·삭제처럼 계정 전반을 제어해야 하는 경우가 아니라면 굳이 Full Access를 선택할 필요는 없으며, 보안을 위해서는 꼭 필요한 최소한의 권한만 부여하는 것이 좋습니다.

무시해도 될까?

클라우드웨이즈 웹사이트에 직접 로그인해서 서버를 생성하고, 애플리케이션(워드프레스)을 설치해서 사이트를 운영하고 계신 분이라면 이 공지는 해당 사항이 없습니다.

API 키는 사람이 아니라 프로그램이 계정에 접근할 때만 필요한 것이기 때문에, 별도의 외부 자동화 도구·스크립트·AI 에이전트(예: Zapier, n8n, 직접 만든 스크립트, MCP 클라이언트 등)를 클라우드웨이즈 API에 연결해서 쓴 적이 없다면, 애초에 발급받아 사용 중인 API 키 자체가 없는 셈입니다. 없는 열쇠를 새로 바꿀 이유도 없으니, 이번 만료·교체 공지는 그대로 무시하셔도 됩니다.

정리

프로그램을 통해 클라우드웨이즈 API를 별도로 연결해 사용하는 경우가 아니라면 이번 공지는 신경 쓰지 않으셔도 됩니다. 대부분의 사용자는 이 공지와 무관하니, 안심하고 그냥 무시하면 됩니다.

다만, 혹시 예전에 어떤 자동화 도구나 스크립트에 클라우드웨이즈 API 키를 등록해 두신 기억이 있으시다면, 그 경우에만 클라우드웨이즈 프로필 메뉴의 "API Integration"에서 새 액세스 토큰을 발급받아 교체해주시면 됩니다. 팀 단위로 클라우드웨이즈 계정을 관리하고 계신다면, 다른 팀원이 만들어 둔 연동이 남아있지 않은지 한 번쯤 확인해보시는 것도 좋겠습니다.

API 통합 페이지에서 액세스 토큰을 생성할 수 있습니다. 클라우드웨이즈 운영 전반을 프로그래밍 방식으로 제어할 수 있습니다. API 엔드포인트를 활용하면 서버 배포 자동화, 애플리케이션 관리, 운영 확장까지 직접 코드베이스에서 처리하는 것이 가능합니다.

이 페이지에서 토큰을 관리하실 수 있습니다. 액세스 토큰은 외부에 노출되지 않도록 안전하게 보관하시기 바랍니다. 유출되면 클라우드웨이즈 리소스에 대한 무단 접근할 수 있으므로 주의가 필요합니다. 토큰 시크릿(secret)은 재발급이 불가능하므로, 분실하는 경우 기존 토큰을 폐기(revoke)하고 새로 발급받아야 합니다.

개발자가 아닌 일반 사용자라면 토큰 액세스를 생성해야 하는 경우는 거의 없을 것입니다.

Q&A (질문과 답변)

Q1. 그냥 워드프레스 홈페이지만 운영 중인데, 이 알림 메일을 무시했다가 사이트가 갑자기 멈추는 건 아닌가요?

A. 아닙니다. 이 알림 메일은 클라우드웨이즈 API로 서버/애플리케이션을 프로그램으로 제어하는 연동에만 해당되는 내용입니다. 대시보드에 직접 로그인해서 서버를 생성하고 워드프레스를 운영하는 방식에는 영향을 주지 않으므로, 사이트 운영이나 접속에는 아무런 문제가 없습니다.

Q2. 제가 API 키를 발급받은 적이 있는지 없는지도 모르겠어요. 어떻게 확인하나요?

A. 클라우드웨이즈 계정에 로그인 후 우측 상단 프로필 메뉴에서 "API Integration" 항목으로 들어가면 현재 발급된 API 키나 액세스 토큰 목록을 확인할 수 있습니다. 목록이 비어 있거나 아무것도 만든 기억이 없다면, 이번 공지와는 무관하다고 보시면 됩니다.

Q3. MCP(Model Context Protocol)가 뭔지 잘 모르는데, 저도 관련이 있을까요?

A. MCP는 AI 에이전트(예: 챗GPT, Claude 같은 AI 도구)가 클라우드웨이즈 계정에 접속해 서버 상태를 조회하거나 관리 작업을 수행할 수 있도록 연결해주는 기술입니다. AI 도구나 챗봇을 클라우드웨이즈와 연동해서 써본 적이 없다면 해당 사항이 없습니다.

Q4. API 키를 발급받은 적이 있는데, 지금 당장 교체해야 하나요?

A. 네, 실제로 API 연동을 사용 중이시라면 10월 15일 이전에 교체하시는 것이 안전합니다. 이 날짜가 지나면 기존 API 키가 거부되면서 연동된 자동화 워크플로우나 AI 에이전트 연결이 즉시 끊길 수 있으므로, 미리 여유를 두고 교체하는 것이 좋습니다.

Q5. 액세스 토큰의 권한 범위(Read-Only, Limited, Full Access)는 어떤 걸 선택해야 하나요?

A. 용도에 따라 다릅니다. 단순히 서버 상태나 정보를 조회만 하는 용도라면 Read-Only(읽기 전용)로 충분하고, 특정 기능만 자동화하려면 Limited Access(제한된 접근)로 필요한 엔드포인트만 선택하는 것이 안전합니다. 서버 생성·삭제 등 전체 제어가 필요한 경우에만 Full Access를 선택하시되, 보안을 위해 꼭 필요한 범위만 부여하는 것이 좋습니다.

• Read-Only Scope: 조회만 가능, 변경 불가 → "조회만 하는 용도라면 Read-Only로 충분" 
• Limited Access Scope: 선택한 특정 엔드포인트 그룹만 사용 가능 → "특정 기능만 자동화하려면 Limited Access로 필요한 엔드포인트만 선택" 
• Full Access Scope: 기존 키와 동일한 전체 제어 권한 → "전체 제어가 필요한 경우에만 Full Access" 

Q6. 토큰 시크릿을 분실했어요. 어떻게 해야 하나요?

A. 토큰 시크릿은 재발급이 불가능하므로, 분실했거나 어디에 적어뒀는지 기억나지 않는다면 해당 토큰을 폐기(Revoke)하고 새 토큰을 발급받아야 합니다. 새로 발급받은 토큰은 안전한 곳에 보관하고, 기존에 연동해둔 도구나 스크립트에도 새 토큰 값으로 업데이트해야 정상적으로 작동합니다.

참고

https://avada.tistory.com/3998

클라우드웨이즈 서버 크기를 줄이는 방법 (요금제 낮추기)

https://avada.tistory.com/3948

카페24의 10G 호스팅 상품 워드프레스 PHP 버전 업그레이드 작업