---
title: Configura con l'IA
description: Configura e gestisci NexCMP con un assistente AI: AI Chat nell'admin, client AI via MCP o file YAML. Funzionalità disponibili e regole di sicurezza.
url: https://nexcmp.com/it/docs/configure-with-ai/overview/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# Configura con l'IA {#configure-with-ai}

> **Dove nell'admin:** AI Chat (`/agent`) e System › Settings › API & AI agents (`/agent/keys`). Tutto in queste pagine è riservato agli amministratori.

## Descrizione {#what-it-does}

A partire da NexCMP 1.4.0 puoi chiedere a un assistente IA di configurare il pannello per te: connettere Proxmox VE o CloudStack, creare una zona, generare una tabella dei piani dai tuoi costi, configurare email, pagamenti e branding, trovare un cliente o esportare l'intera configurazione. L'assistente opera tramite un set fisso di **strumenti di amministrazione**. Non ottiene mai una shell, non legge file sul server e non vede mai password o API key memorizzate.

Usalo quando desideri una prima configurazione in pochi minuti invece di cliccare su una dozzina di pagine, o quando gestisci più installazioni e vuoi mantenere la loro configurazione in un file.

## Tre modi per usarlo {#three-ways-to-use-it}

| Modalità | Chi parla con l'IA | Dove viene eseguito | Inizia qui |
|---|---|---|---|
| **AI Chat nell'admin** | Tu, nell'admin di NexCMP | La sorgente IA che scegli: una API key di OpenAI, Anthropic, Gemini o OpenRouter, il provider IA del tuo pannello o una CLI IA ufficiale a cui hai effettuato l'accesso | [AI Chat nell'admin](https://nexcmp.com/it/docs/configure-with-ai/ai-chat-in-admin/) |
| **Il tuo client IA tramite MCP** | Tu, in Claude Code, Codex CLI, Gemini CLI, Cursor, Claude Desktop, claude.ai o ChatGPT | Sul tuo computer o nell'app del fornitore, connesso al tuo pannello su `https://cloud.example.com/mcp/admin` | [Connect an AI client](https://nexcmp.com/it/docs/configure-with-ai/mcp-admin/) |
| **Configurazione come codice** | Tu o uno script | Un file YAML e il comando `nexcmp config` sul server (o la pagina Import/Export) | [Configuration as code](https://nexcmp.com/it/docs/configure-with-ai/config-as-code/) |

Tutti e tre richiamano gli stessi strumenti e passano attraverso lo stesso livello di sicurezza, quindi puoi combinarli: abbozza una configurazione con un assistente, esportala come YAML, esaminala nel tuo editor e applicala in seguito.

## Modello di sicurezza {#safety-model}

| Regola | Cosa significa per te |
|---|---|
| **Ambiti** | Una chiave o una connessione è limitata agli ambiti che spunti (`admin:read`, `catalog:write`, `infra:write`, `billing:write`, `customers:write`, `settings:write`, `ai:write`, `secrets:write`). Senza un ambito la chiamata viene rifiutata. Vedi [Admin API keys](https://nexcmp.com/it/docs/configure-with-ai/admin-api-keys/#scopes). |
| **Expiry** | Ogni chiave e connessione scade: da 1 a 90 giorni per le chiavi che crei, 30 giorni per impostazione predefinita. I token di accesso OAuth durano un'ora. |
| **Restrizione IP e limite di frequenza** | Una chiave può essere limitata agli intervalli IP e a un numero di chiamate al minuto (120 per impostazione predefinita). |
| **Conferma in due passaggi** | Le azioni che muovono denaro, eliminano dati, modificano le credenziali di pagamento o la sicurezza di accesso restituiscono prima un'anteprima e non fanno nulla finché non approvi. All'interno di AI Chat ogni modifica è una scheda di conferma che premi tu stesso. |
| **Azioni che le chiavi non possono mai compiere** | Creare amministratori, modificare la 2FA, creare o revocare chiavi, accedere come cliente, effettuare backup, ripristinare o aggiornare il pannello e simili. Queste operazioni richiedono la tua presenza nell'admin. |
| **Registro attività** | Ogni chiamata, consentita o rifiutata, viene registrata con la chiave, il client, lo strumento, l'IP e il risultato. Vedi System › Settings › API & AI agents › Activity. |
| **I dati riservati non vengono mai restituiti** | Password, chiavi API e token possono essere impostati ma non letti. Le risposte visualizzate dall'IA li mostrano mascherati. |
| **Le installazioni demo sono di sola lettura** | In un pannello demo ogni operazione di scrittura viene rifiutata con `demo_read_only`. |

::: important Cosa può leggere l'IA
Con `admin:read` un assistente può leggere nomi di clienti, indirizzi e-mail, saldi e registri di fatturazione. Quando utilizzi una sorgente di IA eseguita presso un fornitore (OpenAI, Anthropic, Google, OpenRouter), tali dati vengono inviati a tale fornitore per rispondere alla tua domanda. Assegna a un assistente il set di ambiti minimo necessario e scegli una sorgente di cui ti fidi per questi dati.
:::

## Avvio rapido {#quick-start}

1. Accedi all'area amministrativa e apri **AI Chat**. Se non è ancora connessa alcuna sorgente di IA, apri **System › Settings › AI accounts** e connettine una (vedi [AI accounts and subscriptions](https://nexcmp.com/it/docs/configure-with-ai/ai-accounts-and-subscriptions/)).
2. Digita "Check my setup progress" e premi Invio. L'assistente legge la [Setup progress checklist](https://nexcmp.com/it/docs/configure-with-ai/setup-checklist/) e ti indica cosa manca.
3. Chiedigli di eseguire il passaggio successivo. Esamina ogni scheda di conferma e premi **Confirm** per applicarla.

Per una prima panoramica delle domande da porre, vedi [Example prompts](https://nexcmp.com/it/docs/configure-with-ai/example-prompts/).

![Pagina AI Chat con una conversazione, il risultato di uno strumento e una scheda di conferma](https://nexcmp.com/it/docs/images/configure-with-ai/overview-01-ai-chat.webp)

## Limiti e note {#limits-notes}

- **Demo e sola lettura.** Le pagine sono visibili su un pannello demo, ma non è possibile salvare nulla.
- **Nessuna shell.** L'assistente può richiamare solo gli strumenti di amministrazione elencati in [Connect an AI client](https://nexcmp.com/it/docs/configure-with-ai/mcp-admin/#tools). Non può eseguire comandi sul server.
- **I moduli di rete e routing** (BGP, XDP, interfacce, NAT e simili) sono di sola lettura per l'IA, mentre le aree sensibili come account amministrativi, backup e aggiornamenti sono interamente precluse alle chiavi.
- **I prezzi** sono in USD: i prezzi dei piani in dollari all'ora, i saldi in centesimi.
- **Costo.** Le risposte dell'IA vengono pagate alla sorgente di IA connessa (utilizzo API o abbonamento personale). In AI Chat puoi impostare un limite di spesa giornaliero. Per il modello di licenza di NexCMP vedi https://nexcmp.com/pricing.

## Troubleshooting {#troubleshooting}

| Sintomo | Causa | Soluzione |
|---|---|---|
| AI Chat indica che non è connessa alcuna sorgente di IA | Nessuna sorgente configurata per il tuo account amministratore | Apri System › Settings › AI accounts e connettine una. |
| Un assistente risponde `insufficient_scope` | La chiave o la connessione non dispone dell'ambito per quello strumento | Crea una chiave con l'ambito necessario oppure ricollegati e selezionala nella schermata di consenso. Vedi [Admin API keys](https://nexcmp.com/it/docs/configure-with-ai/admin-api-keys/#errors). |
| Ogni modifica mostra una scheda di conferma | Comportamento previsto in AI Chat | Premi **Confirm** per applicare o **Reject** per annullare. |
| Le scritture falliscono con `demo_read_only` | Il pannello è in modalità demo | Utilizza un'installazione non demo. |