Chiedi al tuo assistente AI del tuo portafoglio

La tua dashboard sa che cosa ha fatto il tuo portafoglio. Il tuo assistente AI sa spiegare le cose, confrontarle e metterle in tabella. Puoi collegarli tra loro: crei un token in BullBenchmark, lo incolli in Claude Desktop, Cursor o ChatGPT, e fai lì le tue domande invece di leggerle su un grafico.

La connessione è in sola lettura per scelta di progettazione. Non c'è nessuno strumento che cambi un'impostazione, nessuno che carichi un file, nessuno che inserisca un ordine e nessun modo perché l'assistente arrivi al conto di qualcun altro.

Questo articolo spiega che cosa la connessione può vedere, che cosa non può fare e come configurarla in ciascuno dei tre assistenti.

Che cos'è la connessione

BullBenchmark parla MCP, il Model Context Protocol, uno standard aperto per dare a un modello linguistico un insieme di strumenti che può chiamare. Il nostro endpoint offre sei strumenti, tutti in sola lettura e tutti limitati all'unico account a cui appartiene il tuo token.

• Il verdetto. Il tuo rendimento rispetto all'S&P 500 e al Nasdaq 100 sulla stessa finestra temporale, anno per anno e in totale.
• Il riepilogo. Valore, denaro versato, risultato di prezzo, dividendi incassati, costi, rendimento totale, valuta di riferimento.
• Le posizioni. Nome, ticker o ISIN, numero di azioni, valore, peso, rendimento, come è andata ciascuna rispetto all'S&P 500, più il tuo gruppo e la tua etichetta.
• I dividendi. Incassati per mese, attesi nei prossimi dodici mesi, rendimento sul prezzo di carico, crescita rispetto all'anno precedente.
• L'andamento. Rendimento ponderato per il tempo rispetto all'indice su 1 mese, 3 mesi, 6 mesi, 1 anno, 3 anni e l'intero storico, e il tuo drawdown.
• I caricamenti. I nomi, le date e il numero di righe dei file che hai importato.

Quei sei strumenti sono tutta la superficie disponibile. I numeri sono gli stessi che mostra la tua dashboard, calcolati dallo stesso codice, quindi una cifra che il tuo assistente legge è la cifra che hai sullo schermo.

Che cosa sapere prima di creare un token

Il modello gira sul tuo abbonamento AI, non sul nostro, quindi la connessione non ti costa nulla in più su BullBenchmark. Il rovescio della medaglia è che qualunque cosa tu chieda viaggia verso il tuo fornitore AI e resta lì alle sue condizioni.

Se preferisci non consegnare il tuo portafoglio a terzi, la dashboard funziona come prima anche senza token. La funzione è spenta finché non la accendi, e revocare un token nella pagina Account interrompe subito la connessione.

Valgono due limiti più piccoli. La connessione richiede un abbonamento o una prova attivi, come la dashboard, e quando questi finiscono la chiamata a uno strumento restituisce un semplice messaggio "subscription needed".

C'è anche un limite di sessanta chiamate al minuto per account e trenta per token, che una conversazione normale non raggiunge, ma che uno script in un ciclo raggiunge.

Come creare un token

1. Apri la dashboard e clicca su Account.
2. Cerca "Collega un assistente AI".
3. Dai al token un nome che riconoscerai in seguito, per esempio la macchina su cui starà, e crealo.
4. Il valore comincia con "bbm_" e viene mostrato una volta sola. Noi ne conserviamo solo un hash, quindi se lo perdi ne crei uno nuovo invece di andare a recuperare quello vecchio.

Un account può avere fino a cinque token attivi, e ognuno si può revocare singolarmente.

Claude Desktop

1. Apri il file di configurazione dalle impostazioni per sviluppatori di Claude Desktop.
2. Aggiungi il blocco qui sotto, con il tuo token al posto del segnaposto.
3. Riavvia l'applicazione.

Questa configurazione richiede Node.js installato, perché mcp-remote è il pezzo che porta al posto tuo l'intestazione di autorizzazione.

{
  "mcpServers": {
    "bullbenchmark": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://bullbenchmark.com/api/mcp",
               "--header", "Authorization: Bearer bbm_your_token_here"]
    }
  }
}

Claude nel browser per ora funziona in modo diverso. Un connettore aggiunto lì si aspetta di farti accedere tramite OAuth, che questo endpoint non offre ancora.

Il solo token quindi non ti fa entrare dal browser. Il supporto per OAuth è in lista, e Claude Desktop funziona già oggi.

Cursor

Cursor parla lo stesso protocollo e sa portare da sé l'intestazione, quindi non serve nessuno strumento aggiuntivo. Metti il blocco qui sotto in .cursor/mcp.json dentro un progetto, oppure in ~/.cursor/mcp.json per averlo disponibile ovunque.

{
  "mcpServers": {
    "bullbenchmark": {
      "url": "https://bullbenchmark.com/api/mcp",
      "headers": { "Authorization": "Bearer bbm_your_token_here" }
    }
  }
}

ChatGPT

In ChatGPT i connettori che aggiungi tu stanno dietro la modalità sviluppatore, e quali piani la includano è cambiato più di una volta, quindi controlla che cosa offre il tuo account prima di cominciare.

Quando puoi aggiungerne uno, gli servono l'indirizzo dell'endpoint e un'intestazione di autorizzazione che porti il tuo token.

https://bullbenchmark.com/api/mcp
Authorization: Bearer bbm_your_token_here

Che cosa chiedere quando funziona

Le domande utili sono quelle a cui è noioso rispondere a forza di clic. Quattro esempi del tipo di domanda per cui è pensata la connessione.

• Quali delle mie posizioni hanno battuto l'S&P 500 sul denaro che hanno tenuto, e quali no?
• Raggruppa per settore quello che possiedo e dimmi quanto ha contribuito ciascun gruppo.
• Quanto dividendo è entrato ogni mese l'anno scorso, e come si presentano i prossimi dodici mesi con le quantità di azioni attuali?
• Quanto è stato profondo il mio drawdown peggiore, quando è successo e quanto ci è voluto per recuperare?

La connessione non ti dice che cosa comprare, e nemmeno noi. Legge che cosa ha fatto il tuo portafoglio, e le conclusioni restano tue. Se il tuo assistente propone comunque una raccomandazione, quella viene dal modello e non dai tuoi dati, e il modello non sa nulla della tua situazione.

Una nota sui numeri

Tutto quello che l'assistente legge esce dallo stesso motore della dashboard, quindi valgono gli stessi limiti. I rendimenti sono ponderati per il tempo, il che significa che versamenti e prelievi non contano mai come risultato, mentre i dividendi incassati sì.

I prezzi si aggiornano ogni ora a mercati aperti e si assestano sui prezzi di chiusura ufficiali dopo la chiusura americana, quindi una cifra citata a metà seduta è fresca quanto l'ultimo aggiornamento.

Le serie vengono alleggerite prima di uscire. Un grafico di vent'anni è fatto di migliaia di punti giornalieri, e la connessione ne manda al massimo ventiquattro per serie, abbastanza per descrivere la forma senza riempire il contesto del tuo assistente.

In breve

• La connessione è in sola lettura e offre sei strumenti, tutti limitati all'account a cui appartiene il tuo token.
• Il modello gira sul tuo abbonamento AI, e quello che chiedi va al tuo fornitore AI.
• Un token si crea nella pagina Account, viene mostrato una volta sola e si può revocare lì in qualsiasi momento.
• I numeri sono gli stessi della dashboard, con gli stessi prezzi orari e lo stesso metodo ponderato per il tempo.

BullBenchmark legge l'esportazione delle operazioni dal tuo broker e mostra il tuo rendimento accanto all'S&P 500 e al Nasdaq 100, alimentati con gli stessi versamenti nelle stesse date, nella tua valuta. Le prime due settimane sono gratuite e non serve alcuna carta.

Da leggere anche: Come verificare se stai battendo l'S&P 500 · Informativa sulla privacy