설정 진행률 체크리스트
관리자 메뉴 위치: Overview › Dashboard (
/), 상단의 Setup progress 카드. Plans, Customers, Zones, Payments, Infrastructure의 빈 목록에서도 동일한 도움말이 표시됩니다.
작동 내용
새로 설치된 시스템은 첫 고객이 주문하고 결제하기 전에 10가지 항목을 설정해야 합니다. Setup progress 카드는 실제 설정 상태를 기준으로 이를 확인하고, 완료된 개수를 표시하며, 다음 단계를 안내하고 해당 페이지로 연결해 줍니다. AI 소스가 연결되어 있는 경우 Do it for me는 해당 단계에 대한 질문이 준비된 AI assistant를 엽니다. 어시스턴트(및 MCP를 사용하는 모든 AI 클라이언트)는 setup_checklist 도구를 통해 동일한 목록을 읽을 수 있습니다.
10단계
| # | 단계 | 완료로 인정되는 조건 | 설정 위치 |
|---|---|---|---|
| 1 | 라이선스 활성화 | 도메인에 라이선스가 활성화됨 | System › Admin › License & updates (/license). License and purchase를 참고하세요. |
| 2 | 인프라 소스 연결 | CloudStack이 연결되었거나 하나 이상의 Proxmox VE 클러스터가 추가됨 | Infrastructure › Cloud provider › Providers (/infra/providers). CloudStack 및 Proxmox VE를 참고하세요. |
| 3 | Create a zone | 하나 이상의 존(Zone) 존재 | Infrastructure › Datacenter › Zone (/infra/zones). Zones를 참고하세요. |
| 4 | OS 템플릿 | 하나 이상의 템플릿이 활성화됨 | Services › Virtual Machines › Plans & pricing, Templates 탭 (/vm/catalog?tab=templates). OS templates를 참고하세요. |
| 5 | 플랜 생성 | 하나 이상의 플랜이 활성화됨 | Services › Virtual Machines › Plans & pricing (/vm/catalog). Plans and pricing를 참고하세요. |
| 6 | 결제 설정 | Stripe, PayPal, 암호화폐 또는 계좌 이체가 설정됨 | Finance › Payment channels (/payments). Payment channels을 참조하세요. |
| 7 | Email (SMTP) | 발신 이메일이 설정됨 | System › Settings › Email (/settings/email). SMTP and e-mail templates을 참조하세요. |
| 8 | 브랜딩 | 로고가 업로드되었거나 브랜드 이름이 기본값에서 변경됨 | System › Settings › Brand (/settings/branding). Branding을 참조하세요. |
| 9 | Terms & privacy | 하나 이상의 법적 텍스트가 입력됨 | System › Settings › Legal (/settings/legal). Legal pages을 참조하세요. |
| 10 | 테스트 주문 생성 | 하나 이상의 주문이 존재함 | 모든 기능이 정상 작동하는지 확인하기 위해 고객 포털에서 고객으로서 주문을 생성합니다. 카드는 Billing page (/billing)(으)로 연결됩니다. |
카드는 done/total(예: 6/10), 진행률 표시줄, Open이 있는 다음 단계 및 AI 소스가 연결된 경우 Do it for me를 표시합니다. 단계를 클릭하여 해당 페이지로 이동합니다. 단계 옆의 작은 링크는 해당 문서 페이지를 엽니다. 일부 단계에는 "2 zone(s)"와 같은 세부 정보도 표시됩니다.

사용 방법
- 개요를 엽니다. 카드는 상단에 위치합니다. 화살표를 사용하여 접을 수 있으며, 패널은 브라우저에서 선택한 설정을 기억합니다.
- Open을 클릭하여 다음 단계 페이지로 이동하거나 Do it for me를 클릭합니다.
- Do it for me를 사용하면 "40% 마진을 적용한 내 상품 기반 스타터 플랜 테이블을 제안하고, 생성하기 전에 미리보기를 보여줘."와 같은 요청과 함께 어시스턴트가 열립니다. 질문에 답한 다음 각 카드를 검토하고 Confirm합니다. AI Chat in the admin을 참조하세요.
- 모든 10단계를 완료하면 카드가 사라집니다.
Empty lists
Plans, Customers, Zones, Payments 또는 Infrastructure가 비어 있는 경우, 페이지에 설명, 작업 버튼 Next step, Do it for me 및 문서 링크가 포함된 블록이 표시되므로 빈 테이블을 보지 않게 됩니다.

원하는 언어로 요청
카드가 필요하지 않습니다. AI Chat 또는 연결된 AI 클라이언트에서 다음을 요청할 수 있습니다.
text
Check my setup progress and take me through the open steps, one at a time.이것은 MCP 프롬프트 initial-setup이기도 합니다. 어시스턴트는 setup_checklist을(를) 호출하고, 각 미완료 단계가 중요한 이유를 설명하며, 필요한 정보를 요청하고 일치하는 도구를 사용합니다. 필요한 스코프: 목록을 읽기 위한 admin:read 및 완료하려는 단계의 스코프. Example prompts을 참조하세요.
확인
- 단계를 완료한 후 개요가 다시 로드될 때 카드의 완료 수가 증가합니다.
- 어시스턴트에서
setup_checklist은(는) 완료된 단계에done: true을(를) 포함하여 동일한 숫자를 반환합니다.
한도 및 참고 사항
- 검사 항목은 작동 여부가 아니라 저장된 내용을 확인합니다. 설정된 게이트웨이는 테스트가 실패하더라도 완료된 것으로 간주됩니다. 각 페이지의 Test 버튼과 문제 해결을 위한
system_health도구를 사용하세요. - 이 카드는 관리자 전용입니다.
- Do it for me에는 System › Settings › AI accounts 아래에 연결된 AI 소스가 필요합니다. 연결된 소스가 없으면 Open만 표시됩니다.
- 10단계를 모든 설치에 동일하게 적용되며, 사용할 계획이 없는 단계(예: 프라이빗 클라우드의 결제)도 미완료 상태로 계산됩니다.
Troubleshooting
| 증상 | 원인 | 해결 방법 |
|---|---|---|
| 카드가 없음 | 모든 10단계를 완료했거나 카드를 로드할 수 없음 | 개요를 다시 로드하세요. 상태를 확인하려면 AI Chat에서 setup_checklist에 물어보세요. |
| 작업을 완료한 후에도 단계가 열려 있음 | 저장이 완료되지 않았거나 조건이 아직 충족되지 않았습니다 (예: 템플릿이 존재하지만 비활성화된 경우) | 해당 단계의 페이지를 열고 위의 표를 확인하세요. |
| 로고를 변경한 후에도 브랜딩 상태가 유지됨 | 로고가 존재하거나 브랜드 이름이 기본값인 "NexCMP"와 다른 경우 브랜딩으로 간주됨 | 로고를 업로드하거나 사용자 정의 이름을 설정하세요. |
| Do it for me가 작동하지 않음 | 연결된 AI 소스가 없거나 데모 패널인 경우 | AI 계정에서 소스를 연결하세요. |