Cos'è MCP
Il Model Context Protocol (MCP) è un protocollo aperto che definisce come i modelli AI comunicano con strumenti esterni e fonti di dati. Il Cryptohopper Market Data MCP è un'implementazione di questo protocollo che espone dati di mercato crypto — registri degli ordini, ticker e candele — a qualsiasi client compatibile con MCP.
Questa pagina è la spiegazione di riferimento. Per la versione estesa del blog, vedi What is MCP, and why does it matter for crypto traders?
Definizione
MCP è un'interfaccia standardizzata attraverso la quale un modello linguistico può:
- Scoprire gli strumenti disponibili su un server (rilevamento strumenti).
- Invocare uno strumento con argomenti strutturati (invocazione strumento).
- Ricevere risultati strutturati (risposta strumento).
MCP è stato introdotto da Anthropic alla fine del 2024 ed è ora supportato dai principali client AI tra cui Claude Code, Claude desktop, Cursor, VS Code, Zed, Gemini CLI e OpenAI Codex.
Primitive
Un server MCP può esporre tre tipi di primitive:
| Primitiva | Descrizione | Esempio nel Cryptohopper MCP |
|---|---|---|
| Tool | Una funzione che il modello può chiamare. Definita da nome, descrizione e schema degli argomenti. | get_ticker, get_orderbook, get_candles |
| Resource | Un dato nominato che il modello può leggere. | Attualmente non esposto |
| Prompt | Un template di prompt riutilizzabile suggerito dal server. | Attualmente non utilizzato dal Cryptohopper MCP |
Il Cryptohopper Market Data MCP utilizza solo tool. Vedi Architettura per la superficie completa.
Trasporto
Il Cryptohopper MCP utilizza HTTP con Server-Sent Events (SSE) come trasporto:
- Handshake iniziale e autenticazione: HTTP
- Invocazioni tool in corso: flusso SSE
- Codifica richiesta: JSON
- Autenticazione: token bearer nell'header
Authorization - Endpoint:
https://mcp-data.cryptohopper.com/mcp
Modello di interazione
Un'interazione tipica procede come segue:
- Il client si connette al server e si autentica.
- Il client interroga il server per gli strumenti disponibili.
- Il server restituisce un elenco di definizioni di tool, ciascuno includendo uno schema JSON per i suoi argomenti.
- Il client presenta le definizioni degli strumenti al modello linguistico.
- Il modello decide se chiamare uno strumento in base al messaggio dell'utente.
- Se il modello sceglie uno strumento, il client lo invoca sul server e riceve il risultato.
- Il risultato viene inserito nel contesto del modello e viene generata una risposta.
Nota: Il modello non mantiene uno stato persistente tra le chiamate agli strumenti. Ogni chiamata è indipendente.
Confronto con REST
MCP non sostituisce le API REST. È ottimizzato per casi d'uso diversi:
| Asse | API REST | MCP |
|---|---|---|
| Chiamante | Codice applicativo | Modello AI / agente |
| Rilevamento tool | Manuale (lo sviluppatore legge i documenti) | Automatico (il modello legge lo schema) |
| Forma della richiesta | URL + parametri | Chiamata tool strutturata |
| Ideale per | ETL, bot, dashboard | Analisi interattiva, agenti |
| Profilo latenza | Bassa, fissa | Bassa per chiamata + ragionamento del modello |
| Determinismo | Alto | Dipende dal modello |
Vedi MCP vs. REST API for crypto market data per il confronto esteso.
Capacità esposte dal Cryptohopper MCP
Il Cryptohopper Market Data MCP espone strumenti per:
- Recuperare i dati ticker correnti per una coppia specifica su un exchange specifico.
- Recuperare uno snapshot del registro degli ordini per una coppia specifica su un exchange specifico.
- Recuperare dati candela (OHLCV) a timeframe configurabili.
- Elencare gli exchange supportati.
- Elencare le coppie supportate su un dato exchange.
- Restituire l'utilizzo corrente e la quota per l'account autenticato.
- Gli strumenti disponibili dipendono dal livello di abbonamento attivo. Vedi livelli di abbonamento.
Limitazioni
Il Cryptohopper Market Data MCP è in sola lettura. Non:
- Esegue trade.
- Gestisce ordini o posizioni.
- Modifica lo stato dell'account.
- Persiste dati tra le chiamate.
L'esecuzione dei trade è disponibile attraverso la Cryptohopper REST Trading API. Vedi Combine MCP + Cryptohopper Trading API for end-to-end agents. Un MCP dedicato all'esecuzione dei trade è in roadmap.
Proprietà di sicurezza
- Tutte le connessioni avvengono tramite TLS.
- L'autenticazione è tramite token bearer per account.
- I token sono revocabili dall'interfaccia dell'account Cryptohopper.
- Il server non persiste lo stato della sessione.
Vedi best practice per la sicurezza delle chiavi API.
Specifica
MCP è una specifica aperta mantenuta da Anthropic. La specifica completa è disponibile su modelcontextprotocol.io.