Produit

Interrogez votre assistant IA sur votre portefeuille

Votre tableau de bord sait ce qu'a fait votre portefeuille. Votre assistant IA sait expliquer, comparer et mettre en tableau. Vous pouvez relier les deux : créez un jeton dans BullBenchmark, collez-le dans Claude Desktop, Cursor ou ChatGPT, et posez vos questions là plutôt que de les lire sur un graphique.

La connexion est en lecture seule par conception. Aucun outil ne change un réglage, aucun n'envoie de fichier, aucun ne passe d'ordre, et l'assistant n'a aucun moyen d'atteindre le compte de quelqu'un d'autre.

Cet article explique ce que la connexion peut voir, ce qu'elle ne peut pas faire, et comment la configurer dans chacun des trois assistants.

Ce qu'est cette connexion

BullBenchmark parle MCP, le Model Context Protocol, une norme ouverte pour fournir à un modèle de langage un jeu d'outils qu'il peut appeler. Notre point d'accès propose six outils, tous en lecture seule, et tous limités au seul compte auquel appartient votre jeton.

Le verdict. Votre rendement face au S&P 500 et au Nasdaq 100 sur la même fenêtre, par année et au total.
Le résumé. Valeur, argent versé, résultat sur les cours, dividendes reçus, coûts, rendement total, devise de référence.
Les positions. Nom, ticker ou ISIN, nombre d'actions, valeur, poids, rendement, résultat de chacune face au S&P 500, plus votre propre groupe et votre étiquette.
Les dividendes. Reçus par mois, attendus sur les douze prochains mois, rendement sur prix de revient, croissance par rapport à l'année précédente.
La performance. Rendement pondéré par le temps face à l'indice sur 1 mois, 3 mois, 6 mois, 1 an, 3 ans et l'historique complet, ainsi que votre drawdown.
Les imports. Les noms, les dates et le nombre de lignes des fichiers que vous avez importés.

Ces six outils forment toute la surface disponible. Les chiffres sont ceux qu'affiche votre tableau de bord, calculés par le même code, donc un chiffre que votre assistant vous lit est le chiffre à l'écran.

À savoir avant de créer un jeton

Le modèle tourne sur votre propre abonnement IA, pas sur le nôtre, la connexion ne coûte donc rien de plus chez BullBenchmark. Le revers, c'est que tout ce sur quoi vous l'interrogez part chez votre propre fournisseur d'IA et y reste sous ses conditions.

Si vous préférez ne pas confier votre portefeuille à un tiers, le tableau de bord fonctionne comme avant, sans jeton. La fonction est désactivée tant que vous ne l'activez pas, et révoquer un jeton sur la page Compte arrête la connexion immédiatement.

Deux limites moins importantes s'appliquent. La connexion demande un abonnement ou un essai actif, comme le tableau de bord, et un appel d'outil renvoie un simple message « abonnement nécessaire » une fois celui-ci terminé.

Il existe aussi une limite de soixante appels par minute et par compte, et de trente par jeton, qu'une conversation normale n'atteint pas mais qu'un script en boucle atteint.

Comment créer un jeton

Ouvrez le tableau de bord et cliquez sur Compte.
Repérez « Connecter un assistant IA ».
Donnez au jeton un nom que vous reconnaîtrez plus tard, par exemple la machine sur laquelle il vivra, puis créez-le.
La valeur commence par « bbm_ » et n'est affichée qu'une seule fois. Nous n'en stockons qu'une empreinte, donc si vous la perdez, vous en créez une nouvelle au lieu de retrouver l'ancienne.

Un compte peut avoir jusqu'à cinq jetons actifs, et chacun peut être révoqué séparément.

Claude Desktop

Ouvrez le fichier de configuration depuis les réglages développeur de Claude Desktop.
Ajoutez le bloc ci-dessous, avec votre propre jeton à la place de l'exemple.
Redémarrez l'application.

Cette configuration nécessite Node.js, parce que mcp-remote est la pièce qui porte pour vous l'en-tête d'autorisation.

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

Claude dans le navigateur fonctionne différemment pour l'instant. Un connecteur ajouté là s'attend à vous identifier par OAuth, ce que ce point d'accès ne propose pas encore.

Un jeton seul ne vous fait donc pas entrer par le navigateur. La prise en charge d'OAuth est prévue, et Claude Desktop fonctionne aujourd'hui.

Cursor

Cursor parle le même protocole et sait porter lui-même l'en-tête, aucun outil supplémentaire n'est donc nécessaire. Placez le bloc ci-dessous dans .cursor/mcp.json à l'intérieur d'un projet, ou dans ~/.cursor/mcp.json pour l'avoir partout.

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

ChatGPT

Dans ChatGPT, les connecteurs que vous ajoutez vous-même se trouvent derrière le mode développeur, et la liste des formules qui y donnent droit a déjà changé plus d'une fois, vérifiez donc ce que propose votre propre compte avant de commencer.

Quand vous pouvez en ajouter un, il lui faut l'adresse du point d'accès et un en-tête d'autorisation qui porte votre jeton.

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

Que demander une fois que cela fonctionne

Les questions utiles sont celles auxquelles il est fastidieux de répondre à la souris. Quatre exemples du type de question pour lequel la connexion est faite.

Lesquelles de mes positions ont battu le S&P 500 sur l'argent qu'elles ont mobilisé, et lesquelles non ?
Groupez mes lignes par secteur et dites-moi ce que chaque groupe a apporté.
Combien de dividendes sont rentrés par mois l'an dernier, et à quoi ressemblent les douze prochains mois avec le nombre d'actions actuel ?
Quelle a été la profondeur de mon pire drawdown, quand s'est-il produit, et combien de temps la récupération a-t-elle pris ?

La connexion ne vous dit pas quoi acheter, et nous non plus. Elle lit ce qu'a fait votre portefeuille, et les conclusions restent les vôtres. Si votre assistant propose malgré tout une recommandation, elle vient du modèle et non de vos données, et le modèle ne sait rien de votre situation.

Une note sur les chiffres

Tout ce que lit l'assistant sort du même moteur que le tableau de bord, les mêmes limites s'appliquent donc. Les rendements sont pondérés par le temps, ce qui veut dire que les versements et les retraits ne comptent jamais comme de la performance, alors que les dividendes reçus, si.

Les prix se rafraîchissent toutes les heures pendant les heures de marché et se figent sur les cours de clôture officiels après la clôture américaine, un chiffre cité en cours de séance est donc aussi récent que le dernier rafraîchissement.

Les séries sont allégées avant de partir. Un graphique de vingt ans compte des milliers de points quotidiens, et la connexion en envoie au plus vingt-quatre par série, assez pour décrire la forme sans remplir le contexte de votre assistant.

En résumé

La connexion est en lecture seule et propose six outils, tous limités au compte auquel appartient votre jeton.
Le modèle tourne sur votre propre abonnement IA, et ce sur quoi vous l'interrogez part chez votre propre fournisseur d'IA.
Un jeton se crée sur la page Compte, n'est affiché qu'une seule fois, et peut y être révoqué à tout moment.
Les chiffres sont les mêmes que sur le tableau de bord, avec les mêmes prix horaires et la même méthode pondérée par le temps.

BullBenchmark lit l'export de transactions de votre courtier et affiche votre rendement à côté du S&P 500 et du Nasdaq 100, alimentés avec les mêmes versements aux mêmes dates, dans votre propre devise. Les deux premières semaines sont gratuites et aucune carte n'est nécessaire.