AI로 설정하기
관리자 메뉴 위치: AI Chat(
/agent) 및 System › Settings › API & AI agents(/agent/keys). 이 페이지의 모든 항목은 관리자 전용입니다.
작동 내용
NexCMP 1.4.0부터 AI 어시스턴트에 패널 설정을 요청할 수 있습니다. Proxmox VE 또는 CloudStack 연결, 존 생성, 비용 기반 요금제 테이블 구축, 이메일·결제 및 브랜딩 설정, 고객 검색, 전체 구성 내보내기 등이 가능합니다. 어시스턴트는 고정된 관리자 도구 세트를 통해서만 작동합니다. 절대 쉘 권한을 얻지 않으며, 서버의 파일을 읽지 않고, 저장된 비밀번호나 API 키를 볼 수 없습니다.
수십 개의 페이지를 직접 클릭하는 대신 몇 분 만에 초기 설정을 완료하고 싶거나, 여러 설치를 관리하며 구성을 파일로 유지하고 싶을 때 사용하세요.
세 가지 사용 방법
| 방법 | AI와 대화하는 대상 | 실행 위치 | 시작하기 |
|---|---|---|---|
| 관리자의 AI Chat | NexCMP 관리자 | 선택한 AI 소스: OpenAI, Anthropic, Gemini 또는 OpenRouter의 API 키, 패널 자체의 AI 공급자, 또는 로그인한 공식 AI CLI | 관리자 내 AI Chat |
| MCP를 통한 자체 AI 클라이언트 | Claude Code, Codex CLI, Gemini CLI, Cursor, Claude Desktop, claude.ai 또는 ChatGPT의 사용자 | 사용자의 기기 또는 공급자의 앱에서 https://cloud.example.com/mcp/admin에 있는 패널로 연결됨 | Connect an AI client |
| 코드 기반 구성 (IaC) | 사용자 또는 스크립트 | YAML 파일과 서버의 nexcmp config 명령어 (또는 Import/Export 페이지) | Configuration as code |
세 가지 방법 모두 동일한 도구를 호출하고 동일한 보안 계층을 거치므로 혼용할 수 있습니다. 어시스턴트로 구성을 초안 작성하고, YAML로 내보내고, 편집기에서 검토한 뒤 나중에 적용하세요.
보안 모델
| 규칙 | 의미하는 바 |
|---|---|
| 범위 (Scopes) | 키나 연결은 체크한 범위(admin:read, catalog:write, infra:write, billing:write, customers:write, settings:write, ai:write, secrets:write)로 제한됩니다. 범위가 없으면 호출이 거부됩니다. Admin API keys를 참조하세요. |
| Expiry | 모든 키와 연결은 만료됩니다. 생성한 키는 1~90일(기본값 30일) 동안 유지됩니다. OAuth 액세스 토큰은 1시간 동안 유효합니다. |
| IP 제한 및 속도 제한 | 키는 IP 대역 및 분당 호출 수(기본값 120회)로 제한할 수 있습니다. |
| 2단계 확인 | 금전 이동, 데이터 삭제, 결제 자격 증명 변경 또는 로그인 보안 변경을 수행하는 작업은 먼저 미리보기를 반환하며 승인할 때까지 실행되지 않습니다. AI Chat 내의 모든 변경 사항은 직접 누르는 확인 카드입니다. |
| 키가 절대 할 수 없는 일 | 관리자 생성, 2FA 변경, 키 생성 또는 취소, 고객으로 로그인, 패널 백업·복원·업데이트 등 유사한 작업입니다. 이는 관리자가 직접 수행해야 합니다. |
| 활동 로그 | 허용되거나 거부된 모든 호출은 키, 클라이언트, 도구, IP 및 결과와 함께 기록됩니다. System › Settings › API & AI agents › Activity를 참조하십시오. |
| 비밀 정보는 절대 반환되지 않음 | 비밀번호, API 키와 토큰은 설정할 수 있지만 절대 다시 읽어올 수 없습니다. AI가 보는 답변에는 마스킹된 상태로 표시됩니다. |
| 데모 설치 버전은 읽기 전용입니다 | 데모 패널에서는 모든 쓰기 작업이 demo_read_only(으)로 거부됩니다. |
::: important AI가 읽을 수 있는 내용 admin:read을(를) 통해 어시스턴트는 고객 이름, 이메일 주소, 잔액 및 결제 기록을 읽을 수 있습니다. 공급업체(OpenAI, Anthropic, Google, OpenRouter)에서 실행되는 AI 소스를 사용하는 경우 질문에 답하기 위해 해당 데이터가 해당 공급업체로 전송됩니다. 어시스턴트에게 필요한 최소한의 권한 범위만 부여하고, 해당 데이터를 신뢰할 수 있는 소스를 선택하세요. :::
빠른 시작
- 관리자에 로그인하고 AI Chat을(를) 엽니다. 연결된 AI 소스가 아직 없는 경우 System › Settings › AI accounts을(를) 열고 소스를 연결합니다(AI accounts and subscriptions 참조).
- "Check my setup progress"를 입력하고 엔터 키를 누릅니다. 어시스턴트가 Setup progress checklist을(를) 읽고 남은 작업을 알려줍니다.
- 다음 단계를 수행하도록 요청합니다. 각 확인 카드를 검토하고 Confirm을(를) 눌러 적용합니다.
무엇을 물어봐야 할지 처음 살펴보려면 Example prompts을(를) 참조하세요.
한도 및 참고 사항
- 데모 및 읽기 전용. 데모 패널에서는 페이지가 표시되지만 아무것도 저장할 수 없습니다.
- 셸 없음. 어시스턴트는 Connect an AI client에 나열된 관리자 도구만 호출할 수 있습니다. 서버에서 명령을 실행할 수 없습니다.
- 네트워크 및 라우팅 모듈(BGP, XDP, 인터페이스, NAT 등)은 AI에게 읽기 전용이며, 관리자 계정, 백업, 업데이트와 같은 민감한 영역은 키 접근이 완전히 차단됩니다.
- 가격은 USD 기준입니다. 플랜 가격은 시간당 달러 단위, 잔액은 센트 단위입니다.
- 비용. AI 답변 비용은 연결한 AI 소스(API 사용량 또는 자체 구독)에 지불됩니다. AI Chat에서 일일 지출 한도를 설정할 수 있습니다. NexCMP 라이선스 모델은 https://nexcmp.com/pricing을(를) 참조하세요.
Troubleshooting
| 증상 | 원인 | 해결 방법 |
|---|---|---|
| AI Chat에 연결된 AI 소스가 없다고 표시됨 | 관리자 계정에 소스가 설정되지 않음 | System › Settings › AI accounts를 열고 소스를 연결하세요. |
어시스턴트가 insufficient_scope(으)로 답변함 | 키 또는 연결에 해당 도구에 대한 권한 범위가 없음 | 필요한 권한 범위가 포함된 키를 생성하거나, 다시 연결하여 동의 화면에서 체크합니다. Admin API keys 참조. |
| 모든 변경 사항에 확인 카드가 표시됨 | AI Chat에서 예상되는 동작 | Confirm을(를) 눌러 적용하거나 Reject을(를) 눌러 취소합니다. |
쓰기 작업이 demo_read_only(으)로 실패함 | 패널이 데모 모드임 | 데모가 아닌 설치 버전을 사용하세요. |