Vai al contenuto
SommarioAssistente IA e server MCP

Per i responsabili

Assistente IA e server MCP

Fai le tue domande in italiano: l’IA (Anthropic, OpenAI o servizio compatibile) scrive la query. Nessun dato dei vogatori inviato. MCP per Claude Desktop.

Dove trovarla
Statistiche › Esplora › Chiedi all’IA; impostazioni in Gestione › Statistiche e IA
Disponibile
dalla versione 2.1 (2026)
Modulo da attivare
Nessuno. L’assistente e il server MCP sono facoltativi e restano disattivati finché non li configuri.

A cosa serve

Ottenere una statistica senza scrivere SQL. Poni la domanda («Quanti giovani sono usciti ogni mese in questa stagione?»), l’IA scrive la query e il grafico, tu controlli il risultato prima di salvarlo. Nulla viene salvato senza di te.

Due usi, indipendenti: l’assistente integrato in RowingBeacon, con la chiave API che preferisci, e il server MCP, che permette a un’app di IA installata sullo stesso computer (Claude Desktop, per esempio) di leggere le statistiche del club.

Tre modi di usarlo

  • Anthropic (Claude): una chiave API creata su console.anthropic.com, con qualche euro di credito prepagato. Un abbonamento Claude Pro non basta.
  • OpenAI (GPT): una chiave API creata su platform.openai.com, con qualche euro di credito prepagato. Un abbonamento ChatGPT non basta.
  • Altro servizio compatibile (Mistral, Ollama…): qualsiasi servizio che segua il formato di OpenAI, compreso un modello installato sul computer del club (Ollama, LM Studio, llama.cpp). Con un modello locale, la domanda non lascia il computer.
  • Senza chiave: l’assistente prepara una richiesta da copiare nella tua IA abituale (Claude, ChatGPT, Le Chat…). Incolli la sua risposta e la query viene eseguita da te.

Configurare e usare l’assistente

  • Apri Gestione › Statistiche e IA, scheda «Assistente IA integrato», e scegli il «Fornitore di IA»: «Anthropic (Claude)», «OpenAI (GPT)» o «Altro servizio compatibile (Mistral, Ollama…)».
  • Incolla la chiave API e clicca su «Salva e verifica»: l’applicazione controlla che il fornitore risponda. Per un server compatibile, indica l’indirizzo del server (https://…, o http://localhost… per un server sul computer), il nome del modello e, se serve, una chiave.
  • In Statistiche › Esplora, scrivi la domanda in «Chiedi all’IA» (al massimo 2.000 caratteri), poi clicca su «Chiedi all’IA». La risposta mostra la spiegazione, le ipotesi, il risultato e il grafico, e carica la query nell’editor.
  • Se la domanda è ambigua, l’IA pone una domanda di precisazione con due scelte o una risposta libera. Se la query fallisce, l’applicazione chiede all’IA di correggerla, fino a due volte, prima di mostrarti l’errore.
  • «Affina» permette di precisare il risultato («solo i giovani, per mese»). Controlla la query e il risultato, poi «Salva» o «Aggiungi al cruscotto».
Assistente IA di RowingBeacon: risposta con numeri a una domanda sulle uscite della società
Assistente IA di RowingBeacon: risposta con numeri a una domanda sulle uscite della società
La risposta dell’assistente: spiegazione, ipotesi, risultato, query caricata nell’editor, grafico, costo stimato e fornitore.
Impostazioni del server MCP di RowingBeacon per collegare un assistente come Claude Desktop
Impostazioni del server MCP di RowingBeacon per collegare un assistente come Claude Desktop
Gestione › Statistiche e IA: l’assistente IA integrato (fornitore, chiave, cosa viene inviato) e la scheda «La tua app di IA (MCP)» con la configurazione da copiare per Claude Desktop.

Impostazioni

  • Dove si trova la chiave: nel portachiavi del sistema del computer (o, se il sistema non ne offre uno, in un file protetto). Mai nel database del club, quindi mai nei backup né negli export. Ogni fornitore conserva la propria chiave: cambiarlo non cancella nessuna chiave. «Elimina la chiave» la cancella dal computer.
  • Modello: a seconda del fornitore vengono proposti più modelli, dal più affidabile al più economico. L’applicazione mostra «Circa … per domanda tipica» (stima in base alla tariffa pubblica, mai per un server compatibile). Il costo viene addebitato sull’account del fornitore.
  • Invia i nomi di barche e percorsi: opzione spuntata per impostazione predefinita. Permette di chiedere «le uscite dell’Albatros». Toglila se non vuoi che questi nomi partano.
  • La tua app di IA (MCP): disattivata per impostazione predefinita. La casella «Consentire alle app di IA di questo computer di leggere le statistiche del club» la attiva.
  • Dati personali (MCP): «Codici al posto dei nomi (consigliato)» o «Nomi dei vogatori visibili».

I fornitori

FornitoreDove va la richiesta, dove si trova la chiave
Anthropic (Claude)Direttamente dal computer a api.anthropic.com, senza altri server in mezzo. Chiave nel portachiavi del sistema.
OpenAI (GPT)Direttamente a api.openai.com. L’applicazione chiede a OpenAI di non conservare la risposta (opzione «store» disattivata). Chiave nel portachiavi del sistema.
Servizio compatibileAll’indirizzo che salvi, e a nessun altro. Indirizzo in https, tranne per un server sul computer (localhost). Indirizzo e chiave facoltativa salvati insieme.

Limiti e precisazioni

  • Cosa viene inviato dall’assistente integrato, a ogni domanda: la tua domanda così come la scrivi; la struttura delle tabelle delle statistiche (nome e descrizione delle colonne, mai il loro contenuto); i tipi di uscita del club, i moduli attivi, l’inizio della stagione e la data di oggi; i nomi delle barche e dei percorsi se l’opzione qui sopra è spuntata; in caso di errore, il messaggio di errore della query, perché l’IA la corregga.
  • Cosa non viene mai inviato dall’assistente integrato: i nomi, le date di nascita, i recapiti e le note dei vogatori; le uscite, i commenti e i risultati dei calcoli (la query viene eseguita sul computer del club e i suoi risultati vi restano); la password amministratore e il resto del database.
  • Attenzione alla domanda: parte così com’è. Se vi scrivi il nome di un vogatore, parte anche quello. L’applicazione se ne accorge e propone «Sostituisci con «un vogatore»» o «Invia comunque». Meglio non mettere mai un nome in una domanda.
  • Senza chiave: la richiesta copiata contiene esattamente gli stessi elementi (domanda, struttura delle tabelle, nomi di barche e percorsi se l’opzione è spuntata). Sei tu a incollarla nell’IA che preferisci.
  • Server su un altro computer: le impostazioni avvisano quando il server non è su questo computer. Riceve allora la struttura delle tabelle e le tue domande, come le riceverebbero Anthropic o OpenAI. Cosa ne fa dipende da lui: leggi le sue condizioni d’uso.
  • Server MCP: l’opzione è una modalità dell’applicazione stessa (RowingBeacon avviato con --mcp, senza finestra). Le impostazioni mostrano la configurazione già pronta da copiare per Claude Desktop, Claude Code, ChatGPT / Codex, Cursor e VS Code, più il comando per un’altra app compatibile MCP. Per Claude Desktop: copia la configurazione, apri Impostazioni › Sviluppatore › Modifica configurazione, incollala, riavvia Claude Desktop, poi chiedi per esempio «Quante uscite ha fatto il club in questa stagione?». Claude Desktop non esiste su Linux: scegli un’altra app.
  • Cosa cambia l’MCP per la riservatezza: a differenza dell’assistente integrato, l’app di IA legge i risultati (i numeri) e li invia al suo fornitore per risponderti: Anthropic per Claude, OpenAI per ChatGPT e Codex, quello che hai scelto in Cursor o VS Code. Nella modalità «Codici al posto dei nomi», i vogatori compaiono con un codice (R-1A2B3C4D): né nome, né data di nascita, né commenti a testo libero. I nomi delle barche e dei percorsi, le date e i numeri, invece, sono leggibili. Nella modalità «Nomi dei vogatori visibili», i nomi lasciano il computer insieme ai risultati: verifica che sia compatibile con l’informativa data ai soci (GDPR). In entrambe le modalità, i recapiti (e-mail, telefono, indirizzo, tessera) non sono mai leggibili.
  • L’MCP non modifica mai il database: legge in sola lettura. Un’app di IA che vuole aggiungere un grafico lo propone: la proposta arriva in Statistiche › Esplora › Proposte, con il nome dell’app, e diventa una query solo dopo il tuo «Accetta». Finché la casella non è spuntata, nessuna app può leggere le statistiche.
  • La scheda indica «Ultima domanda ricevuta» con il nome dell’app, il che permette di verificare che il collegamento funzioni.
  • I limiti di tempo e di righe del profilo di prestazioni valgono anche per l’MCP. Vedi Esplora SQL in sola lettura.

Tutte le funzionalità