Autenticazione OAuth vs. chiave API

Questa pagina documenta i due meccanismi di autenticazione supportati dal Cryptohopper Market Data MCP — OAuth 2.0 e autenticazione bearer-token (chiave API) — e spiega quando scegliere ciascuno.

Metodi di autenticazione supportati dall'MCP

Il Cryptohopper Market Data MCP supporta due meccanismi di autenticazione:

1. OAuth 2.0— un flusso di autorizzazione basato su browser. Nessun segreto di lunga durata viene memorizzato nella configurazione del client; il client MCP gestisce lo scambio e l'aggiornamento del token per tuo conto.
2. Bearer token (chiave API)— una chiave di lunga durata, generata tramite l'interfaccia dell'account Cryptohopper, passata nell'header Authorization di ogni richiesta MCP:

Entrambi i meccanismi sono di prima classe e supportati su base continuativa. Puoi passare da uno all'altro in qualsiasi momento aggiornando la configurazione del tuo client. Per il modello completo di account e chiavi, consulta la panoramica dell'account.

Per i passaggi di configurazione specifici del client, consulta:

• Come configurare l'MCP Cryptohopper in Claude Code
• Come configurare l'MCP Cryptohopper in Codex
• Come configurare l'MCP Cryptohopper nell'app desktop Claude

Cos'è OAuth, brevemente

OAuth 2.0 è un protocollo di autorizzazione delegata in cui un utente concede a un'applicazione client un accesso limitato al proprio account, senza condividere le credenziali. Al client viene rilasciato un token che rappresenta la concessione.

I flussi OAuth tipici coinvolgono:

• Un passaggio di autorizzazione guidato dall'utente (l'utente fa clic su "Consenti" in un browser).
• Un reindirizzamento con un codice di autorizzazione.
• Un passaggio di scambio del token che produce un access token (e opzionalmente un refresh token).

I token sono delimitati (la concessione specifica quali permessi vengono concessi), limitati nel tempo e revocabili.

Quando usare OAuth con l'MCP

OAuth è generalmente la scelta migliore quando:

• Stai configurando l'MCP in un client interattivo (Claude Code, Codex, l'app desktop Claude) su un dispositivo in cui puoi completare un accesso basato su browser.
• Preferisci non memorizzare un segreto di lunga durata in un file di configurazione.
• Desideri access token di breve durata che il client aggiorna automaticamente.
• Potresti revocare l'accesso per un dispositivo o client specifico senza influenzare altre integrazioni.

Poiché i token OAuth sono di breve durata e aggiornati automaticamente, OAuth tende a essere l'opzione di minor manutenzione per l'uso quotidiano su macchine personali.

Quando usare una chiave API con l'MCP

Una chiave API bearer-token è generalmente la scelta migliore quando:

• L'integrazione è machine-to-machine: script, job CI, agenti o qualsiasi automazione non presidiata in cui un accesso basato su browser non è pratico.
• Vuoi emettere più chiavi per la segmentazione all'interno di un singolo account (ad es., una per script o ambiente).
• La semplicità di configurazione è più importante della rotazione del token: un singolo copia-incolla della chiave nella configurazione del client è sufficiente.
• Il target di distribuzione non può completare facilmente un flusso OAuth interattivo (server headless, container, ecc.).

Confronto

Criterio	Chiave API (bearer token)	OAuth 2.0
Complessità di configurazione	Bassa — incolla la chiave nella configurazione	Flusso di autorizzazione basato su browser
Attore tipico	Script, CI, agenti, automazione non presidiata	Client interattivi su un dispositivo personale
Durata del token	Di lunga durata fino alla revoca	Access token di breve durata, aggiornati automaticamente
Segreto memorizzato nella configurazione del client	Sì (la chiave)	No
Revoca	Per chiave, immediata	Per concessione, immediata
Utente nel ciclo per l'emissione	No — l'utente genera la chiave direttamente	Sì — passaggio di autorizzazione richiesto
Adatto a	Uso headless / automatizzato	Uso interattivo / personale

Usare entrambi nello stesso account

Un singolo account Cryptohopper può usare l'autenticazione OAuth e bearer-token contemporaneamente. Ad esempio, potresti usare OAuth in Claude Code sul tuo laptop mentre esegui un agente programmato in CI che si autentica con una chiave API di lunga durata. I due meccanismi vengono emessi, ruotati e revocati indipendentemente.

Prodotti Cryptohopper correlati

Altri prodotti Cryptohopper potrebbero usare meccanismi di autenticazione diversi. L'API di Trading REST di Cryptohopper usa un proprio schema di credenziali, separato dall'autenticazione MCP. Consulta Combina MCP + API di Trading Cryptohopper per agenti end-to-end per vedere come vengono utilizzati insieme.

Un singolo account Cryptohopper può contenere credenziali MCP (concessioni OAuth e/o chiavi bearer-token) insieme alle credenziali dell'API di Trading. Tutte vengono gestite indipendentemente.