---
title: AI로 설정하기
description: AI 어시스턴트로 NexCMP를 설정하고 운영하세요. 관리자 내 AI Chat, MCP 기반 자체 AI 클라이언트 또는 YAML 파일을 지원합니다. 주요 기능과 안전 수칙을 확인하세요.
url: https://nexcmp.com/ko/docs/configure-with-ai/overview/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# AI로 설정하기 {#configure-with-ai}

> **관리자 메뉴 위치:** AI Chat(`/agent`) 및 System › Settings › API & AI agents(`/agent/keys`). 이 페이지의 모든 항목은 관리자 전용입니다.

## 작동 내용 {#what-it-does}

NexCMP 1.4.0부터 AI 어시스턴트에 패널 설정을 요청할 수 있습니다. Proxmox VE 또는 CloudStack 연결, 존 생성, 비용 기반 요금제 테이블 구축, 이메일·결제 및 브랜딩 설정, 고객 검색, 전체 구성 내보내기 등이 가능합니다. 어시스턴트는 고정된 **관리자 도구** 세트를 통해서만 작동합니다. 절대 쉘 권한을 얻지 않으며, 서버의 파일을 읽지 않고, 저장된 비밀번호나 API 키를 볼 수 없습니다.

수십 개의 페이지를 직접 클릭하는 대신 몇 분 만에 초기 설정을 완료하고 싶거나, 여러 설치를 관리하며 구성을 파일로 유지하고 싶을 때 사용하세요.

## 세 가지 사용 방법 {#three-ways-to-use-it}

| 방법 | AI와 대화하는 대상 | 실행 위치 | 시작하기 |
|---|---|---|---|
| **관리자의 AI Chat** | NexCMP 관리자 | 선택한 AI 소스: OpenAI, Anthropic, Gemini 또는 OpenRouter의 API 키, 패널 자체의 AI 공급자, 또는 로그인한 공식 AI CLI | [관리자 내 AI Chat](https://nexcmp.com/ko/docs/configure-with-ai/ai-chat-in-admin/) |
| **MCP를 통한 자체 AI 클라이언트** | Claude Code, Codex CLI, Gemini CLI, Cursor, Claude Desktop, claude.ai 또는 ChatGPT의 사용자 | 사용자의 기기 또는 공급자의 앱에서 `https://cloud.example.com/mcp/admin`에 있는 패널로 연결됨 | [Connect an AI client](https://nexcmp.com/ko/docs/configure-with-ai/mcp-admin/) |
| **코드 기반 구성 (IaC)** | 사용자 또는 스크립트 | YAML 파일과 서버의 `nexcmp config` 명령어 (또는 Import/Export 페이지) | [Configuration as code](https://nexcmp.com/ko/docs/configure-with-ai/config-as-code/) |

세 가지 방법 모두 동일한 도구를 호출하고 동일한 보안 계층을 거치므로 혼용할 수 있습니다. 어시스턴트로 구성을 초안 작성하고, YAML로 내보내고, 편집기에서 검토한 뒤 나중에 적용하세요.

## 보안 모델 {#safety-model}

| 규칙 | 의미하는 바 |
|---|---|
| **범위 (Scopes)** | 키나 연결은 체크한 범위(`admin:read`, `catalog:write`, `infra:write`, `billing:write`, `customers:write`, `settings:write`, `ai:write`, `secrets:write`)로 제한됩니다. 범위가 없으면 호출이 거부됩니다. [Admin API keys](https://nexcmp.com/ko/docs/configure-with-ai/admin-api-keys/#scopes)를 참조하세요. |
| **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 소스를 사용하는 경우 질문에 답하기 위해 해당 데이터가 해당 공급업체로 전송됩니다. 어시스턴트에게 필요한 최소한의 권한 범위만 부여하고, 해당 데이터를 신뢰할 수 있는 소스를 선택하세요.
:::

## 빠른 시작 {#quick-start}

1. 관리자에 로그인하고 **AI Chat**을(를) 엽니다. 연결된 AI 소스가 아직 없는 경우 **System › Settings › AI accounts**을(를) 열고 소스를 연결합니다([AI accounts and subscriptions](https://nexcmp.com/ko/docs/configure-with-ai/ai-accounts-and-subscriptions/) 참조).
2. "Check my setup progress"를 입력하고 엔터 키를 누릅니다. 어시스턴트가 [Setup progress checklist](https://nexcmp.com/ko/docs/configure-with-ai/setup-checklist/)을(를) 읽고 남은 작업을 알려줍니다.
3. 다음 단계를 수행하도록 요청합니다. 각 확인 카드를 검토하고 **Confirm**을(를) 눌러 적용합니다.

무엇을 물어봐야 할지 처음 살펴보려면 [Example prompts](https://nexcmp.com/ko/docs/configure-with-ai/example-prompts/)을(를) 참조하세요.

![대화, 도구 결과 및 확인 카드가 표시된 AI Chat 페이지](https://nexcmp.com/ko/docs/images/configure-with-ai/overview-01-ai-chat.webp)

## 한도 및 참고 사항 {#limits-notes}

- **데모 및 읽기 전용.** 데모 패널에서는 페이지가 표시되지만 아무것도 저장할 수 없습니다.
- **셸 없음.** 어시스턴트는 [Connect an AI client](https://nexcmp.com/ko/docs/configure-with-ai/mcp-admin/#tools)에 나열된 관리자 도구만 호출할 수 있습니다. 서버에서 명령을 실행할 수 없습니다.
- **네트워크 및 라우팅 모듈**(BGP, XDP, 인터페이스, NAT 등)은 AI에게 읽기 전용이며, 관리자 계정, 백업, 업데이트와 같은 민감한 영역은 키 접근이 완전히 차단됩니다.
- **가격**은 USD 기준입니다. 플랜 가격은 시간당 달러 단위, 잔액은 센트 단위입니다.
- **비용.** AI 답변 비용은 연결한 AI 소스(API 사용량 또는 자체 구독)에 지불됩니다. AI Chat에서 일일 지출 한도를 설정할 수 있습니다. NexCMP 라이선스 모델은 https://nexcmp.com/pricing을(를) 참조하세요.

## Troubleshooting {#troubleshooting}

| 증상 | 원인 | 해결 방법 |
|---|---|---|
| AI Chat에 연결된 AI 소스가 없다고 표시됨 | 관리자 계정에 소스가 설정되지 않음 | System › Settings › AI accounts를 열고 소스를 연결하세요. |
| 어시스턴트가 `insufficient_scope`(으)로 답변함 | 키 또는 연결에 해당 도구에 대한 권한 범위가 없음 | 필요한 권한 범위가 포함된 키를 생성하거나, 다시 연결하여 동의 화면에서 체크합니다. [Admin API keys](https://nexcmp.com/ko/docs/configure-with-ai/admin-api-keys/#errors) 참조. |
| 모든 변경 사항에 확인 카드가 표시됨 | AI Chat에서 예상되는 동작 | **Confirm**을(를) 눌러 적용하거나 **Reject**을(를) 눌러 취소합니다. |
| 쓰기 작업이 `demo_read_only`(으)로 실패함 | 패널이 데모 모드임 | 데모가 아닌 설치 버전을 사용하세요. |