Panoramica della configurazione
Questa pagina descrive come connettere un client compatibile con MCP al Cryptohopper Market Data MCP. È il punto di ingresso per il sito di documentazione e fornisce link alle guide di configurazione per client specifici nella knowledge base di supporto.
Endpoint
Il Cryptohopper Market Data MCP è servito all'indirizzo: https://mcp-data.cryptohopper.com/mcp
Il trasporto avviene tramite HTTP con Server-Sent Events (SSE). Tutte le richieste devono essere autenticate — sia tramite OAuth 2.0 che tramite una chiave API bearer-token. Vedi Autenticazione OAuth vs. chiave API per un confronto tra entrambi i metodi.
Prerequisiti
Per connettere un client hai bisogno di:
- Un account Cryptohopper.
- Uno dei seguenti metodi di autenticazione:
- OAuth 2.0 — non è richiesta alcuna chiave; il client gestisce un flusso di autorizzazione basato su browser alla prima connessione.
- Una chiave API Cryptohopper MCP (bearer token) — vedi come ottenere una chiave API Cryptohopper MCP.
- Un client compatibile con MCP (vedi i client supportati qui sotto).
Il piano di abbonamento Pioneer gratuito è sufficiente per connettersi e testare l'MCP. Vedi i piani di abbonamento per un confronto completo.
Client supportati
I seguenti client hanno guide di configurazione dedicate:
| Client | Tipo | Guida di configurazione |
|---|---|---|
| Claude Code | Terminale | Configurazione Claude Code |
| Claude desktop | App desktop | Configurazione Claude desktop |
| Cursor | IDE | Configurazione Cursor |
| VS Code | IDE (modalità agente Copilot) | Configurazione VS Code |
| Zed | IDE | Configurazione Zed |
| Gemini CLI | Terminale | Configurazione Gemini CLI |
| OpenAI Codex | Terminale | Configurazione Codex |
Qualsiasi altro client compatibile con MCP (LM Studio, Continue, Cline, e simili) può essere connesso utilizzando la guida di configurazione client generica.
Modello di connessione
Quando un client si connette all'endpoint MCP:
- Il client esegue un handshake iniziale tramite HTTP.
- Il client si autentica utilizzando OAuth 2.0 (autorizzazione basata su browser alla prima connessione, con aggiornamento automatico del token in seguito) o una chiave API bearer-token.
- Il client richiede l'elenco degli strumenti disponibili. Il server restituisce nomi degli strumenti, descrizioni e schemi degli argomenti.
- Il client passa a uno stream SSE per le successive invocazioni degli strumenti.
Tutto lo stato è mantenuto lato client. Il server non mantiene lo stato della sessione tra le richieste. Vedi Architettura per i dettagli.
Autenticazione
L'MCP supporta due meccanismi di autenticazione:
- OAuth 2.0. Alla prima connessione, il client apre un flusso di autorizzazione basato su browser. I token di accesso hanno breve durata e vengono aggiornati automaticamente. Nessun segreto di lunga durata viene memorizzato nella configurazione del client.
- Bearer token (chiave API). Una chiave di lunga durata viene passata nell'header Authorization di ogni richiesta:
{
"Authorization": "Bearer <your_api_key>"
}
Il client gestisce automaticamente entrambi i flussi una volta configurato. L'autenticazione è limitata a un singolo account Cryptohopper. Le quote settimanali e i limiti di frequenza vengono applicati per account, non per chiave o per concessione OAuth. Vedi Autenticazione OAuth vs. chiave API per una guida su quale scegliere, best practice per la sicurezza delle chiavi API, e spiegazione dei limiti di frequenza.
Formato di configurazione
La maggior parte dei client utilizza un blocco di configurazione JSON che include l'URL del server e — per il flusso con chiave API — il bearer token. Il formato esatto varia per ogni client.
Opzione A — Chiave API (bearer token):
{
"mcpServers": {
"cryptohopper": {
"type": "http",
"url": "https://mcp-data.cryptohopper.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
Opzione B — OAuth 2.0 (nessuna chiave nella configurazione):
{
"mcpServers": {
"cryptohopper": {
"type": "http",
"url": "https://mcp-data.cryptohopper.com/mcp"
}
}
}
Con l'Opzione B, il client attiva il flusso di autorizzazione OAuth alla prima connessione. Le guide per client specifici documentano la posizione esatta del file e qualsiasi campo specifico del client.
Verifica della connessione
Dopo aver configurato un client, verifica la connessione emettendo una query minimale. Esempio:
Qual è il ticker BTC/USDT attuale su Binance?
Una risposta riuscita include un ultimo prezzo, bid/ask, variazione a 24 ore e volume a 24 ore. Vedi il riferimento dello strumento ticker per lo schema completo della risposta.
Se la risposta non arriva, vedi riferimento errori e risoluzione dei problemi.
Strumenti esposti
L'MCP espone le seguenti categorie di strumenti:
| Categoria | Strumenti | Riferimento |
|---|---|---|
| Ticker | Ticker corrente (get_ticker) | Riferimento strumento ticker |
| Orderbook | Snapshot orderbook (get_orderbook) | Riferimento strumento orderbook |
| Candele (OHLCV) | Cronologia candele (get_candles) | Riferimento strumento candele |
| Metadata | Elenca exchange (list_exchanges), elenca mercati (list_markets), ottieni mercato (get_market), elenca valute di quotazione (list_quote_currencies) | Exchange supportati |
| Account | Query su utilizzo e quota (get_usage) | Utilizzo e limiti |
Gli strumenti esatti disponibili dipendono dal piano di abbonamento. Vedi i piani di abbonamento.
Comportamento specifico per piano
Alcuni comportamenti differiscono per piano di abbonamento. Esempi:
- Copertura exchange. Il piano Pioneer è limitato a Binance, Coinbase e Kraken. I piani superiori espongono exchange aggiuntivi. Vedi exchange supportati.
- Dati storici. Il piano Pioneer restituisce solo dati in tempo reale. Explorer, Adventurer e Hero supportano query di candele storiche, con diversi limiti di lookback.
- Fattore di costo per i dati storici. Su Explorer e Adventurer, le query di candele storiche sono addebitate a 5× (cronologia breve) o 20× (cronologia lunga) rispetto a una chiamata di base. Su Hero, tutte le query sono addebitate a 1×. Vedi spiegazione dei limiti di frequenza.
I tentativi di interrogare funzionalità al di fuori del piano corrente restituiscono un errore di restrizione del piano. Vedi riferimento errori.
Avvio rapido
Il percorso più veloce verso una connessione funzionante:
- Scegli un metodo di autenticazione — OAuth 2.0 (consigliato per client interattivi) o una chiave API bearer-token (consigliata per script e automazione). Per le chiavi API, generane una nelle impostazioni del tuo account Cryptohopper.
- Configura il client di tua scelta utilizzando la sua guida di configurazione.
- Emetti una query di test.
Il tempo totale è tipicamente inferiore a cinque minuti.