Connecter ScanETF à votre assistant IA

Ce guide vous fait brancher vos portefeuilles ETF sur ChatGPT, Claude, Mistral, Perplexity, Grok ou Cursor. Comptez une à deux minutes. Aucune donnée bancaire n'est en jeu : le serveur ne connaît que ce que vous avez enregistré sur ScanETF.

Vous pouvez aussi copier ce guide (bouton 📋 en haut de la page) et le coller à votre assistant : il vous guidera pas à pas.

L'adresse à coller

La même pour tous les assistants :

https://scanetf.com/mcp

Elle doit commencer par https://. Sans ce préfixe, votre client tente une connexion en http:// et elle est refusée.

Faut-il une clé ?

Dans la plupart des cas, non. ScanETF implémente OAuth 2.1 avec enregistrement dynamique : votre assistant se déclare tout seul, vous renvoie sur ScanETF, vous vous connectez à votre compte et vous cliquez sur Autoriser. C'est le chemin de claude.ai, Claude Desktop, Claude Code, ChatGPT, Cursor et Gemini CLI.

Une clé n'est nécessaire que pour un client qui ne sait pas faire OAuth. Elle se génère sur https://scanetf.com/mon-espace/assistant-ia, bouton Configuration.

Claude (claude.ai ou Claude Desktop)

Ouvrez la page des connecteurs de Claude : claude.ai/settings/connectors.
Cliquez sur Ajouter un connecteur personnalisé (Add custom connector).
Nommez-le ScanETF, collez https://scanetf.com/mcp, puis validez.
Cliquez sur Se connecter. ScanETF affiche un écran d'autorisation détaillant ce que Claude pourra faire : cliquez sur Autoriser.
Posez une première question : « Liste mes portefeuilles ScanETF et analyse le principal. »

Sur une offre Claude gratuite, le nombre de connecteurs personnalisés est limité. Sur les offres Team et Enterprise, seul un propriétaire peut ajouter le connecteur depuis les paramètres de l'organisation ; les autres membres n'ont ensuite qu'à cliquer sur Se connecter.

Claude Code (terminal)

Lancez :

claude mcp add --transport http --scope user scanetf https://scanetf.com/mcp

Ouvrez Claude Code, tapez /mcp, sélectionnez scanetf et lancez l'authentification. Votre navigateur s'ouvre sur l'écran d'autorisation ScanETF : cliquez sur Autoriser.
De retour dans le terminal, /mcp affiche scanetf comme connecté.
Posez une première question : « Liste mes portefeuilles ScanETF et analyse le principal. »

ChatGPT

Le mode développeur, nécessaire pour ajouter un connecteur personnalisé, dépend de votre offre ChatGPT, de votre région et de votre espace de travail. S'il n'apparaît pas dans vos réglages, c'est qu'il n'est pas encore proposé sur votre compte.

Ouvrez Paramètres → Applications et connecteurs dans ChatGPT.
Ouvrez Paramètres avancés et activez le mode développeur. ChatGPT affiche un avertissement : il porte sur la possibilité d'ajouter des connecteurs non vérifiés en général.
Revenez dans Applications et connecteurs, puis cliquez sur Créer. Ce bouton n'apparaît qu'une fois le mode développeur activé.
Nommez-le ScanETF, collez https://scanetf.com/mcp, puis validez.
Cliquez sur Se connecter et identifiez-vous avec votre compte ScanETF, puis cliquez sur Autoriser.
Ouvrez une nouvelle conversation et activez ScanETF dans le sélecteur d'outils du composeur. Un connecteur créé mais non coché ne sera jamais appelé — c'est la cause la plus fréquente d'un « je n'ai pas accès à vos portefeuilles ».
Posez une première question : « Liste mes portefeuilles ScanETF et analyse le principal. »

Sur un espace de travail Business, Team ou Enterprise, l'ajout d'un connecteur personnalisé peut être bloqué par la politique de l'espace, et l'autorisation échoue alors sans que rien ne soit en cause côté ScanETF. Utilisez votre compte personnel, ou demandez à l'administrateur d'autoriser le connecteur.

Grok

Ouvrez grok.com/connectors.
Cliquez sur New Connector, puis choisissez Custom.
Collez https://scanetf.com/mcp comme URL du serveur MCP, puis validez.
ScanETF affiche l'écran d'autorisation : cliquez sur Autoriser.
Posez une première question : « Liste mes portefeuilles ScanETF et analyse le principal. »

Perplexity (offres payantes uniquement)

Ouvrez Paramètres → Connecteurs dans Perplexity.
En haut à droite, cliquez sur Custom connector, puis Ajouter un connecteur MCP.
Nommez-le ScanETF, collez https://scanetf.com/mcp dans le champ MCP server URL, cochez la case d'avertissement sur les connecteurs personnalisés, puis validez. Laissez la section Avancé fermée.
Le connecteur apparaît dans votre liste — filtrez sur la catégorie Personnalisé s'il n'y est pas. Ouvrez-le et cliquez sur Ajouter le connecteur.
Cliquez sur Autoriser sur l'écran ScanETF. Un onglet confirme que l'authentification a réussi : vous pouvez le fermer.
Posez une première question : « Liste mes portefeuilles ScanETF et analyse le principal. »

Mistral (chat.mistral.ai)

ScanETF n'est pas référencé dans le marketplace de connecteurs de Mistral : il faut passer par un connecteur personnalisé.

Ouvrez chat.mistral.ai/connections.
Choisissez d'ajouter un connecteur personnalisé (custom connector).
Nommez-le ScanETF et collez https://scanetf.com/mcp, puis validez.
Cliquez sur Autoriser sur l'écran ScanETF.
Posez une première question : « Liste mes portefeuilles ScanETF et analyse le principal. »

Cursor

L'URL doit commencer par https://. Aucun identifiant client n'est à renseigner : laissez ces champs vides.

Ouvrez Settings → MCP, puis New MCP Server. Vous pouvez aussi éditer directement ~/.cursor/mcp.json.

Collez :

{ "mcpServers": { "scanetf": { "url": "https://scanetf.com/mcp" } } }

Cursor ouvre votre navigateur sur l'écran d'autorisation ScanETF : cliquez sur Autoriser.
Le serveur apparaît comme connecté dans l'onglet MCP.
Posez une première question : « Liste mes portefeuilles ScanETF et analyse le principal. »

Un client qui ne fait pas OAuth

Générez une clé sur https://scanetf.com/mon-espace/assistant-ia (bouton Configuration), puis déclarez l'adresse avec un en-tête d'autorisation :

claude mcp add --transport http scanetf https://scanetf.com/mcp \
  --header "Authorization: Bearer sk-scanetf-mcp-VOTRE_CLE"

La clé n'est affichée qu'une fois : seule son empreinte est conservée. Si vous la perdez, générez-en une nouvelle et révoquez l'ancienne.

Si la connexion échoue

Le préfixe manque dans l'URL. Elle doit commencer par https:// et se terminer par /mcp. Une adresse erronée peut laisser l'authentification aboutir avant d'échouer au premier appel.

Vous utilisez un VPN. Certains VPN déclenchent une vérification de sécurité qui fait échouer la connexion. Désactivez-le le temps de brancher le connecteur, puis réactivez-le.

Le connecteur est branché mais aucun outil n'apparaît. Fermez puis rouvrez votre assistant. Sur ChatGPT, vérifiez surtout que ScanETF est coché dans le sélecteur d'outils de la conversation.

« Je n'ai pas accès à vos portefeuilles. » Vérifiez que vous avez au moins un portefeuille enregistré sur https://scanetf.com/mon-espace/portefeuilles. Le serveur ne renvoie que vos propres portefeuilles, et une liste vide ressemble à une panne de connexion.

Un client local ne charge plus rien. Certains clients abandonnent la construction de leur catalogue d'outils si un serveur déclaré est injoignable — y compris un serveur sans rapport avec ScanETF. Retirez les entrées mortes de votre configuration.

Rien n'apparaît dans votre tableau de bord. Seuls les appels authentifiés sont comptés : une erreur d'authentification laisse la page vide, ce qui est en soi un diagnostic.

Ça ne marche toujours pas. Écrivez-moi à pl.danieau@gmail.com en précisant l'assistant utilisé et le message affiché. Ces deux éléments suffisent le plus souvent à identifier la cause.

Couper l'accès

Supprimez le connecteur ScanETF dans votre assistant : il cesse immédiatement d'accéder à vos données. Rien n'est modifié dans vos portefeuilles. Si vous utilisez une clé plutôt qu'OAuth, révoquez-la sur https://scanetf.com/mon-espace/assistant-ia.

Ce que votre assistant peut faire

Contrairement à un connecteur en lecture seule, ScanETF autorise aussi l'écriture : votre assistant peut créer et modifier vos portefeuilles, à votre demande et après confirmation. Il n'accède qu'à vos propres données, et ne peut passer aucun ordre de bourse ni accéder à un compte bancaire — ScanETF n'y est pas relié.

Lecture et analyse

Outil	Ce qu’il fait
`list_portfolios`	Vos portefeuilles, leur enveloppe fiscale et leur nombre de lignes.
`get_portfolio`	Chaque ligne avec ISIN, poids, montant, frais et éligibilité PEA.
`search_etfs`	Le catalogue ScanETF filtré par PEA, zone, indice, frais, émetteur…
`get_etf`	Frais, encours, réplication, devise, disponibilité chez les courtiers.
`get_etf_composition`	Secteurs, pays, continents et lignes détenues, des plus lourdes aux plus petites.
`analyze_portfolio`	TER pondéré, éligibilité PEA, dividendes, exposition consolidée et contribution de chaque ETF.

Écriture

Votre assistant demande confirmation avant toute modification.

Outil	Ce qu’il fait
`create_portfolio`	Crée un portefeuille et sa composition à partir d’une allocation proposée.
`update_portfolio`	Informations (nom, enveloppe, courtier, étiquette) et/ou composition.
`duplicate_portfolio`	Copie un portefeuille pour tester une variante sans toucher à l’original.
`delete_portfolio`	Suppression définitive, protégée par la saisie du nom exact.

Analyse avancée

Ces outils sont disponibles sur tous les plans, comme les précédents : ce qui limite un compte gratuit, c'est son nombre d'appels, pas la liste des outils.

Outil	Ce qu’il fait
`get_portfolio_positions`	Ce que vous détenez vraiment, et les lignes en doublon entre ETF.
`backtest_portfolio`	Performance, volatilité, Sharpe, perte maximale, sur la fenêtre de votre choix.
`get_portfolio_correlation`	Quelles lignes bougent ensemble et n’apportent pas de diversification.
`compare`	Plusieurs portefeuilles et/ou ETF côte à côte sur la même période.
`optimize_portfolio`	Frais, PEA, distribution, chevauchement, rééquilibrage sectoriel et géographique.

Quelques questions pour démarrer

« Liste mes portefeuilles ScanETF et analyse le principal. »
« Où est-ce que je paie trop de frais ? Chiffre l'économie annuelle. »
« Est-ce que mes ETF font double emploi ? »
« Crée-moi un portefeuille PEA équilibré Monde / Europe et explique tes choix. »
« Passe mon MSCI World à 70 % dans ce portefeuille et rééquilibre le reste. »

Règles à l'intention de l'assistant

Si vous êtes un modèle connecté à ce serveur, suivez ces règles.

Commencez toujours par list_portfolios. Les autres outils attendent un portfolio_id qui vient de là. N'inventez jamais d'identifiant.
N'inventez jamais un ISIN. Utilisez ceux renvoyés par les outils, ou ceux que l'utilisateur fournit. Un ISIN inconnu du catalogue est rejeté.
Faites confirmer toute modification avant de l'appliquer, et décrivez précisément ce qui va changer. Une suppression est définitive et emporte les transactions et le plan DCA ; elle exige le nom exact du portefeuille.
Ne réécrivez pas un portefeuille auquel l'utilisateur tient. Utilisez duplicate_portfolio et travaillez sur la copie.
Choisissez un seul mode de saisie par portefeuille. Chaque ligne porte soit poids_pct (en %, total 100, tolérance 0,05), soit parts (nombre de parts, valorisées au dernier cours) — jamais les deux, et le même mode pour toutes les lignes. get_portfolio indique le mode en place dans mode_saisie.
Citez toujours la période effective d'un backtest. La fenêtre par défaut est d'un an, et un historique court gonfle mécaniquement le rendement annualisé. Une ligne récente tronque la fenêtre demandée : tronquee_par_historique le signale et ligne_limitante nomme la ligne en cause.
Vérifiez l'éligibilité PEA avant de recommander un remplacement. Un ETF moins cher peut faire perdre l'éligibilité de l'enveloppe : optimize_portfolio renvoie impact_projete.pea_projete_pct pour cela.
Les pourcentages sont des nombres, pas des chaînes : 0.214 signifie 0,214 %. Les montants sont en euros.
Ne modifiez pas la composition d'un portefeuille suivi en DCA : c'est refusé, et le message d'erreur explique la marche à suivre.

Limites

Quota : 30 appels d'outils au total en compte gratuit, illimité en ScanETF Pro. Les échanges de protocole (connexion, liste des outils) ne sont pas décomptés.
Garde-fou anti-abus, indépendant du quota : 200 appels par jour en compte gratuit, 2 000 en ScanETF Pro.
Le serveur ne renvoie que vos propres portefeuilles.
Pour un accès programmatique depuis vos propres outils, voir l'API REST : https://scanetf.com/api/v1/guide

Un problème ?

Écrivez-moi à pl.danieau@gmail.com. Précisez l'assistant que vous utilisez et le message affiché : c'est ce qui permet de débloquer une configuration le plus vite.