Documentation · Connecteurs MCP
Brancher ton agent IA
Tu pilotes déjà PunkMarket depuis l'app. Tu peux aussi connecter ton propre agent (Claude, ChatGPT, Gemini) à ton compte : il interroge le marché, lit ton portefeuille et passe des ordres — en langage naturel.
C'est quoi MCP ?
MCP (Model Context Protocol) est un standard ouvert qui permet à une IA d'utiliser des outils externes de façon fiable. Au lieu d'« halluciner » une réponse, l'agent appelle un vrai outil et récupère de vraies données.
PunkMarket expose un serveur MCP à l'adresse https://mcp.punkmarket.trade/mcp. Il publie des outils : consulter ton solde, chercher des actions, analyser un titre, passer un ordre, suivre ton portefeuille.
C'est quoi un connecteur ?
Un connecteur, c'est la configuration qui relie ton agent au serveur MCP de PunkMarket. Une fois branché, ton agent voit les outils PunkMarket et peut les utiliser dans la conversation.
Chaque agent se configure un peu différemment (fichier de config, action, ligne de commande), mais le principe est toujours le même : une URL de serveur + un token d'authentification.
Comment ça marche, en 3 étapes
- 01
Génère ton token MCP.
Depuis ton compte → Accès MCP. C'est un token JWT qui autorise ton agent à agir en ton nom.
- 02
Ajoute le serveur PunkMarket à ton agent.
Suis le guide de ton agent ci-dessous : tu colles l'URL du serveur et ton token.
- 03
Parle à ton agent.
« Combien ai-je sur mon compte ? », « Achète pour 200 € de Tesla. » — il exécute.
Deux façons de fournir ton token
Selon l'agent, le token se transmet de deux manières équivalentes :
1 · En-tête Authorization (mcp-remote)
--header "Authorization:Bearer <TON_TOKEN>"
2 · URL avec le token en paramètre
https://mcp.punkmarket.trade/mcp?token=<TON_TOKEN>
Pratique pour les clients qui n'acceptent qu'une URL de serveur MCP.
Sécurité du token
Ton token MCP passe des ordres réels en ton nom. Traite-le comme un mot de passe : ne le partage pas, ne le commite pas dans un dépôt public.
Il a une date d'expiration et reste révocable : régénère-le depuis Accès MCP et l'ancien cesse de fonctionner.
Guides par agent
Choisis ton agent pour le pas-à-pas complet :
Claude
MCPpar Anthropic
MCP natif. Notre intégration de référence, via la config de Claude Desktop.
Voir le guideChatGPT
MCPpar OpenAI
Via un GPT personnalisé (Action + schéma OpenAPI) ou un connecteur MCP.
Voir le guideGemini
MCPpar Google
Via Gemini CLI et son fichier de configuration MCP (settings.json).
Voir le guideUn autre agent (Cursor, n8n, LangChain, Mistral, ton agent maison) ? Tant qu'il parle MCP, OpenAPI ou function-calling, il se branche avec la même URL et le même token.