Connecter un assistant IA via MCP

Avant de commencer

1. Un compte AlgoVesta. L'essai de 7 jours suffit — vous n'avez pas besoin d'un forfait payant pour tester cela.
2. Un client MCP : Claude sur le web, le bureau ou le mobile, Claude Code, Cursor, ChatGPT sur un forfait payant, Gemini CLI, ou tout autre outil qui parle Model Context Protocol.
3. Une clé. Vous n'avez pas besoin d'un exchange connecté pour commencer : une clé paper exécute l'ensemble complet des outils contre un solde virtuel de 5 000 $, ce qui vous permet de tout configurer et de vous entraîner avant qu'un compte réel ne soit impliqué.

1. Créez votre lien MCP

1. Ouvrez le panneau AlgoVesta et allez à l'onglet MCP Connection
2. Cliquez sur Create key, donnez-lui une étiquette indiquant où elle sera utilisée (par exemple claude-desktop ou cursor-laptop)
3. Choisissez un scope : read pour les questions de portefeuille uniquement, paper pour l'ensemble complet des outils contre le solde virtuel de 5 000 $, ou live pour de vrais ordres
4. Copiez l'adresse qui apparaît. Elle ressemble à ceci :

https://api.algovesta.com/u/avmcp_<your-key>/mcp

2. Ajoutez-le à Claude

1. Dans Claude, ouvrez Settings → Connectors
2. Cliquez sur Add custom connector
3. Donnez-lui un nom (AlgoVesta) et collez votre lien MCP dans le champ URL
4. Enregistrez, puis démarrez une nouvelle conversation — les outils apparaissent dans la liste d'outils de la conversation

Ce connecteur se synchronise entre Claude sur le web, le bureau et le mobile, donc l'ajouter une fois couvre aussi votre téléphone. Si vous préférez ne pas coller d'adresse secrète, AlgoVesta propose aussi un point de terminaison OAuth 2.1 standard à https://api.algovesta.com/mcp avec PKCE (S256) et Dynamic Client Registration — pointez le connecteur vers celui-ci à la place et vous serez dirigé vers un écran de consentement de navigateur normal.

3. Ajoutez-le à Claude Code

Une commande enregistre le serveur via HTTP streamable :

claude mcp add --transport http algovesta https://api.algovesta.com/u/avmcp_<your-key>/mcp

Exécutez ensuite claude mcp list pour confirmer que le serveur est enregistré et accessible.

4. Ajoutez-le à Cursor ou ChatGPT

Cursor lit un fichier de configuration JSON. Ajoutez une entrée à mcp.json :

{"mcpServers":{"algovesta":{"url":"https://api.algovesta.com/u/avmcp_<your-key>/mcp"}}}

Gemini CLI utilise la même entrée, mais nomme le champ httpUrl au lieu de url. Tout le reste est identique.

ChatGPT prend en charge les connecteurs MCP personnalisés sur les forfaits payants, avec le mode développeur activé dans les paramètres. Ajoutez le connecteur là-bas et collez le même lien.

5. Vérifiez la connexion

1. Démarrez une nouvelle conversation dans votre client
2. Demandez : How is my portfolio?
3. L'assistant devrait appeler l'outil get_portfolio_context et répondre avec vos soldes réels et positions ouvertes — sur une clé paper, avec le solde virtuel de 5 000 $

S'il répond de manière générale sans appeler d'outil, le serveur n'est pas connecté : l'assistant parle de trading en général plutôt que de votre compte. Revérifiez le lien et redémarrez le client.

Ce que l'assistant peut faire une fois connecté

Vingt outils sont exposés. Quatorze d'entre eux lisent ou répètent sans rien modifier : get_portfolio_context, get_market_price, get_trade_history, compare_venues, simulate_order, list_open_orders, list_strategies, verify_receipt, replay_channel et compile_policy. Six d'entre eux écrivent : place_order, close_position, modify_position, cancel_order, create_strategy et update_strategy.

Vous ne les appelez pas par leur nom. Demandez en langage courant — « qu'est-ce que je détiens ? », « combien me coûterait 0,1 BTC maintenant ? », « clôture la moitié de ma position ETH » — et l'assistant choisit les outils et les enchaîne. Un stop-loss est exigé sur chaque position qu'il ouvre, et aucun outil n'existe pour en retirer un par la suite. Les schémas complets de chaque outil se trouvent dans la documentation développeur.

401 unauthorized

La clé a été révoquée, supprimée, ou l'adresse est mal saisie. C'est l'échec le plus courant lorsque le lien a été collé à la main ou copié avec un espace en fin de chaîne. Vérifiez que la clé existe toujours dans l'onglet MCP Connection ; si c'est le cas, supprimez-la et créez-en une nouvelle plutôt que d'essayer de réparer la chaîne.

insufficient_scope

L'outil que l'assistant a tenté d'appeler nécessite un scope supérieur à celui que porte la clé. Une clé read ne peut pas appeler place_order, et une clé paper ne peut pas atteindre un compte réel. Les scopes sont hiérarchisés, donc un outil nécessitant paper refuse une clé read. Acceptez la limite ou émettez une nouvelle clé avec le scope dont vous avez réellement besoin — passer à live exige un second facteur.

user_frozen

Le kill switch est actif sur votre compte, ce qui arrête toutes les clés à la fois. C'est délibéré : c'est le frein d'urgence. Dégelez-le dans le panneau lorsque vous voulez reprendre le trading. Si vous vouliez seulement couper un seul client, révoquez plutôt cette seule clé — les autres continuent de fonctionner.

rate_limited

Vous avez dépassé 60 requêtes par minute sur cette clé. Des plafonds plus stricts s'appliquent aux outils coûteux : place_order est limité à 10 par minute et replay_channel à 5 par heure. Attendez et réessayez. Voir cela se répéter signifie généralement qu'un agent boucle plutôt que vous tradez rapidement — il vaut la peine de vérifier ce que fait réellement l'assistant avant d'augmenter le débit.