Open WebUI, dispositivi e MCP

Questa funzione è disponibile per le aziende abilitate al nuovo servizio chat. Apri Chat AI nel portale, scegli il plafond e usa Open WebUI incorporato, oppure Apri separatamente. L’indirizzo del workspace rimane stabile: https://<UUID-azienda>.chat.llm.netter.io. L’ingresso generale chat.llm.netter.io passa dalla selezione nel portale.

Desktop e telefono

Open WebUI Desktop è il client per Windows, macOS e Linux. Configura l’indirizzo HTTPS del workspace e usa l’accesso Netter/Keycloak. Su Android e iOS, Conduit va configurato in modalità Open WebUI, con lo stesso indirizzo. Usa il login SSO nel browser integrato oppure il token personale generato nel portale, secondo il metodo del client. Non usare la modalità connessione diretta a OpenAI o a un altro provider.

In Chat AI → Collega un dispositivo, assegna un nome riconoscibile e genera un token per ciascun dispositivo. Copialo quando viene mostrato: il segreto non è recuperabile in seguito. I token durano 30 giorni; revocali individualmente dallo stesso elenco se cambi dispositivo. Il token personale non è la chiave di inferenza ni_owui_…: quella rimane cifrata sul server e non va inserita nelle app.

L’identità è distinta per utente e azienda. Il plafond scelto è parte del profilo di connessione e la prima inferenza lo lega alla conversazione. Per usare un altro plafond, apri una nuova conversazione con il profilo corrispondente. Revocare la chiave Open WebUI interrompe la relativa integrazione; per riattivarla serve una rotazione esplicita dal portale. Non viene creata una sostituta da sola.

Conservazione e sicurezza

Chat completate e relativi archivi cifrati scadono 90 giorni dopo l’ultimo salvataggio completato. La sola lettura non rinnova il termine. Il servizio parte con cronologia vuota: le chat precedenti non sono importate e mantengono la scadenza originaria di 30 giorni. Le bozze senza risposta completata possono scadere dopo 24 ore.

PostgreSQL è autorevole; ogni ora Netter archivia su S3 le chat modificate, conservando l’ultima copia verificata e la precedente entro la stessa scadenza. L’indisponibilità temporanea di S3 non impedisce l’uso della cronologia attiva. Gli allegati sono cifrati; il testo dei documenti attraversa il filtro PII se attivo nella policy. Immagini e audio non vengono bonificati dal filtro testuale.

Il browser ricorda l’accesso per un massimo di 30 giorni anche dopo la chiusura. Il logout termina la sessione browser condivisa fra portale e chat. I token personali dei dispositivi/MCP si revocano separatamente dal relativo elenco. Attivare OTP è facoltativo: dopo l’attivazione è richiesto nei nuovi accessi sia con password sia con Google. Il passaggio da una sessione Netter valida alla chat non richiede un ulteriore OTP.

Le app e gli strumenti di sviluppo possono conservare copie locali, esportazioni e cache. Le rispettive impostazioni regolano tali copie: il termine server di 90 giorni non le cancella dal dispositivo. La chat non acquisisce memoria automatica da altre conversazioni.

MCP per strumenti di sviluppo

Crea un token personale dedicato allo strumento e imposta NETTER_CHAT_TOKEN nell’ambiente che avvia il client. Sostituisci <UUID-azienda> negli esempi; non salvare il token in file di progetto o repository. Il server MCP è:

https://<UUID-azienda>.chat.llm.netter.io/mcp

Per Codex, nel file di configurazione utente:

[mcp_servers.netter_chat]
url = "https://<UUID-azienda>.chat.llm.netter.io/mcp"
bearer_token_env_var = "NETTER_CHAT_TOKEN"

Per Claude Code, nella configurazione MCP:

{
  "mcpServers": {
    "netter_chat": {
      "type": "http",
      "url": "https://<UUID-azienda>.chat.llm.netter.io/mcp",
      "headers": {"Authorization": "Bearer ${NETTER_CHAT_TOKEN}"}
    }
  }
}

Per OpenCode:

{
  "mcp": {
    "netter_chat": {
      "type": "remote",
      "url": "https://<UUID-azienda>.chat.llm.netter.io/mcp",
      "oauth": false,
      "headers": {"Authorization": "Bearer {env:NETTER_CHAT_TOKEN}"},
      "enabled": true
    }
  }
}

Sono esposti soltanto chat_list, chat_search, chat_get, chat_create, chat_append e chat_continue, entro i permessi del token. Ricerca e lettura sono limitate alle chat dell’utente nell’azienda corrente. Le modifiche richiedono la revisione letta e un UUID idempotente; un conflitto richiede di rileggere la chat. Non ripetere una generazione incerta con un nuovo identificativo: potrebbe creare un secondo consumo. Una risposta già pagata non viene rigenerata durante un retry con lo stesso identificativo.

Codex, Claude Code e OpenCode mantengono le proprie sessioni locali: MCP permette di consultarne o trasferirne esplicitamente il contesto nella chat Netter e di continuarla, senza sincronizzare automaticamente tutti i loro transcript.

CLI

Dal repository, con Python 3 e le due variabili d’ambiente configurate:

export NETTER_CHAT_URL='https://<UUID-azienda>.chat.llm.netter.io'
python3 scripts/netter-chat.py list
python3 scripts/netter-chat.py search 'parola da cercare'
python3 scripts/netter-chat.py get <UUID-chat>
python3 scripts/netter-chat.py open <UUID-chat>
python3 scripts/netter-chat.py continue <UUID-chat> 'Continua da qui'
python3 scripts/netter-chat.py append <UUID-chat> - < contesto.txt

La CLI conserva soltanto hash e identificativi delle operazioni pendenti nella cache locale, per riutilizzare l’identificativo dopo un errore di rete. I token non compaiono negli URL. I contenuti letti vengono stampati sul terminale: gestisci la sua cronologia secondo le tue esigenze.

Documentazione dei client MCP: Codex, Claude Code, OpenCode.