Collegare un assistente AI via MCP

Prima di iniziare

1. Un conto AlgoVesta. La prova di 7 giorni è sufficiente — non serve un piano a pagamento per testarlo.
2. Un client MCP: Claude su web, desktop o mobile, Claude Code, Cursor, ChatGPT su un piano a pagamento, Gemini CLI, o qualsiasi altro strumento che parli Model Context Protocol.
3. Una chiave. Non serve un exchange collegato per iniziare: una chiave paper esegue l'intero set di strumenti contro un saldo virtuale di 5.000 $, così puoi configurare tutto e fare pratica prima che sia coinvolto un conto reale.

1. Crea il tuo link MCP

1. Apri il pannello AlgoVesta e vai alla scheda MCP Connection
2. Clicca su Create key, dai una etichetta che indichi dove verrà usata (ad esempio claude-desktop o cursor-laptop)
3. Scegli uno scope: read solo per domande sul portafoglio, paper per l'intero set di strumenti contro il saldo virtuale di 5.000 $, o live per ordini reali
4. Copia l'indirizzo che appare. Ha questo aspetto:

https://api.algovesta.com/u/avmcp_<your-key>/mcp

2. Aggiungilo a Claude

1. In Claude, apri Settings → Connectors
2. Clicca su Add custom connector
3. Dagli un nome (AlgoVesta) e incolla il tuo link MCP nel campo URL
4. Salva, poi avvia una nuova conversazione — gli strumenti appaiono nell'elenco strumenti della conversazione

Questo connettore si sincronizza tra Claude su web, desktop e mobile, quindi aggiungerlo una volta copre anche il telefono. Se preferisci non incollare un indirizzo segreto, AlgoVesta offre anche un endpoint OAuth 2.1 standard su https://api.algovesta.com/mcp con PKCE (S256) e Dynamic Client Registration — punta invece il connettore lì e verrai indirizzato a una normale schermata di consenso del browser.

3. Aggiungilo a Claude Code

Un comando registra il server tramite HTTP streamable:

claude mcp add --transport http algovesta https://api.algovesta.com/u/avmcp_<your-key>/mcp

Esegui poi claude mcp list per confermare che il server sia registrato e raggiungibile.

4. Aggiungilo a Cursor o ChatGPT

Cursor legge un file di configurazione JSON. Aggiungi una voce a mcp.json:

{"mcpServers":{"algovesta":{"url":"https://api.algovesta.com/u/avmcp_<your-key>/mcp"}}}

Gemini CLI usa la stessa voce, ma chiama il campo httpUrl invece di url. Tutto il resto è identico.

ChatGPT supporta connettori MCP personalizzati sui piani a pagamento, con la modalità sviluppatore attivata nelle impostazioni. Aggiungi il connettore lì e incolla lo stesso link.

5. Verifica la connessione

1. Avvia una nuova conversazione nel tuo client
2. Chiedi: How is my portfolio?
3. L'assistente dovrebbe chiamare lo strumento get_portfolio_context e rispondere con i tuoi saldi reali e le posizioni aperte — su una chiave paper, con il saldo virtuale di 5.000 $

Se risponde in modo generico senza chiamare uno strumento, il server non è collegato: l'assistente sta parlando di trading in generale anziché del tuo conto. Ricontrolla il link e riavvia il client.

Cosa può fare l'assistente una volta collegato

Vengono esposti venti strumenti. Quattordici di essi leggono o provano senza modificare nulla: get_portfolio_context, get_market_price, get_trade_history, compare_venues, simulate_order, list_open_orders, list_strategies, verify_receipt, replay_channel e compile_policy. Sei di essi scrivono: place_order, close_position, modify_position, cancel_order, create_strategy e update_strategy.

Non li chiami per nome. Chiedi in linguaggio semplice — "cosa detengo?", "quanto mi costerebbe 0,1 BTC adesso?", "chiudi metà della mia posizione ETH" — e l'assistente sceglie gli strumenti e li concatena. Uno stop-loss è richiesto su ogni posizione che apre, e non esiste alcuno strumento per rimuoverne uno in seguito. Gli schemi completi di ogni strumento sono nella documentazione per sviluppatori.

401 unauthorized

La chiave è stata revocata, eliminata, o l'indirizzo è digitato male. È l'errore più comune quando il link è stato incollato a mano o copiato con uno spazio finale. Controlla se la chiave esiste ancora nella scheda MCP Connection; se sì, eliminala e creane una nuova invece di provare a riparare la stringa.

insufficient_scope

Lo strumento che l'assistente ha provato a chiamare richiede uno scope più alto di quello della chiave. Una chiave read non può chiamare place_order, e una chiave paper non può raggiungere un conto reale. Gli scope sono gerarchici, quindi uno strumento che richiede paper rifiuta una chiave read. Accetta il limite oppure emetti una nuova chiave con lo scope di cui hai effettivamente bisogno — passare a live richiede un secondo fattore.

user_frozen

Il kill switch è attivo sul tuo conto, il che ferma tutte le chiavi in una volta. È intenzionale: è il freno d'emergenza. Sblocca nel pannello quando vuoi riprendere il trading. Se volevi solo tagliare fuori un client, revoca invece quella singola chiave — le altre continuano a funzionare.

rate_limited

Hai superato le 60 richieste al minuto su quella chiave. Limiti più stretti si applicano agli strumenti costosi: place_order è limitato a 10 al minuto e replay_channel a 5 all'ora. Attendi e riprova. Vedere questo ripetutamente di solito significa che un agente è in loop, non che stai facendo trading rapidamente — vale la pena controllare cosa sta facendo realmente l'assistente prima di aumentare la frequenza delle richieste.