# Usa KolHive e KolWrite dalla tua app di IA

La tua app di IA può lavorare nell'app desktop KolHive, KolWrite o KolChat sul tuo computer: Claude Code, Codex, Cursor, Gemini CLI, VS Code e qualsiasi app che supporti MCP su HTTP. Approvi ogni app una volta e scegli quanto può fare.

Usare la tua app di IA con KolHive o KolWrite richiede il piano Plus o superiore.

## 1. Attivalo

Apri l'app desktop e sbloccala. Vai a Impostazioni → IA → App di IA su questo computer, attivalo e premi Collega un'app. Scegli la tua app, leggi quale azienda di IA riceve ciò che legge, scegli quanto può fare e premi Collega. Ogni app riceve la propria chiave, mostrata una sola volta.

## 2. Collega la tua app

Cursor e VS Code: premi Aggiungi a Cursor o Aggiungi a VS Code nel passaggio di configurazione. L'app si apre e ti chiede di confermare.

Claude Code (in KolWrite il nome è `kolwrite` invece di `kolhive`):

```bash
claude mcp add --scope user --transport http kolhive http://127.0.0.1:47321/mcp --header "Authorization: Bearer khc_..."
```

Non disponibili tramite questa connessione: Claude Desktop e altre app che avviano solo programmi locali, e le app web. Per ChatGPT, Claude.ai e telefoni, vedi il passo 5.

Qualsiasi altra app MCP: usa l'indirizzo e l'intestazione mostrati nel passaggio di configurazione.

```text
URL: http://127.0.0.1:47321/mcp
Header: Authorization: Bearer khc_...
```

## 3. Cosa può fare la tua app di IA

- KolHive: file, documenti e fogli di calcolo, note, attività e calendario, l'editor video, trascrizioni, condivisione, app e creazione di app.
- KolWrite: file, note e calendario, trascrizioni e condivisione. Nessuna creazione di app e nessun KOL Store.
- KolChat: solo i tuoi crediti e il tuo spazio. Le app di IA non possono leggere i tuoi messaggi.
- Avviare una trascrizione nel cloud spende i tuoi crediti. L'app te lo chiede ogni volta, a meno che tu non le abbia dato il controllo totale e consentito le spese.

## 4. Sicuro per progetto

- Ascolta solo su `127.0.0.1`, questo computer, quindi Windows non chiede nulla sul suo firewall.
- Prima che un'app si colleghi, l'app desktop indica l'azienda di IA che riceve ciò che l'app legge, secondo i termini di quell'azienda, e attende il tuo OK.
- Chiedi prima di eliminare, condividere o spendere (predefinito): l'app legge, modifica e costruisce senza chiedere, e ti chiede ogni volta prima di eliminare, condividere o inviare, pubblicare o spendere crediti. Controllo totale, non chiedere mai: nessuna domanda, tranne prima di spendere, a meno che tu non lo consenta. Nulla viene ricordato tra una domanda e l'altra.
- Ogni app ha la propria chiave, e KolHive e KolWrite ne conservano solo un'impronta. Rimuovi un'app e il suo accesso termina subito.
- L'app desktop deve essere aperta e sbloccata. Uscire dall'account rimuove tutte le app.
- Le impostazioni mostrano cosa ha fatto ogni app, mai cosa ha letto.
- Ciò che la tua app di IA legge va alla sua azienda di IA. Nient'altro lascia il tuo computer attraverso questa connessione.

## 5. ChatGPT, Claude.ai e telefoni

Queste app non raggiungono il tuo computer, quindi usano il connettore online: aggiungi KolHive o KolWrite una volta nell’app di IA, accedi e scegli cosa può fare. Funziona da qualsiasi dispositivo, con l’app desktop chiusa, per file, trascrizione (con i tuoi crediti, prezzo mostrato prima) e link di condivisione. Documenti, note e calendario restano sul tuo computer. Se è già aperto, e l’indirizzo da aggiungere: [Guida KolHive](https://www.kolhive.com/en/chatgpt-claude-connector/).

## 6. Una guida breve per app

In KolHive o KolWrite apri ChatGPT e Claude dal menu e scegli la tua app: mostra questi stessi passaggi. I passaggi online funzionano quando il connettore online è aperto (stato nella guida KolHive qui sopra). Su un desktop puoi scegliere invece This computer, che funziona offline finché l’app è aperta (passaggi da 1 a 4).

- **ChatGPT**: copia il tuo indirizzo nell’app. Su chatgpt.com apri Plugins → + → Add custom MCP server, incollalo, accedi e tocca Consenti. Cosa puoi aggiungere lo decide ChatGPT, non noi; a novembre 2026 Business ed Enterprise/Edu possono leggere e scrivere, Pro può leggere e il piano gratuito non può aggiungere server personalizzati, quindi controlla l’aiuto di ChatGPT. L’app ChatGPT del telefono lo usa poi.
- **Claude**: copia il tuo indirizzo nell’app. Su claude.ai o in Claude Desktop apri Customize → Connectors → + Add → Add custom connector, incollalo, accedi e tocca Consenti. Tutti i piani Claude permettono un connettore personalizzato; quello gratuito uno. Le app Claude del telefono usano i connettori aggiunti sul web.
- **Cursor e VS Code**: tocca Add to Cursor o Add to VS Code. L’app si apre e chiede conferma; poi accedi e tocca Consenti. In VS Code puoi anche usare Command Palette → MCP: Add Server → HTTP.
- **Claude Code**: copia dall’app il comando di una riga, eseguilo nel terminale, digita `/mcp` in Claude Code, accedi e tocca Consenti.
- **Codex e Gemini CLI**: copia dall’app il comando di una riga, eseguilo nel terminale, poi accedi e tocca Consenti.
- **Qualsiasi altra app di IA**: aggiungi un server MCP remoto (HTTP) con l’indirizzo mostrato dall’app, accedi e tocca Consenti.
