# SweetHive — Come funziona SweetHive — e come ottenere il massimo.

Un unico file markdown con tutta la guida — dallo a ChatGPT, Claude o a qualsiasi assistente e chiedi come usare SweetHive e potenziare la tua attività.

Source: https://docs.sweethive.com/it/ (generated from the official SweetHive documentation).


---


# Cos'è SweetHive

SweetHive è uno spazio di lavoro in cui ogni luogo di lavoro ha il proprio contesto e il
proprio ambito. Invece di un'unica grande chat, le informazioni sono organizzate in un
**albero di contesti**, e chi vede cosa è deciso dai **gruppi** — non da lunghe liste di
destinatari.

## I tre elementi fondamentali

- **Hive** — uno spazio di lavoro (un'azienda, un progetto, una scuola, un museo, una
  famiglia). Tutto vive dentro un hive.
- **Contesto** — un nodo dentro un hive. I contesti formano un albero: un contesto può
  contenere sotto-contesti, con la profondità che ti serve (es. *WEREA SRL →
  Amministrazione → Persone → Paghe*).
- **Gruppo** — un insieme di persone. I gruppi sono collegati ai contesti e regolano la
  visibilità: vedi un contesto solo se uno dei tuoi gruppi è **attivo** lì.

## Come fluisce la visibilità

La visibilità fluisce **verso il basso** lungo l'albero: l'accesso a un contesto copre
anche i contesti al suo interno. Un messaggio che scrivi in un contesto, indirizzato a
un gruppo, è visibile a quel gruppo in quel contesto e in tutto ciò che sta sotto — mai
oltre.

> **La regola d'oro:** niente è visibile a qualcuno se un gruppo a cui appartiene non è
> attivo su quel contesto. È questo che mantiene separati in sicurezza pubblici con
> livelli di fiducia diversi (staff, partner, clienti) in un unico hive.

## Cosa vive in un contesto

Oltre ai messaggi, ogni contesto aggrega i suoi contenuti nelle app integrate —
**Galleria** (immagini e video), **Note**, **Attività**, **Agenda** (eventi),
**AnyDocs** (file e link) — e può ospitare app personalizzate installate da un admin.
Tutto obbedisce alla stessa legge di visibilità.

## Dove entra l'AI

SweetHive è costruito per lavorare con gli assistenti AI: puoi collegare il tuo agente
(Claude, un agente di classe OpenClaw o qualsiasi assistente compatibile MCP) con un
token con ambito limitato che non supera mai la tua visibilità, chattare con lui
dall'interno di SweetHive e scaricare l'intera guida come singolo file markdown per
insegnare a qualsiasi AI come funziona SweetHive — vedi
[Usare SweetHive con l'AI](/it/use-sweethive-with-ai/).


---


# Avvio rapido

## Accedi

Vai su [sweethive.com](https://sweethive.com) e accedi con la tua email (o il telefono)
e la password. SweetHive usa un single sign-on su tutta la famiglia di prodotti, quindi
lo stesso account funziona sull'app web, sulle app mobili e sui prodotti satellite.

Su **iOS e Android** l'app SweetHive ti fa accedere con le stesse credenziali —
vedi [App mobili](/it/mobile/).

## La pagina iniziale: Il mio SweetHive

Dopo l'accesso arrivi su **Il mio SweetHive**, la tua bacheca personale:

- **Inviti** — gli hive a cui sei stato invitato; accetta per entrare.
- **Hive** — tutti gli hive a cui appartieni, con **Crea nuovo** per avviarne uno tuo.
- **Contesti** — accesso rapido ai contesti che usi.
- **Connettori** — i servizi esterni (Gmail, Google Calendar, Google Drive, …) che hai
  collegato; vedi [Connettori](/it/connectors/).
- Il **feed di attività** — i messaggi condivisi con i tuoi gruppi da tutti i tuoi hive.

## Orientarsi

- La **barra superiore** mostra dove sei (percorso hive → contesto) e ospita
  **Scrivi un messaggio** e la **ricerca**.
- La **barra delle icone** a sinistra passa tra le aree dell'hive corrente:
  Contesti, Gruppi, Persone, App, Agenti, Connettori, Notifiche.
- Il **pannello messaggi** è agganciato accanto al contenuto e segue sempre il contesto
  in cui ti trovi: mostra il feed del sottoalbero del contesto corrente.

## I primi passi

1. **Entra in un hive o creane uno** — accetta un invito, oppure [crea un hive](/it/create-a-hive/)
   con la procedura guidata.
2. **Apri un contesto** e leggi la sua bacheca: descrizione, sotto-contesti, gruppi
   attivi, app, persone.
3. **Scrivi un messaggio** — scegli il contesto e i gruppi destinatari, allega ciò che
   ti serve, invia. Vedi [Messaggi](/it/messages/).
4. **Installa l'app mobile** — SweetHive è sull'App Store e su Google Play; vedi
   [App mobili](/it/mobile/).

## Lingue

SweetHive parla **English, Italiano, Français, Deutsch ed Español**. Imposta la tua
lingua in *Impostazioni → Profilo → Preferenze* — l'app (e i link a questa
documentazione) la seguono.


---


# Crea un hive

Chiunque può creare un hive. Chi lo crea ne diventa il primo admin, con un
**gruppo Admin** creato automaticamente. La creazione è una **procedura guidata** che
ti aiuta a progettare un ambiente completo — contesti e gruppi — prima che qualcosa
venga creato.

Parti da **Il mio SweetHive → Hive → Crea nuovo**.

## Passo 1 — Crea

Scegli cosa vuoi costruire: **Azienda**, **Team**, **Scuola** o **Progetto** su
SweetHive — oppure un **Museo** (AerariumChain) / un'**Academy** (WiredExperience)
sulle piattaforme satellite. La tua scelta adatta il resto della procedura.

## Passo 2 — Piano

Scegli a chi appartiene l'hive:

- **Personale** — l'hive vive sul tuo account personale e sul suo piano (gratuito).
- **Organizzazione** — l'hive appartiene a una delle tue organizzazioni e usa il piano
  dell'organizzazione. Vedi [Impostazioni](/it/settings/) per creare organizzazioni e
  gestire i piani.

## Passo 3 — Template

Scegli una struttura di partenza dal catalogo di template del tuo cluster, oppure parti
da **Vuoto**. Lo scopo scelto al passo 1 preseleziona un template corrispondente quando
esiste. Un template descrive un ambiente pronto all'uso: l'albero dei contesti, i
gruppi e quali gruppi sono attivi dove.

## Passo 4 — Ambiente

È il cuore della procedura: un **editor ad albero** completo dove dai forma
all'ambiente prima che esista. Puoi:

- **aggiungere, rinominare ed eliminare contesti**, annidati con la profondità che ti
  serve;
- **aggiungere, rinominare ed eliminare gruppi**;
- **attivare o disattivare i gruppi in ogni contesto** — decidendo, nodo per nodo, chi
  vedrà cosa.

Prenditi il tempo che serve: un albero ben progettato significa che poi la visibilità
si regola da sola.

## Passo 5 — Dettagli

Dai un nome all'hive, aggiungi una descrizione facoltativa e importa un'**immagine di
copertina** — trascina per riposizionare, zooma con il cursore; SweetHive la
ridimensiona per te. Se l'ambiente che hai costruito merita di essere riutilizzato,
spunta **“salva questo ambiente come template riutilizzabile”** e si aggiunge al tuo
catalogo di template per la prossima volta.

**Crea** applica l'intero albero modificato in un'unica operazione atomica — contesti,
gruppi e attivazioni prendono vita insieme, e atterri nel nuovo hive come suo admin.

> **Suggerimento:** progetta i gruppi intorno ai *pubblici* (Staff, Fornitori, Clienti,
> Consiglio), non agli organigrammi. Indirizzerai i messaggi ai pubblici ogni giorno.


---


# Contesti

I contesti organizzano un hive in un albero. Ogni contesto ha la propria bacheca, il
proprio feed, le proprie app — e il proprio pubblico, deciso dai gruppi attivi su di
esso.

## Crea un contesto

Solo un admin dell'hive può creare contesti — il pulsante **Crea nuovo** appare sulla
bacheca del contesto quando lì hai i diritti di admin.

1. Apri il contesto dentro cui vuoi crearne uno (o la radice dell'hive).
2. Nella scheda **Contesti interni**, scegli **Crea nuovo**.
3. Facoltativamente importa e ritaglia un'immagine di copertina.
4. Dagli un nome, aggiungi una descrizione, poi **Crea**. Il nuovo contesto si apre
   automaticamente.

Un nuovo contesto eredita il gruppo **Admin** dell'hive, così gli admin possono
gestirlo subito. Attiva i gruppi dei membri per aprirlo ad altre persone.

## La bacheca del contesto

Aprendo un contesto vedi:

- **Descrizione e copertina** — a cosa serve questo luogo.
- **Contesti interni** — i sotto-contesti che puoi vedere.
- **Gruppi attivi** — chi può vedere questo contesto. Gli admin attivano e disattivano
  i gruppi qui; vedi [Gruppi](/it/groups/).
- **App** — le app integrate più le eventuali app personalizzate installate qui; vedi
  [App integrate](/it/built-in-apps/).
- **Persone** — chi è effettivamente in questo contesto, tramite i suoi gruppi attivi.

Il **pannello messaggi** agganciato accanto alla bacheca mostra il feed di questo
contesto *e di tutto ciò che sta sotto* — i messaggi pubblicati più in profondità
nell'albero emergono anche qui, e puoi filtrarli (vedi [Messaggi](/it/messages/)).

## Muoversi

Il **percorso** nella barra superiore mostra il cammino dalla radice dell'hive a dove
ti trovi; **Sali** risale di un livello. La voce **Contesti** della barra delle icone
elenca il sottoalbero del contesto corrente.

> **Suggerimento di progettazione:** un contesto è un *luogo*, non un'etichetta di
> argomento. Se un insieme di informazioni ha un proprio pubblico o un proprio ciclo di
> vita — un progetto, un reparto, un cliente — merita un proprio contesto.


---


# Gruppi

Un gruppo è un insieme di persone con un nome (es. *Admin*, *Founders*, *DevGroup*,
*Fornitori*). I gruppi appartengono a un hive e vengono collegati ai contesti per
concedere visibilità. Sono l'unica cosa che decide chi vede cosa.

## Crea un gruppo

1. In un hive, apri **Gruppi** dalla barra delle icone.
2. Scegli **Crea**, dai al gruppo un nome e una descrizione.
3. Aggiungi persone al gruppo.

## Modifica chi è in un gruppo

Dalla pagina **Gruppi**, apri un gruppo e scegli **Modifica utenti** — un editor a due
colonne mostra chi è *nel* gruppo e chi altro è nell'hive. Sposta le persone dentro e
fuori e **Salva**; la loro visibilità in ogni contesto dove il gruppo è attivo si
aggiorna immediatamente.

Puoi lavorare anche dal lato della persona: nella pagina **Persone**, usa
**⋮ → Cambia gruppi** su una persona per regolare tutte le sue appartenenze in una
volta sola.

## Attiva un gruppo su un contesto

Un contesto mostra i suoi **Gruppi attivi** sulla bacheca. Attivare un gruppo su un
contesto è ciò che rende quel contesto (e tutto ciò che sta sotto) visibile ai membri
del gruppo. Disattiva un gruppo per rimuovere quell'accesso all'istante.

> Poiché la visibilità fluisce verso il basso, attiva un gruppo **al livello più alto
> dell'albero a cui l'accesso deve arrivare — e non oltre.**

## Schemi d'uso quotidiani

- **Gruppo Admin** — creato automaticamente con l'hive; attivo ovunque gli admin
  debbano gestire.
- **Un gruppo per pubblico** — Staff, Clienti, Fornitori, Consiglio. I messaggi si
  indirizzano poi per pubblico con un solo chip.
- **Cerchie di progetto** — un gruppo per ogni team di progetto, attivo solo sul
  contesto del progetto; il resto dell'hive resta invisibile per loro.
- **Accesso temporaneo** — attiva un gruppo per la durata di un incarico, poi
  disattivalo. Nessuna pulizia di permessi individuali.


---


# Persone e inviti

Apri **Persone** dalla barra delle icone per vedere chi è nell'hive. Da qui inviti
nuove persone e gestisci quelle già presenti.

## Invita qualcuno

1. Scegli **Invita persone** e invia un invito via email.
2. L'invitato lo vede in **Il mio SweetHive → Inviti** e accetta per entrare.
3. Una volta dentro, aggiungilo ai [gruppi](/it/groups/) giusti — fino ad allora vede
   solo ciò che l'appartenenza predefinita consente.

## Gestisci una persona

- **⋮ → Cambia gruppi** — regola esattamente cosa può vedere, su tutti i gruppi in
  un'unica finestra.
- **Rimuovi dall'hive** — revoca tutti i suoi accessi in una volta.

## Cosa vede un nuovo membro

Niente, finché un gruppo a cui appartiene non è attivo su un contesto. È così per
scelta: puoi invitare in sicurezza un cliente o un collaboratore esterno nell'hive, e
vedrà sempre e solo i contesti che apri al suo gruppo.

> **Suggerimento:** prima invita, poi colloca. È normale che un nuovo membro veda un
> hive quasi vuoto finché non lo hai aggiunto ai suoi gruppi.


---


# Messaggi

I messaggi si scrivono sempre **in un contesto** e sono indirizzati **a uno o più
gruppi** — è così che SweetHive mantiene onesto l'ambito. Il messaggio (e ogni
allegato) è visibile a quei gruppi in quel contesto e sotto, mai oltre.

## Scrivi e condividi

1. Apri il contesto in cui vuoi pubblicare.
2. Scegli **Scrivi un messaggio** (barra superiore) o **Scrivi** sulla bacheca del
   contesto.
3. Conferma il contesto e scegli i gruppi destinatari mostrati come chip.
4. Scrivi il messaggio. Aggiungi immagini, file, un link, un'attività, un evento o una
   nota dal selettore di allegati.
5. **Invia.** I destinatari lo vedono nel loro flusso di attività; tu puoi vedere chi
   lo ha visto.

**Rispondi** per tenere unito un thread. Un messaggio può essere visto solo da chi
condivide uno dei suoi gruppi — non c'è modo di farlo trapelare oltre.

## Contenuti e allegati

- **Immagini e video** appaiono anche nell'app **Galleria** del contesto.
- **File e link** appaiono in **AnyDocs**. Clicca su qualsiasi contenuto per aprirlo a
  schermo intero, con il messaggio originale accanto.
- **Le note** sono documenti che puoi modificare; appaiono nell'app **Note**.
- **Attività** ed **eventi** finiscono in **Attività** e **Agenda**.
- I contenuti dei tuoi [connettori](/it/connectors/) — un messaggio Gmail, un evento
  del calendario, un file di Drive — possono essere condivisi in un contesto come
  scheda arricchita.

## Cerca e filtra il feed

Il pannello messaggi segue il contesto in cui ti trovi e mostra il feed dell'intero
sottoalbero. Per trovare le cose:

- **Cerca messaggi** dalla barra superiore cerca nel testo del feed.
- I **filtri** restringono il feed per:
  - **intervallo di date** — da/a;
  - **autore** — solo i messaggi delle persone selezionate;
  - **tipo di contenuto** — messaggi con immagini, file, link, attività, eventi o note;
  - **sotto-contesti** — includi l'intero sottoalbero o solo il contesto corrente.

I filtri si combinano, e il filtro attivo è sempre visibile sopra il feed — azzeralo
con un clic.

## Notifiche

I nuovi messaggi per i tuoi gruppi generano notifiche in-app (la pagina **Notifiche**
le raccoglie tutte) e **notifiche push** sulle app mobili. Toccando una push si apre
il messaggio esatto nel suo contesto.


---


# App in un contesto

Ogni contesto aggrega i suoi contenuti in **app integrate**, e un admin dell'hive può
installare **app personalizzate** in aggiunta. Le app vedono i dati attraverso la
stessa legge di ambito di tutto il resto: solo ciò che può vedere la persona che le
usa, mai oltre.

## Le app integrate

| App | Cosa raccoglie |
|---|---|
| **Galleria** | ogni immagine e video pubblicati nel sottoalbero del contesto |
| **Note** | documenti modificabili creati dal compositore |
| **Attività** | attività allegate ai messaggi, con il loro stato |
| **Agenda** | eventi allegati ai messaggi, su un calendario |
| **AnyDocs** | ogni file e link, in un unico posto ricercabile |

Aprile dalla scheda **App** sulla bacheca del contesto. I contenuti si aprono a
schermo intero con il messaggio originale accanto, così nulla perde il suo contesto.

## Installa un'app personalizzata (admin)

1. Apri il contesto e trova la scheda **App** sulla bacheca.
2. Scegli **Aggiungi app** (visibile agli admin).
3. Scegli un'app dal catalogo e poi **Aggiungi**. Appare sotto *App installate*.
4. Aprila dalla scheda App — le app **incorporate** si mostrano sul posto; le app
   **esterne** si aprono in una nuova finestra (o nel browser in-app su mobile).

Rimuovi un'app in qualsiasi momento dal suo menu — il suo accesso si interrompe
immediatamente.

## Famiglie di app professionali

SweetHive ospita anche famiglie di app di produzione usate da migliaia di
organizzazioni — per esempio i registri documentali e formativi **Safety-BI**
(**DocBI**, **Document BI**, **Records**, **DBI Global**), usati per i certificati per
dipendente, la gestione documentale di contesto e i fascicoli del personale. Se la tua
organizzazione le usa, appaiono nella scheda App del contesto come qualsiasi altra app.

Vuoi costruire la tua app? Vedi la
[guida per sviluppatori](/it/build-an-app/).


---


# Connettori

I **connettori** portano i tuoi servizi esterni in SweetHive, così i loro contenuti
possono essere condivisi nei contesti con la stessa visibilità basata sui gruppi di
tutto il resto. Apri l'hub da **Il mio SweetHive → Connettori** o dalla voce
**Connettori** nella barra delle icone.

## Disponibili oggi

- **Gmail** — sfoglia la tua posta in arrivo (sola lettura) e condividi un'email in un
  contesto come scheda arricchita.
- **Google Calendar** — sfoglia i tuoi prossimi eventi (sola lettura) e condividi un
  evento in un contesto.
- **Google Drive** — sfoglia i tuoi file (sola lettura) e condividi una scheda file in
  un contesto. Drive usa la stessa connessione Google di Gmail e Calendar.

Altri connettori — Outlook, Dropbox, OneDrive, Slack, Telegram, Trello, Asana, Jira,
GitHub — sono nella roadmap e appaiono nell'hub come **presto disponibili**.

## Collega Google

1. Apri **Connettori → Gmail** (o Google Drive).
2. Scegli **Connetti** — si apre una finestra di consenso Google; approva gli ambiti di
   sola lettura.
3. La tua posta / i tuoi eventi / i tuoi file appaiono nella pagina del connettore, in
   sola lettura.

**Privacy fin dalla progettazione:**

- L'accesso è in **sola lettura** — SweetHive non invia mai posta, non crea eventi né
  modifica file per tuo conto.
- I tuoi token Google sono conservati **solo lato server** e non raggiungono mai il
  browser.
- Scollega in qualsiasi momento dalla pagina del connettore; l'accesso si interrompe
  immediatamente.
- Se al connettore Google viene aggiunta una nuova capacità (come è avvenuto per
  Drive), ti verrà semplicemente chiesto di ricollegarti una volta per concedere
  l'ambito di lettura aggiuntivo.

## Condividi in un contesto

Ogni email, evento o file in un connettore ha un'azione **Condividi**:

1. Scegli **Condividi** sull'elemento.
2. Scegli **hive → contesto → gruppi** nella finestra di condivisione.
3. Invia — l'elemento arriva nel feed del contesto come scheda arricchita
   (oggetto/mittente per le email, titolo/orario per gli eventi, nome/tipo per i file),
   visibile solo ai gruppi che hai scelto.

È il ponte tra i tuoi strumenti personali e i contesti del tuo team: invece di
inoltrare un'email, la *collochi* dove deve stare.


---


# Impostazioni

Apri **Impostazioni** dal tuo avatar nella barra superiore. Oggi le impostazioni hanno
tre sezioni principali — Profilo, Piano e fatturazione, e Organizzazioni — con altre
(ordini, fornitori) in arrivo.

## Profilo

Tutto ciò che ti riguarda:

- **Identità** — nome, avatar (carica e ritaglia), contatti, indirizzo, profili
  social.
- **Preferenze** — inclusa la tua **lingua** (English, Italiano, Français, Deutsch,
  Español); l'intera app la segue all'istante.
- **Password** — cambiala con la password attuale.
- **Visibilità** — ogni campo del profilo ha la propria impostazione di visibilità,
  così decidi tu cosa possono vedere gli altri membri.

Ogni scheda si salva in modo indipendente — modifica, poi **Salva** su quella scheda.

## Piano e fatturazione

Il tuo account personale ha il proprio piano (gratuito per impostazione predefinita);
ogni **organizzazione** ha il proprio piano — di norma a pagamento. Hive e risorse sono
assegnati a te *o* a un'organizzazione.

- **Piano attuale** — con indicatori in tempo reale di membri e spazio.
- **Piani disponibili** — passa a un piano superiore tramite il checkout sicuro di
  Stripe; dove abilitato, la fatturazione può avvenire anche con bonifico bancario.
- **Metodi di pagamento** — carte salvate, carta predefinita, rimozione.
- **Dati di fatturazione** — i dati fattura (ragione sociale, partita IVA, indirizzo)
  usati su ricevute e fatture.
- **Cronologia pagamenti** — ogni pagamento con ricevute e fatture scaricabili.

## Organizzazioni

Un'organizzazione è un'entità legale/di fatturazione che può possedere hive e risorse.

- **Crea** un'organizzazione (scegli uno username univoco; ottiene il proprio cluster
  business).
- **Profilo e fatturazione** — l'identità e i dati di fatturazione
  dell'organizzazione.
- **Amministratori** — due ruoli: gli amministratori *globali* gestiscono tutto, gli
  amministratori *finanziari* gestiscono la fatturazione. Aggiungi o rimuovi gli uni e
  gli altri.
- **Piano e quota** — il piano dell'organizzazione, l'uso di membri/spazio, le sue
  carte e la sua cronologia pagamenti.

Quando [crei un hive](/it/create-a-hive/) su un piano **Organizzazione**, è
l'organizzazione a possederlo — e sono il suo piano, i suoi membri e il suo spazio a
contare.


---


# App mobili

SweetHive è disponibile come app nativa per **iOS** e **Android**, con lo stesso
account e gli stessi dati dell'app web.

## Download

- **iPhone / iPad** — cerca **SweetHive** sull'**App Store**.
- **Android** — cerca **SweetHive** su **Google Play**.

Accedi con la stessa email (o telefono) e password che usi su
[sweethive.com](https://sweethive.com).

Tutto funziona come sul web: contesti, gruppi, messaggi, app e connettori seguono
ovunque le stesse regole di visibilità.


---


# Usare SweetHive con l'AI

SweetHive è progettato per lavorare *con* il tuo assistente AI, qualunque tu usi. Ci
sono due livelli: insegnare a un'AI **come funziona** SweetHive, e collegare un'AI
**al tuo** SweetHive.

## 1. Insegna alla tua AI come funziona SweetHive (la guida .md)

L'intera documentazione è disponibile come **un unico file markdown per lingua**:

**[Scarica la guida SweetHive (.md)](/downloads/sweethive-guide.it.md)**

Dai quel file a ChatGPT, Claude, Copilot o a qualsiasi assistente — allegalo a una
chat, a un progetto o alla knowledge di un assistente personalizzato — e saprà
all'istante come funziona SweetHive: hive, contesti, gruppi, visibilità, messaggi,
connettori, impostazioni, app.

Poi chiedigli cose come:

- *“In base a questa guida, progetta la struttura di un hive per il mio studio di
  architettura con staff, consulenti esterni e clienti.”*
- *“Quali gruppi dovrei creare perché i fornitori vedano la logistica ma mai i
  prezzi?”*
- *“Prepara il messaggio di aggiornamento settimanale per il mio DevGroup e dimmi in
  quale contesto pubblicarlo.”*
- *“Come può il mio team usare i connettori per smettere di inoltrarsi email?”*
- *“Verifica questo piano: chi vedrebbe cosa se attivo ‘Clienti’ sulla radice del
  progetto?”*

Ogni pagina di questo sito è disponibile anche come markdown puro — aggiungi `.md`
all'URL di qualsiasi articolo (es. `/it/messages.md`) — e i crawler AI possono
scoprire tutto tramite [`/llms.txt`](/llms.txt).

## 2. Collega un'AI al tuo SweetHive

Oltre a sapere *come funziona* SweetHive, il tuo assistente può leggere in sicurezza
(e, se glielo permetti, pubblicare in) i tuoi hive reali:

- [Collega un agente](/it/connect-an-agent/) — emetti un token di accesso con ambito
  limitato da SweetHive; funziona con Claude Desktop, Claude Code, agenti di classe
  OpenClaw e qualsiasi assistente compatibile MCP.
- [Chatta con il tuo agente](/it/chat-with-your-agent/) — parla con il tuo agente
  collegato dall'interno di SweetHive.

Così le tue domande smettono di essere ipotetiche:

- *“Cosa è cambiato nel Progetto A questa settimana?”*
- *“Riassumi le attività aperte in Amministrazione → Persone.”*
- *“Prepara un aggiornamento di stato per il DevGroup in Gigapixel.”*

## Potenzia la tua attività — una ricetta

1. **Scarica la guida** qui sopra e dalla al tuo assistente una volta sola.
2. **Progetta con lui** — lascia che proponga il tuo albero di contesti e i gruppi;
   costruisci il risultato con la [procedura guidata di creazione hive](/it/create-a-hive/).
3. **Collegalo** con un token di sola lettura ai tuoi contesti di lavoro.
4. **Rendilo un'abitudine** — ripasso mattutino (“cosa c'è di nuovo per me?”),
   riassunti settimanali, bozze di aggiornamento che approvi prima di pubblicare.

La tua AI conosce il metodo; il tuo SweetHive custodisce i fatti — con ambito
limitato, al sicuro e sempre sotto il tuo controllo.


---


# SweetHive Agents Node

Lo **SweetHive Agents Node** è un'app desktop per macOS e Windows che esegue i
tuoi agenti SweetHive **sul tuo computer**. Gli agenti rispondono con modelli AI
eseguiti in locale — prompt e contenuti non lasciano mai la tua macchina durante
l'inferenza — e l'app può anche collegare assistenti come **Claude** o
**ChatGPT** ai tuoi contenuti SweetHive tramite MCP.

> Usi OpenClaw? Continua a funzionare come runtime alternativo: legge gli stessi
> bundle di configurazione. L'Agents Node rende però tutto un'unica
> installazione guidata.

## Installazione

1. Scarica l'app:
   - [macOS (Apple Silicon)](https://downloads.sweethive.com/agents-node/mac/SweetHive-Agents-Node-arm64.dmg)
   - [macOS (Intel)](https://downloads.sweethive.com/agents-node/mac/SweetHive-Agents-Node-x64.dmg)
   - [Windows](https://downloads.sweethive.com/agents-node/win/SweetHive-Agents-Node-Setup.exe)
2. Aprila, leggi e **accetta i termini**.
3. **Accedi con il tuo account SweetHive** (stessa email e password dell'app
   web).

L'app si aggiorna automaticamente. Le build per macOS sono firmate e
notarizzate da Apple, quindi si aprono senza avvisi.

## Aggiungere agenti di contesto

Un *agente di contesto* è una connessione limitata agli alveari e ai contesti
che scegli — non può mai vedere più di quanto vedi tu. Puoi crearlo da
entrambi i lati, e restano sincronizzati:

- **Dall'app** — *Context agents → New context agent*: dagli un nome, scegli
  gli alveari, la capacità e la scadenza. Appare subito in SweetHive → **I miei
  agenti**.
- **Dal web SweetHive** — *I miei agenti → Collega un agente*: crea il token,
  scarica il bundle di configurazione e importalo nell'app (*Context agents →
  Import config bundle*).

Chatta con i tuoi agenti da **I miei agenti** in SweetHive — le risposte sono
generate sul tuo computer. Vedi [Chatta con il tuo agente](/it/chat-with-your-agent/).

## Modelli locali

Il runtime AI è **integrato nell'app** — non c'è nient'altro da installare. La
scheda *Modelli locali* mostra un catalogo curato organizzato per tipo di
macchina, con un consiglio per **il tuo** computer: un clic installa un modello
(con avanzamento in tempo reale), un clic lo disinstalla, e i modelli
installati hanno un badge. In *Impostazioni → Cartelle di archiviazione* scegli
dove salvare modelli, file temporanei e librerie degli strumenti.

## Collegare Claude o ChatGPT

La scheda *Collega app AI* trasforma il nodo in un server MCP per il tuo
assistente — ora con **configurazione a un clic**:

- **Collega Claude Code** — trova la CLI `claude` e registra il nodo
  automaticamente; apri una nuova sessione e chiedi dei tuoi contenuti
  SweetHive.
- **Collega Claude Desktop** — scrive la voce nella configurazione di Claude
  Desktop per te; riavvia Claude Desktop e gli strumenti sono pronti.
- **Opzioni per sviluppatori** — lo snippet JSON e un endpoint MCP HTTP locale
  protetto da segreto per altri client.

## SweetHive Desktop — chatta con il tuo computer

La scheda Chat include **SweetHive Desktop**: conversazioni con la macchina
stessa, organizzate come una chat AI moderna (elenco di conversazioni con
titolo, *Nuova chat*). Le risposte arrivano dal tuo modello locale predefinito
e i dati restano sul computer; le conversazioni si sincronizzano con il tuo
account, così puoi aprirle anche **da SweetHive web** (*I miei agenti →
SweetHive Desktop*) e parlare col tuo computer da remoto — risponde in pochi
secondi quando l'app è in esecuzione.

## Privacy e controllo

- I token hanno un perimetro, scadono e sono revocabili in ogni momento da
  **I miei agenti**.
- I segreti sono cifrati con il portachiavi del sistema operativo.
- L'inferenza dei modelli avviene interamente sulla tua macchina.


---


# Collega un agente

Puoi collegare a SweetHive un assistente AI locale — Claude Desktop, Claude Code, un
agente di classe OpenClaw o qualsiasi agente compatibile MCP. Si collega con un
**token di accesso con ambito limitato** che non supera mai ciò che puoi vedere tu, e
che puoi revocare in qualsiasi momento.

## Crea una connessione

1. Apri **I miei agenti** dalla barra della home (o *Impostazioni → Agenti
   collegati*).
2. Scegli **Collega un agente**.
3. Dagli un nome, scegli gli **hive e i contesti** a cui può accedere, scegli una
   **capacità** e una **scadenza**.
4. Crea il token. **Copialo (mostrato una sola volta)** o scarica il pacchetto di
   configurazione.
5. Registra il connettore nel tuo agente locale usando il pacchetto — vedi
   [Configurazione del connettore MCP](/it/mcp-connector/).

## Capacità

| Capacità | L'agente può |
|---|---|
| **Lettura** (predefinita) | leggere gli elementi e cercare nel suo ambito |
| **Lettura + bozze** | anche preparare bozze che invii tu |
| **Lettura + pubblicazione** | anche pubblicare post e risposte a tuo nome — prima conferma con te il testo esatto in chat |

## Cosa resta al sicuro

- L'ambito del token è **intersecato con la tua visibilità in tempo reale a ogni
  richiesta**. Esci da un gruppo, e il token perde quell'accesso nello stesso istante.
- **La sola lettura è l'impostazione predefinita.** Pubblicare richiede un token
  Lettura + pubblicazione, e l'agente conferma con te il testo esatto in chat
  prima di pubblicare.
- Tutto ciò che un agente collegato pubblica è attribuito **“tramite te”** e obbedisce
  alla stessa selezione di gruppi di qualsiasi messaggio.
- **Revoca** un token con un clic dalla sua scheda — l'accesso si interrompe
  immediatamente.
- La scheda di ogni token mostra quando è stato usato l'ultima volta e quanto ha
  letto, e gli admin dell'hive possono consentire, limitare alla sola lettura o
  bloccare del tutto gli agenti esterni sul loro hive.

> Il tuo agente gira **fuori** da SweetHive. Tutto ciò che il token può leggere,
> consideralo come presente sulla tua macchina — quindi limita l'ambito con
> precisione: i contesti che gli servono, niente di più.

## Guarda i tuoi agenti al lavoro

La pagina **I miei agenti** elenca ogni token con ambito, capacità, scadenza e un
indicatore **online** in tempo reale (l'agente si è collegato di recente). Da un
contesto puoi anche vedere quali dei tuoi agenti lo coprono in questo momento.


---


# Chatta con il tuo agente

Una volta [collegato](/it/connect-an-agent/) un agente, non devi uscire da SweetHive
per usarlo: l'app **Chat con l'agente** ti offre una conversazione diretta con lui.

## Dove chattare

- Da **I miei agenti** — apri la chat su qualunque agente collegato.
- Da un **contesto** coperto dall'agente — il banner lo mostra collegato, con
  la chat in un popup a un clic.
- Dall'app **Agents Node** sul tuo computer.

È **una sola conversazione per agente**: ovunque la apri, continui lo stesso
filo.

## Come funziona

- Scrivi un messaggio; l'agente conferma subito di averlo preso in carico
  (vedi un indicatore di digitazione mentre lavora) e la risposta viene
  generata **sul tuo computer** dall'Agents Node — il puntino verde indica che
  è collegato.
- L'agente risponde **con la propria voce, solo a te** — una risposta in chat
  non è un post nel feed del contesto.
- Se l'agente ha un token **Lettura + pubblicazione**, può pubblicare post e
  risposte reali nei suoi contesti **a tuo nome**. Ti mostra sempre il testo
  esatto e aspetta il tuo sì in chat prima di pubblicare; la pubblicazione
  rispetta i tuoi gruppi di destinazione.

> Vuoi parlare col tuo **computer** invece che con un agente di contesto?
> Vedi *SweetHive Desktop* nella pagina [Agents Node](/it/agents-node/) —
> stessa chat, modelli locali, raggiungibile da remoto.

## Cose utili da chiedere

- *“Aggiornami su questo contesto da ieri.”*
- *“Quali attività sono ancora aperte nel Progetto A?”*
- *“Prepara un breve aggiornamento per il DevGroup sulla release — lo rivedo io.”*
- *“Quali contesti hanno avuto più attività questa settimana?”*

> La chat è limitata dal token dell'agente: può discutere solo di ciò che il suo
> ambito — intersecato con la **tua** visibilità in tempo reale — gli consente di
> vedere.


---


# SweetHive e l'EU AI Act

> **AI by design. Governance by design. Privacy by design.**

SweetHive è stato progettato fin dalle fondamenta come piattaforma collaborativa
AI-native — non uno strumento di collaborazione tradizionale a cui l'AI è stata
aggiunta in un secondo momento. La sua architettura si allinea naturalmente a
molti principi cardine dell'**AI Act dell'Unione Europea (Regulation (EU)
2024/1689)**: governance, supervisione umana, sicurezza, privacy e accesso
controllato alle informazioni.

La conformità dipende in ultima analisi dagli specifici modelli AI e casi d'uso
che ciascuna organizzazione mette in campo. Ciò che SweetHive offre è una base
tecnica che semplifica in modo significativo la conformità all'AI Act.

## AI delimitata by design

L'AI Act incoraggia le organizzazioni a ridurre al minimo gli accessi non
necessari ai dati e a limitare il potenziale impatto dei sistemi AI. SweetHive
implementa questo principio nel cuore stesso della propria architettura.

Ogni agente AI opera all'interno di un ambito rigorosamente definito:

- solo gli hive, i [contesti](/it/contexts/) e i sotto-contesti esplicitamente concessi;
- solo le informazioni già visibili all'utente che effettua la richiesta;
- solo per le capacità assegnate al suo token.

A ogni richiesta, i permessi effettivi sono l'**intersezione** di:

- i permessi attuali dell'utente;
- l'ambito configurato del token.

Un assistente AI non può quindi **mai accedere a informazioni al di là di ciò
che il suo proprietario può vedere in quel momento**. Se un utente perde
l'accesso a un contesto o a un [gruppo](/it/groups/), ogni agente collegato perde
lo stesso accesso all'istante — senza bisogno di rigenerare il token.

## Principio del privilegio minimo

Ogni connessione a SweetHive segue il **principio del privilegio minimo**, un
principio di sicurezza fondamentale raccomandato dai principali framework europei
di cybersecurity e governance dell'AI. Gli agenti ricevono solo i permessi minimi
necessari al loro compito.

Le capacità disponibili sono:

- **Lettura**
- **Lettura + bozze**
- **Lettura + pubblicazione**

Le organizzazioni decidono quali capacità sono consentite all'interno di ciascun
hive, e gli amministratori possono limitare o disabilitare completamente gli
agenti AI esterni. Vedi [Collega un agente](/it/connect-an-agent/) per sapere
come vengono assegnati capacità e ambito.

## Supervisione umana

Un requisito chiave dell'AI Act è che le persone mantengano il controllo sulle
decisioni e sulle azioni assistite dall'AI. SweetHive è progettato attorno a
questo principio.

Un agente può preparare bozze di messaggi, riassunti o report, ma **la
pubblicazione dei contenuti resta sempre sotto il controllo umano**. Per gli
agenti con capacità **Lettura + pubblicazione**:

- il messaggio esatto viene mostrato all'utente;
- la pubblicazione richiede una conferma esplicita;
- ogni messaggio pubblicato è attribuito come inviato **tramite l'utente**.

Si tratta di un vero flusso di lavoro **human-in-the-loop**, non di pubblicazione
autonoma.

## Privacy by design

La privacy è integrata in tutta la piattaforma:

- token di accesso con ambito limitato;
- revoca immediata dei token;
- valutazione dei permessi in tempo reale;
- connettori di sola lettura per impostazione predefinita;
- archiviazione cifrata dei segreti;
- gestione delle credenziali lato server;
- inferenza AI locale opzionale tramite [SweetHive Agents Node](/it/agents-node/).

Quando si usano modelli locali, i prompt e i dati restano sul computer
dell'utente durante l'inferenza — riducendo in modo significativo i rischi per la
privacy e i trasferimenti di dati.

## Connessioni AI sicure

SweetHive espone le proprie capacità AI tramite connettori sicuri e compatibili
con MCP. Ogni connessione AI utilizza:

- token con ambito limitato;
- scadenza configurabile;
- revoca in qualsiasi momento;
- permessi basati sulle capacità;
- verifica continua dei permessi.

Un token trafugato non espone mai un intero account. La sua portata resta
limitata all'ambito configurato, ai permessi attuali del proprietario e alle
capacità assegnate.

## Trasparenza

Gli utenti sanno sempre:

- quali agenti AI sono collegati;
- a quali contesti possono accedere;
- quali capacità possiedono;
- quando sono stati usati l'ultima volta;
- se sono attualmente online.

Le organizzazioni mantengono piena visibilità e controllo sui sistemi AI
collegati.

## Verificabilità

SweetHive offre funzionalità di accountability a supporto dei requisiti di
governance:

- ultimo utilizzo del token;
- informazioni sulle capacità;
- date di scadenza;
- stato online;
- revoca del token con un clic;
- attribuzione dei post generati dall'AI.

Questi meccanismi aiutano le organizzazioni a costruire flussi di lavoro AI
verificabili e a dimostrare il controllo operativo.

## Sicurezza consapevole del contesto

A differenza dei sistemi di chat tradizionali, in cui un'AI riceve spesso accesso
a grandi raccolte di documenti, SweetHive organizza le informazioni in contesti
gerarchici protetti da gruppi. La visibilità segue sempre la struttura
organizzativa.

Questo limita naturalmente l'esposizione dell'AI e riduce drasticamente le fughe
accidentali di informazioni. Il risultato è un sistema AI che comprende il
contesto organizzativo **senza** richiedere un accesso illimitato alla conoscenza
dell'organizzazione.

## Allineamento con l'EU AI Act

SweetHive è progettato per supportare molti dei principi promossi dall'AI Act
europeo:

| Principio dell'AI Act | Implementazione di SweetHive |
|---|---|
| Minimizzazione dei dati | Contesti con ambito definito e visibilità basata sui gruppi |
| Supervisione umana | Conferma dell'utente prima della pubblicazione da parte dell'AI |
| Privilegio minimo | Token con ambito limitato basati sulle capacità |
| Trasparenza | Agenti collegati e permessi sempre visibili |
| Accountability | Tracciamento dei token e attribuzione dell'AI |
| Privacy by design | Inferenza locale, accesso con ambito limitato, connettori sicuri |
| Security by design | Applicazione dinamica dei permessi e revoca immediata |

## Nota sulla conformità

L'AI Act europeo regola la **messa in servizio e l'uso** dei sistemi AI, più che
le piattaforme di collaborazione in sé. SweetHive fornisce un'architettura che
supporta la governance dell'AI e la conformità normativa, ma gli obblighi
applicabili a una specifica implementazione dipendono in ultima analisi da:

- i modelli AI utilizzati;
- il caso d'uso previsto;
- i processi di governance dell'organizzazione;
- le normative nazionali ed europee applicabili.

Le organizzazioni che implementano l'AI in scenari ad alto rischio dovrebbero
affiancare alle garanzie tecniche di SweetHive adeguate procedure di gestione del
rischio, documentazione, monitoraggio e governance, come richiesto dall'AI Act.

## Costruito per un'AI responsabile

Invece di trattare l'AI come un chatbot isolato con ampio accesso alla conoscenza
organizzativa, SweetHive integra l'AI in un ambiente di collaborazione sicuro in
cui ogni azione è governata dalle stesse regole di visibilità, permessi e
struttura organizzativa di cui gli utenti già si fidano.

Il risultato è un'AI che è:

- **secure by design**
- **private by design**
- **governed by design**
- **human-controlled by design**
- **pronta per l'adozione dell'AI in azienda**


---


# Costruisci un'app

Gli sviluppatori possono costruire app personalizzate per SweetHive — una piccola
vista dati incorporata in un contesto, o un prodotto completo su un proprio URL.
Registri l'app una volta, ricevi le credenziali client e sviluppi con l'**App SDK**.

## Due tipi di app

| | **Incorporata** | **Esterna** |
|---|---|---|
| Dove gira | dentro l'interfaccia del contesto SweetHive (un iframe sandbox) | un proprio URL / dominio, avviata da SweetHive |
| Adatta per | viste dati, moduli, dashboard limitate a un contesto | prodotti completi con la propria interfaccia |

Entrambe si autenticano allo stesso modo: un **token a breve durata con ambito
limitato**, vincolato lato server dall'ambito dell'installazione **e** dalla
visibilità in tempo reale di chi guarda. La tua app non vede mai più di quanto veda la
persona che la usa, e l'accesso è revocato nell'istante in cui lo perde.

## Registra e sviluppa

1. Apri **Sviluppatore → App** dal menu utente.
2. Scegli **Registra app**: dalle un nome, scegli *Incorporata* o *Esterna*, imposta
   URL, icona e capacità.
3. Salva il **client ID e il secret** (mostrati una sola volta).
4. **Scarica la guida di sviluppo dell'SDK (.md)** — il contratto completo:
   l'handshake dell'iframe, l'autenticazione, l'API dati con ambito, i test e la
   pubblicazione. Mettila nel tuo repository e sviluppa con il tuo assistente AI di
   programmazione.
   Disponibile anche qui: [SWEETHIVE_APP_SDK.md](/downloads/SWEETHIVE_APP_SDK.md).
5. Imposta l'app su **Attiva** così gli admin degli hive possono installarla da
   *Contesto → App → Aggiungi app*.

## Come funziona lo standard

- **Le app incorporate** girano in un iframe sandbox e ricevono un token a breve
  durata con ambito limitato tramite un handshake `postMessage` — mai un cookie, così
  funziona anche nelle app mobili. La tua app deve consentire a SweetHive di
  incorniciarla (una CSP `frame-ancestors` che includa le origini delle app mobili —
  la guida SDK fornisce l'header esatto).
- **Le app esterne** si aprono al proprio URL con un avvio firmato; su mobile si
  aprono nel browser in-app nativo.
- Ogni chiamata dati è vincolata lato server dall'ambito dell'installazione
  intersecato con la visibilità in tempo reale di chi guarda — stessa legge, stesso
  audit di qualsiasi attore SweetHive.

## App esterne e hub

Un'app esterna è un prodotto completo su un proprio URL. SweetHive mostra una
tessera di avvio; al click l'app si apre con un **avvio firmato** e crea la
propria sessione — su mobile nel browser in-app nativo.

Le app esterne su un'origine autorizzata possono anche far accedere gli utenti
direttamente con il loro account SweetHive (**SSO**): con una sessione SweetHive
attiva non viene chiesta alcuna password; altrimenti l'utente accede dalla
pagina di login di SweetHive e viene rimandato subito nell'app. Richiedi
l'autorizzazione dell'origine quando registri l'app.

### Hub multi-hive: una shell, tante app

Un prodotto che gestisce più hive da un'unica interfaccia segue lo **standard
hub shell** — una shell riutilizzabile modellata da un manifest:

- La **shell** fornisce, una volta sola per ogni app: l'accesso SSO, il
  selettore hive in alto a destra, la gestione di Team e Inviti, il tema
  chiaro/scuro e la barra laterale comprimibile.
- Il **manifest** (salvato con la registrazione dell'app) dichiara il brand e
  le voci del pannello sinistro. Ogni voce apre una vista integrata nella shell
  oppure — la parte chiave — **una qualunque app SweetHive incorporata resa in
  un frame, senza modifiche**: una sola build serve l'interfaccia del contesto
  e l'hub.
- Cambiare hive ridefinisce l'ambito di tutto: la shell risolve
  l'installazione dell'app nell'hive selezionato e ricarica la vista attiva,
  così ogni schermata segue l'hive — inclusi gli stati vuoti per gli hive in
  cui l'app non è installata.

La guida SDK contiene il contratto completo: lo schema del manifest,
l'handshake delle viste e le insidie da evitare.

## Testa e pubblica

Registra la tua app con un URL localhost, installala in un contesto di prova, e
l'handshake consegna un token reale con ambito sui tuoi dati. Quando è pronta,
impostala su **Attiva** — e disattivala in qualsiasi momento; le installazioni si
fermano immediatamente.


---


# Configurazione del connettore MCP

SweetHive espone la sua Agent Client API come **server MCP**. Qualsiasi agente
compatibile MCP — Claude Desktop, Claude Code, Cowork, agenti di classe OpenClaw e
altri — si collega con un unico **token di accesso con ambito limitato** che emetti da
SweetHive. Un solo server, un solo modello di token, ogni client.

Per prima cosa, [crea un token](/it/connect-an-agent/) in
**I miei agenti → Collega un agente** e scarica il pacchetto di configurazione
(contiene il tuo `endpoint` e il tuo `token`).

## Cosa ottiene il tuo agente

| Strumento | Cosa fa |
|---|---|
| `whoami` | l'ambito effettivo del token, la capacità e il proprietario |
| `contexts` | l'albero di hive/contesti concessi |
| `items` | gli elementi recenti di un contesto e del suo sottoalbero |
| `search` | cerca messaggi, note e file nei contesti concessi |
| `post_message` | pubblica in un contesto (solo token *Lettura + pubblicazione*; la prima pubblicazione chiede la tua conferma) |
| `chat_pull` / `chat_reply` | la [chat dentro SweetHive](/it/chat-with-your-agent/) con te |

## Configura il tuo client

**Connettore locale (stdio)** — funziona già oggi con Claude Desktop, Claude Code e
qualsiasi client MCP stdio. Installa il connettore SweetHive pacchettizzato, poi
aggiungi:

```json
{
  "mcpServers": {
    "sweethive": {
      "command": "node",
      "args": ["/absolute/path/to/sweethive-connector/dist/index.js"],
      "env": {
        "SWEETHIVE_ENDPOINT": "https://sweethive.com/server/web",
        "SWEETHIVE_TOKEN": "shv_..."
      }
    }
  }
}
```

**Remoto (HTTP streamable)** — dove l'endpoint MCP ospitato è abilitato, punta il tuo
client verso di esso con il token come credenziale Bearer:

```json
{
  "mcpServers": {
    "sweethive": {
      "url": "https://sweethive.com/mcp",
      "headers": { "Authorization": "Bearer shv_..." }
    }
  }
}
```

Il tuo agente ora può rispondere a domande come *“cosa è cambiato nel Progetto A
questa settimana?”* o *“prepara un aggiornamento di stato per il DevGroup.”*

## Note

- La **capacità** (Lettura / Lettura + bozze / Lettura + pubblicazione) è fissata sul
  token; la sola lettura è l'impostazione predefinita.
- **Revoca e cambi di gruppo hanno effetto immediato** — non esiste ambito in cache.
  Una configurazione trapelata espone un ambito limitato e revocabile, mai le
  credenziali del tuo account.
- I contenuti in arrivo da un agente esterno sono trattati come non attendibili: non
  possono contenere menzioni privilegiate né invocare gli agenti interni di SweetHive,
  e sono soggetti a rate limit per token.