Come configurare il server MCP di Capital.com

Il server MCP di Capital.com consente al tuo assistente AI di parlare direttamente con il tuo conto di trading. Dati di mercato, verifica delle posizioni, anteprime delle operazioni: tutto in un linguaggio semplice, senza dover uscire dal tuo strumento di intelligenza artificiale.

Cosa ti occorre

• Un account su Capital.com
• La tua chiave API di Capital.com
• La tua password API personalizzata
• 2FA abilitato 

Nota: puoi gestire quanto sopra dalle impostazioni del tuo account.

I dispositivi mobili non sono supportati al momento.

Cos'è il server MCP di Capital.com?

Il server MCP è un software che viene eseguito in background sul tuo computer. Funge da ponte sicuro tra il tuo assistente IA e il tuo conto su Capital.com.

Una volta connesso, il tuo assistente AI potrà:

• Cercare i mercati disponibili tra forex, azioni, materie prime e indici
• Visualizzare le posizioni aperte, gli ordini in esecuzione e il saldo del conto
• Recuperare i prezzi storici e altri dati di mercato
• Visualizzare in anteprima ed eseguire le operazioni dopo la tua conferma, che viene sempre richiesta

Sei sempre tu il responsabile finale di qualsiasi decisione di trading presa utilizzando il server MCP. Controlla sempre attentamente le anteprime delle operazioni prima di confermarle.

Cose da controllare prima di iniziare 

Verifica di aver installato tutto ciò di cui hai bisogno. Se tua la risposta a una delle domande seguenti è “No”, dovrai seguire il link indicato prima di proseguire. 

Claude Desktop: guida rapida all'installazione

Se non hai bisogno di istruzioni dettagliate, ecco la versione breve per Claude Chat su Desktop.

1. Ottieni le tue credenziali API 

• Accedi alla pagina delle impostazioni del tuo account su capital.com e recupera la tua password API.

2. Scarica MCP da Github

• L'indirizzo è: https://github.com/capital-com-sv/capital-mcp 

3. Apri il pacchetto MCPB

• Fai doppio clic sul pacchetto per lanciarlo, oppure trascina semplicemente il file nella finestra di Claude Desktop.

4. Inserisci le tue credenziali API

• Claude Desktop richiederà i dettagli della tua API. Inseriscili e seleziona “Installa”. Non dimenticare di abilitare MCP.

5. Riavvia Claude

• Chiudi completamente l'applicazione e riaprila; poi prova il link chiedendo: "Elenca i miei account".

Guida completa all'installazione 

Passo 1. Crea le tue credenziali API

Dal tuo account Capital.com:

1. Abilita 2FA se non lo hai già fatto. Impostazioni → Autenticazione a Due Fattori.
2. Genera una nuova chiave API. Vai su Impostazioni → Integrazioni API → Genera chiave API.
3. Assegna un'etichetta alla tua chiave, ad esempio: MCP Server.
4. Imposta la tua Password API.

Leggi questo prima di scrivere: Stai creando una nuova password specifica per l'accesso all'API. Non è collegata alla password di accesso di Capital.com. Ti consigliamo di scegliere una password che puoi ricordare facilmente e di scriverla da qualche parte. Non riutilizzare la tua password di login qui. Confondere la password di accesso con la password API è un errore comune di configurazione.

5. Inserisci il tuo codice 2FA e clicca su Genera.
6. Copia la tua chiave API e conferma nuovamente la tua password API. Entrambe vengono visualizzate una volta sola. Ti serviranno più avanti. Quando questa schermata viene chiusa, scompariranno.

Mantienile private. Non incollarle nelle finestre di chat, non condividerle con altre persone e non salvarle in un documento condiviso. Chiunque disponga di queste password può accedere al tuo conto di trading tramite l'API.

Passo 2. Scarica l'MCP

Il server MCP di Capital.com è open source e si trova in un repository GitHub pubblico. Prima che il tuo strumento di intelligenza artificiale possa utilizzarlo, devi avere una copia del codice sul tuo computer.

Scarica il codice MCP sul tuo computer locale da https://github.com/capital-com-sv/capital-mcp 

Passo 3. Collega il tuo MCP allo strumento di intelligenza artificiale

Ogni strumento di intelligenza artificiale si collega all'MCP in modo leggermente diverso. Abbiamo spiegato come effettuare la connessione a Claude Desktop qui; per le connessioni ad altre piattaforme leggi qui. 

Per Claude Desktop, fai doppio clic sul file mcpb per avviarlo, oppure trascina semplicemente il file nella finestra di Claude Desktop.

Sull'applicazione Claude Desktop verrà visualizzata la finestra pop-up riportata di seguito. Installa l'MCP e attivalo.

Passo 4. Inserisci le tue credenziali e configura il tuo ambiente

Inserisci le credenziali ottenute al passo 1 nei campi di configurazione

Passo 5. Riavvia il tuo strumento di intelligenza artificiale e verifica la connessione

Riavvia il tuo strumento di IA e prova i prompt riportati di seguito uno alla volta, per verificare che la connessione funzioni correttamente

Accedi al mio account Capital.com

Elenca i miei account

Cerca i mercati bitcoin

Come effettuare un'operazione di trading

Ogni operazione effettuata tramite il server MCP segue 3 passaggi obbligatori. Sono imposti dal server: non è possibile saltarli.

1. Anteprima

Chiedi al tuo assistente AI di mostrarti un'anteprima dell'operazione:

Anteprima acquisto di 1,5 ARGENTO con stop a 24,50

L'assistente restituisce una proposta di trading completa e un preview_id univoco. Leggi attentamente tutti i dettagli prima di procedere.

2. Revisione

Prima di dare la conferma, verifica quanto segue:

• Lo strumento è corretto? (I codici distinguono tra maiuscole e minuscole: ARGENTO non argento)
• La dimensione della posizione è quella che volevi?
• I livelli di stop e di limite sono corretti?
• Il rischio ti sembra adeguato alle dimensioni del tuo conto?

Se noti qualcosa che non è corretto, fermati. Richiedi una nuova anteprima con i parametri corretti.

3. Conferma

Inviala solo se sei soddisfatto dell'anteprima:

Esegui ordine con preview_id abc123 confirm=true

Non è possibile effettuare un'operazione senza un preview_id valido. Ogni ID può essere utilizzato una sola volta e scade al termine dell'esecuzione.

Prima di passare a un conto reale

Completa prima questa checklist:

• Tutti e 3 i test del passo 5 hanno restituito dati validi
• Hai visualizzato in anteprima e confermato con successo almeno un'operazione in modalità demo
• Sai cosa significa ogni campo nell'anteprima dell'operazione
• Hai modificato CAP_ENV in live e CAP_ALLOW_TRADING in true intenzionalmente
• Hai letto i Termini e condizioni e le Condizioni di trading elettronico di Capital.com

Per limitare i mercati su cui il server può effettuare operazioni di trading, aggiungi i codici degli strumenti a CAP_ALLOWED_EPICS (ad esempio: ARGENTO,ORO,EURUSD). Lascia il campo vuoto per consentire l'accesso a tutti i mercati disponibili sul tuo conto.

Cosa posso chiedere al mio assistente AI?

Controlla il tuo account

Accedi al mio account

Elenca i miei account

Verifica lo stato della mia connessione a Capital.com

Ricerca i mercati

Ricerca i mercati del bitcoin

Mostrami i dettagli di mercato dell'EURUSD

Visualizza l'andamento storico dei prezzi dell'ORO nell'arco di un'ora

Rivedi il portafoglio

Mostra le mie posizioni aperte

Elenca i miei ordini in corso

Verifica l'esposizione del mio portafoglio

Effettua un'operazione di trading (prima in modalità demo)

Anteprima acquisto di 1,5 ARGENTO con stop a 24,50

Crea una proposta di trading per ORO con un rischio dell'1%

Esegui posizione con preview_id abc-123 confirm=true

Chiudi posizione DEAL_ID confirm=true

Risoluzione dei problemi

Esegui prima il controllo dello stato di salute. Chiedi al tuo assistente AI: Verifica lo stato della mia connessione a Capital.com. La risposta di solito ti dirà qual è il problema.

Sei ancora bloccato? Invia una richiesta di assistenza indicando: quale assistente AI stai utilizzando, il tuo sistema operativo e il testo completo del messaggio di errore.

FAQ

Occorre un abbonamento a pagamento per l'assistente AI? Alcuni assistenti basati sull'intelligenza artificiale richiedono un abbonamento a pagamento per poter utilizzare le funzionalità MCP. Claude Desktop, ad esempio, richiede un piano a pagamento per abilitare i connettori MCP. Il server MCP di Capital.com è gratuito.

Ho bisogno di un conto di trading reale? No. Il server funziona con un account demo ed è proprio da lì che ti consigliamo di iniziare.

La mia password di accesso a Capital.com è la stessa di CAP_API_PASSWORD? No. Sono due password distinte. CAP_API_PASSWORD è una nuova password che crei appositamente al momento della generazione della chiave API. Se inserisci qui la tua password di accesso, l'autenticazione non andrà a buon fine.

L'intelligenza artificiale può effettuare un'operazione di trading senza che io lo sappia? No. Ogni operazione richiede una fase di anteprima seguita da un messaggio di conferma separato contenente confirm=true. Il server non può eseguire un'operazione senza entrambi. L'ID di anteprima è monouso e scade immediatamente dopo l'esecuzione.

Cos'è CAP_ALLOW_TRADING e devo modificarlo? È un interruttore di sicurezza. Se impostato su false, il server può mostrarti i dati di mercato e le informazioni sul conto, ma non può effettuare alcuna operazione di trading. Modificalo in true solo dopo aver testato tutto in modalità demo e quando sarai pronto a fare trading con denaro reale.

A cosa serve CAP_ALLOWED_EPICS? Limita gli strumenti che il server può negoziare. Lascialo vuoto per consentire l'accesso a tutti i mercati sul tuo conto. Aggiungi un elenco separato da virgole (ad esempio: ARGENTO,ORO,EURUSD) per limitarlo.

Nel mio assistente AI vedo meno di 36 strumenti. Qual è il problema? Chiedi al tuo assistente AI: Verifica lo stato della mia connessione a Capital.com. Le cause più comuni sono un errore di formattazione nel file di configurazione JSON oppure il fatto che il percorso di Python punti al sistema anziché alla cartella venv.

I miei dati di trading sono al sicuro? Il server viene eseguito localmente sul tuo computer. Le tue credenziali vengono memorizzate esclusivamente nel tuo file di configurazione locale e non vengono mai trasmesse a terzi. Tutte le comunicazioni con Capital.com utilizzano la crittografia HTTPS.

Posso utilizzarlo su due computer? Sì. Ripeti il passo 2 sul secondo computer utilizzando le stesse credenziali API del passo 1.

Posso effettuare la connessione a più di un account Capital.com? Il server si connette a un solo account alla volta. Per scambiare, aggiorna i 4 valori CAP_ nel tuo file di configurazione e riavvia il tuo assistente AI.

Dichiarazione di non responsabilità — Utilizzo dell'API pubblica con strumenti di terze parti

Integrazione di terze parti

Questa pagina descrive come i clienti possono integrare l'API pubblica con software, strumenti o integrazioni di terze parti, compresi quelli basati sull'intelligenza artificiale o sui modelli di linguaggio di grandi dimensioni (LLM). Qualsiasi software, strumento o integrazione di terze parti è indipendente e non fa parte dei servizi offerti da Capital.com. Capital.com non controlla, sviluppa, avalla né si assume alcuna responsabilità in merito a software di terze parti, alle loro funzionalità, ai risultati da essi prodotti o a qualsiasi conseguenza derivante dal loro utilizzo. Qualsiasi utilizzo di strumenti o integrazioni di terze parti in relazione all' API pubblica avviene interamente a tuo rischio e pericolo. È tua responsabilità prendere visione dei termini, delle informative sulla privacy e delle modalità di trattamento dei dati di qualsiasi strumento di terze parti che decidi di utilizzare.

Utilizzo dell'API Pubblica

Il tuo utilizzo dell' API pubblica avviene interamente a tua discrezione e a tuo rischio. Capital.com rende disponibile l'API Pubblica per scopi informativi e di trading, ma non raccomanda, approva o incoraggia alcun uso, integrazione o strategia di trading particolare. Sei tu l'unico responsabile di come accedi e utilizzi l'API, inclusi i parametri di eventuali ordini inviati, la configurazione di eventuali strumenti o sistemi connessi e l'interpretazione di eventuali dati ricevuti. Capital.com declina ogni responsabilità per eventuali perdite o conseguenze indesiderate derivanti dal tuo utilizzo dell'API, sia tramite accesso diretto, sia tramite strumenti di terze parti. La disponibilità, le funzionalità e le specifiche dell'API possono essere modificate, soggette a limitazioni di velocità, sospese o interrotte in qualsiasi momento senza preavviso. Il tuo utilizzo dell'API pubblica è soggetto ai Termini e condizioni e alle Condizioni di negoziazione elettronica di Capital.com, che ti invitiamo a leggere con attenzione.

Servizio di sola esecuzione e nessuna consulenza in materia di investimenti

Capital.com fornisce i suoi servizi su base di sola esecuzione. Il trading di strumenti finanziari comporta un rischio significativo di incorrere in perdite di denaro. Nessuna informazione contenuta in questa pagina, nell'API pubblica o in qualsiasi software o integrazione di terze parti costituisce una consulenza in materia di investimenti, una consiglio personale o un invito all'acquisto o alla vendita di strumenti finanziari. Ciò include qualsiasi risultato, segnale, suggerimento o analisi generato da strumenti basati sull'intelligenza artificiale, sui modelli di linguaggio di grandi dimensioni (LLM) o da altri strumenti automatizzati. Tutte le decisioni di trading, comprese eventuali attività automatizzate o algoritmiche, sono prese a tuo rischio e rimangono tua esclusiva responsabilità.

Rischi del trading automatizzato e algoritmico

L'utilizzo dell'API pubblica in combinazione con strumenti di trading automatizzato o algoritmico comporta rischi aggiuntivi, tra cui: esecuzione rapida degli ordini senza revisione o intervento umano; errori di sistema, malfunzionamenti del software o problemi di connettività; esecuzione a prezzi sostanzialmente diversi da quelli previsti e ordini involontari o errati derivanti da strumenti o parametri configurati in modo errato. Capital.com non si assume alcuna responsabilità per eventuali perdite derivanti da tali rischi o dall'interazione tra i propri sistemi e gli strumenti di terze parti. Le prestazioni passate e qualsiasi output generato da strumenti automatizzati non sono indicativi dei risultati futuri.

Usi vietati

L'API pubblica, e qualsiasi strumento ad essa collegato, non deve essere finalizzato a manipolare la piattaforma, sfruttare le quotazioni o la latenza, commettere abusi di mercato o ottenere vantaggi sleali. Capital.com si riserva il diritto di limitare, sospendere o interrompere l'accesso all'API e/o al tuo account qualora ritenga ragionevolmente che si sia verificato o possa verificarsi un uso improprio. I clienti non devono consentire a terzi di esercitare un controllo discrezionale sul proprio conto.

Le tue responsabilità

Sei responsabile di garantire che l'utilizzo della piattaforma, dell'API pubblica e di eventuali strumenti o integrazioni di terze parti sia conforme ai Termini e condizioni di Capital.com e a tutte le leggi e i regolamenti applicabili nella tua giurisdizione. Devi valutare attentamente se gli strumenti di trading automatizzati sono appropriati per le tue circostanze, esperienza e tolleranza al rischio prima di utilizzarli. Capital.com raccomanda vivamente di testare accuratamente qualsiasi strumento automatizzato o integrazione utilizzando un conto demo prima di collegarli a un ambiente di trading reale.