> For the complete documentation index, see [llms.txt](https://docs.incogniton.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.incogniton.com/documentation/italian-documentation/api-di-automazione-e-sdk/connect-ai-clients-mcp.md).

# Connetti i client AI con MCP

Genera un token MCP in Impostazioni → Automazione e collega Claude Desktop, Claude Code, Cursor, Windsurf, VS Code o Codex CLI al tuo account Incogniton.

Apri **Impostazioni** nel menu a sinistra, clicca sulla scheda **Automazione** e clicca su **Genera Token MCP**. Quindi scegli il tuo client AI sotto **Installa nel tuo client AI** e clicca su **Copia configurazione**.

MCP (Model Context Protocol) consente a un client AI come Claude, Cursor o VS Code di lavorare con il tuo account Incogniton. Puoi chiedergli di trovare, creare o modificare profili, gestire proxy, gruppi e tag, e avviare o fermare profili.

La connessione avviene tramite il pacchetto npm `@incogniton/mcp`. Il tuo client AI lo avvia con `npx`, quindi hai bisogno di [Node.js](https://nodejs.org/) 18 o più recente sul computer dove gira il client AI.

### Genera il tuo token MCP

{% stepper %}
{% step %}

#### Apri la scheda Automazione

Clicca su **Impostazioni** nel menu a sinistra, poi clicca sulla scheda **Automazione**. Scorri fino alla sezione **Token MCP**.
{% endstep %}

{% step %}

#### Genera il token

Clicca su **Genera Token MCP**. Il nuovo token appare in un campo sotto il pulsante.
{% endstep %}

{% step %}

#### Copialo e conservalo

Clicca su **Copia** accanto al token e conservalo in un luogo sicuro, ad esempio in un gestore di password. Incogniton mostra il token solo una volta: **Attenzione: Non puoi recuperare questo token in seguito — copialo e conservalo ora.**
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
Tratta il token MCP come una password. Chiunque lo possieda può gestire i profili del tuo account. Non condividerlo mai né incollarlo in un file pubblico.
{% endhint %}

### Sostituisci o revoca il tuo token

Hai un solo token MCP attivo alla volta. Cliccando nuovamente su **Genera Token MCP** si crea un nuovo token e il vecchio smette di funzionare. Aggiorna il token in ogni client AI che hai collegato.

Per interrompere tutti gli accessi, clicca su **Revoca** sotto **Token attivi**. Quando nessun token è attivo, la sezione mostra **Nessun token attivo**.

### Aggiungi Incogniton al tuo client AI

Sotto **Installa nel tuo client AI**, apri il menu a tendina **Client AI** e scegli il tuo client: Claude Desktop, Claude Code, Cursor, Windsurf, VS Code o Codex CLI. Incogniton mostra una configurazione pronta da incollare con il tuo nuovo token già inserito, e ti dice dove incollarlo. Clicca su **Copia configurazione**, incollalo dove l'app ti dice, e riavvia il client AI.

Genera prima il token. Se apri questa lista in seguito, la configurazione contiene `YOUR_MCP_TOKEN` invece di un token: sostituiscilo con il token che hai conservato.

Per la configurazione manuale in altri client MCP, consulta la [documentazione del server MCP](https://api-docs.incogniton.com/mcp).

### Cosa può fare il client AI tramite MCP

Dopo aver effettuato la connessione, il tuo client AI può:

* **Profili:** cercare, creare, modificare e clonare profili, e cercare i gruppi, i tag, i proxy e le lingue del browser che puoi usare per un nuovo profilo.
* **Gruppi e tag:** cercare e creare gruppi di profili e tag.
* **Proxy:** cercare e aggiungere proxy, e cercare e creare gruppi di proxy.
* **Team:** cercare i membri del team.
* **Avvio e arresto:** vedere quali computer possono avviare un profilo, avviare un profilo, controllare se un avvio o un arresto ha funzionato, e fermare un profilo.
* **Telefoni cloud:** elencare i tuoi telefoni cloud, creare un telefono cloud con un proxy dalla tua Libreria Proxy, e avviare o fermare telefoni cloud. I telefoni avviati tramite MCP si avviano senza schermo.

L'elenco completo degli strumenti è nella [documentazione del server MCP](https://api-docs.incogniton.com/mcp).

### Come funziona l'avvio tramite MCP

Un profilo si apre sempre nell'app Incogniton su uno dei tuoi computer. Quel computer deve avere l'app aperta e connessa al tuo account.

* Se un computer è disponibile, il profilo si avvia lì. Se ce ne sono diversi, il client AI ottiene l'elenco dei computer e tu ne scegli uno.
* Una richiesta di avvio che nessun computer raccoglie entro 5 minuti scade.
* MCP può fermare solo i profili avviati tramite MCP. Chiudi un profilo che hai aperto tu stesso dall'app Incogniton.

### Controlla il browser dopo un avvio MCP

MCP stesso apre e chiude solo i profili. Non può cliccare, digitare o leggere pagine all'interno del browser.

Dopo un avvio, il client AI può ottenere un indirizzo DevTools locale (`cdp_url`) del browser in esecuzione. Un client AI che può eseguire codice può connettere Puppeteer, Playwright o un browser MCP a quell'indirizzo.

{% hint style="info" %}
Il `cdp_url` funziona solo quando il client AI gira sul **medesimo computer** dell'app Incogniton che ha avviato il profilo. Non funziona da un altro computer, o da un client che non può eseguire codice, come Claude Desktop. È inoltre necessario che **Consenti controllo remoto del browser** sia attivo nella scheda Automazione. Vedi [Controllo remoto del browser](https://docs.incogniton.com/documentation/italian-documentation/api-di-automazione-e-sdk/browser-remote-control.md).
{% endhint %}

### Cosa non può fare MCP

Queste azioni non sono disponibili tramite MCP:

* Aprire un URL, gestire schede o leggere pagine in un profilo in esecuzione.
* Verificare se un proxy funziona.
* Eliminare profili.
* Ripristinare un profilo da un backup.

Cas, l'assistente AI all'interno dell'app Incogniton, può fare queste cose. Apri Cas nell'app per usarle.

### Risoluzione dei problemi

* **Il client non mostra strumenti Incogniton:** riavvia il client AI dopo aver incollato la configurazione e verifica che Node.js 18 o più recente sia installato.
* **Il log MCP del client mostra "token mancante":** il token manca dalla configurazione. Incolla il tuo token al posto di `YOUR_MCP_TOKEN`.
* **Errori di autenticazione:** il token è stato sostituito o revocato. Genera uno nuovo e aggiorna la configurazione.

Per gli script che girano sul tuo computer, puoi anche usare la [API REST locale](https://docs.incogniton.com/documentation/italian-documentation/api-di-automazione-e-sdk/local-rest-api.md) o l'[SDK JavaScript e Python](https://docs.incogniton.com/documentation/italian-documentation/api-di-automazione-e-sdk/javascript-and-python-sdk.md).
