Aperçu de la configuration
Cette page décrit comment connecter un client compatible MCP au Cryptohopper Market Data MCP. C'est le point d'entrée du site de documentation et contient des liens vers les guides de configuration par client dans la base de connaissances du support.
Point de terminaison
Le Cryptohopper Market Data MCP est servi à : https://mcp-data.cryptohopper.com/mcp
Le transport est HTTP avec Server-Sent Events (SSE). Toutes les requêtes doivent être authentifiées — soit via OAuth 2.0, soit via une clé API bearer-token. Consulte OAuth vs. authentification par clé API pour une comparaison des deux méthodes.
Conditions
Pour connecter un client, tu as besoin :
- D'un compte Cryptohopper.
- De l'une des méthodes d'authentification suivantes :
- OAuth 2.0 — aucune clé requise ; le client gère un flux d'autorisation basé sur navigateur à la première connexion.
- Une clé API Cryptohopper MCP (bearer token) — consulte comment obtenir une clé API Cryptohopper MCP.
- Un client compatible MCP (voir les clients supportés ci-dessous).
Le niveau d'abonnement gratuit Pioneer est suffisant pour se connecter et tester le MCP. Consulte les niveaux d'abonnement pour une comparaison complète.
Clients supportés
Les clients suivants disposent de guides de configuration dédiés :
| Client | Type | Guide de configuration |
|---|---|---|
| Claude Code | Terminal | Configuration Claude Code |
| Claude desktop | Application de bureau | Configuration Claude desktop |
| Cursor | IDE | Configuration Cursor |
| VS Code | IDE (mode agent Copilot) | Configuration VS Code |
| Zed | IDE | Configuration Zed |
| Gemini CLI | Terminal | Configuration Gemini CLI |
| OpenAI Codex | Terminal | Configuration Codex |
Tout autre client compatible MCP (LM Studio, Continue, Cline, et similaires) peut être connecté en utilisant le guide de configuration client générique.
Modèle de connexion
Lorsqu'un client se connecte au point de terminaison MCP :
- Le client effectue une poignée de main initiale via HTTP.
- Le client s'authentifie en utilisant soit OAuth 2.0 (autorisation basée sur navigateur à la première connexion, avec rafraîchissement automatique du token par la suite), soit une clé API bearer-token.
- Le client demande la liste des outils disponibles. Le serveur renvoie les noms d'outils, les descriptions et les schémas d'arguments.
- Le client passe à un flux SSE pour les invocations d'outils en cours.
Tout l'état est conservé côté client. Le serveur ne conserve pas l'état de session entre les requêtes. Consulte Architecture pour plus de détails.
Authentification
Le MCP supporte deux mécanismes d'authentification :
- OAuth 2.0. À la première connexion, le client ouvre un flux d'autorisation basé sur navigateur. Les access tokens ont une durée de vie courte et sont rafraîchis automatiquement. Aucun secret de longue durée n'est stocké dans la config. du client.
- Bearer token (clé API). Une clé de longue durée est passée dans l'en-tête Authorization de chaque requête :
{
"Authorization": "Bearer <your_api_key>"
}
Le client gère l'un ou l'autre flux automatiquement une fois configuré. L'authentification est limitée à un seul compte Cryptohopper. Le quota hebdomadaire et les limites de taux sont appliqués par compte, pas par clé ou par autorisation OAuth. Consulte OAuth vs. authentification par clé API pour des conseils sur lequel choisir, les meilleures pratiques de sécurité des clés API, et les limites de taux expliquées.
Format de configuration
La plupart des clients utilisent un bloc de configuration JSON qui inclut l'URL du serveur et — pour le flux de clé API — le bearer token. Le format exact varie selon le client.
Option A — Clé API (bearer token) :
{
"mcpServers": {
"cryptohopper": {
"type": "http",
"url": "https://mcp-data.cryptohopper.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
Option B — OAuth 2.0 (pas de clé dans la config.) :
{
"mcpServers": {
"cryptohopper": {
"type": "http",
"url": "https://mcp-data.cryptohopper.com/mcp"
}
}
}
Avec l'Option B, le client déclenche le flux d'autorisation OAuth à la première connexion. Les guides par client documentent l'emplacement exact du fichier et tous les champs spécifiques au client.
Vérifier la connexion
Après avoir configuré un client, vérifie la connexion en émettant une requête minimale. Exemple :
Quel est le tick actuel de BTC/USDT sur Binance ?
Une réponse réussie inclut un dernier prix, bid/ask, changement sur 24 heures et volume sur 24 heures. Consulte la référence de l'outil ticker pour le schéma de réponse complet.
Si la réponse n'arrive pas, consulte la référence des erreurs et le dépannage.
Outils exposés
Le MCP expose les catégories d'outils suivantes :
| Catégorie | Outils | Référence |
|---|---|---|
| Ticker | Ticker actuel (get_ticker) | Référence de l'outil Ticker |
| Carnet d'ordres | Instantané du carnet d'ordres (get_orderbook) | Référence de l'outil Carnet d'ordres |
| Chandeliers (OHLCV) | Historique des chandeliers (get_candles) | Référence de l'outil Chandelier |
| Métadonnées | Lister les exchanges (list_exchanges), lister les marchés (list_markets), obtenir le marché (get_market), lister les devises de cotation (list_quote_currencies) | Exchanges supportés |
| Compte | Requête d'utilisation et de quota (get_usage) | Utilisation et limites |
Les outils exacts disponibles dépendent du niveau d'abonnement. Consulte les niveaux d'abonnement.
Comportement spécifique au niveau
Certains comportements diffèrent selon le niveau d'abonnement. Exemples :
- Couverture des exchanges. Le niveau Pioneer est limité à Binance, Coinbase et Kraken. Les niveaux supérieurs exposent des exchanges supplémentaires. Consulte les exchanges supportés.
- Données historiques. Le niveau Pioneer renvoie uniquement des données en temps réel. Explorer, Adventurer et Hero supportent les requêtes de chandeliers historiques, avec différentes limites de rétrospection.
- Facteur de coût pour les données historiques. Sur Explorer et Adventurer, les requêtes de chandeliers historiques sont facturées à 5× (historique court) ou 20× (historique long) par rapport à un appel de base. Sur Hero, toutes les requêtes sont facturées à 1×. Consulte les limites de taux expliquées.
Les tentatives d'interrogation de fonctionnalités en dehors du niveau actuel renvoient une erreur de restriction de niveau. Consulte la référence des erreurs.
Démarrage rapide
Le chemin le plus rapide vers une connexion fonctionnelle :
- Choisis une méthode d'authentification — OAuth 2.0 (recommandé pour les clients interactifs) ou une clé API bearer-token (recommandé pour les scripts et l'automatisation). Pour les clés API, génères-en une dans les paramètres de ton compte Cryptohopper.
- Configure le client de ton choix en utilisant son guide de configuration.
- Émets une requête de test.
Le temps total est généralement inférieur à cinq minutes.