Come configurare il server AI MCP di Capital.com

Il server MCP di Capital.com ti permette di collegare un assistente AI, come Claude Code, Codex, Claude Desktop, Cursor o Windsurf, al tuo account di trading. Una volta configurato, potrai utilizzare il linguaggio naturale per analizzare i mercati, controllare le informazioni del tuo account, esaminare le posizioni aperte e gli ordini in corso; inoltre potrai visualizzare in anteprima le operazioni ed eseguirle tramite il tuo assistente AI.

Questa guida ti spiega chiaramente ogni passaggio, dalla creazione delle credenziali API e dall'installazione del server, fino al collegamento dell'assistente AI che hai scelto e alla verifica e alla conferma di ogni operazione prima dell'esecuzione. Non devi essere uno sviluppatore per seguirla, ma dovresti comunque avere familiarità nel seguire istruzioni tecniche. Ti consigliamo di iniziare con la modalità demo prima di passare a un conto reale.

Cos'è il server MCP di Capital.com?

Il server MCP (Model Context Protocol) di Capital.com è uno strumento gratuito e open source che consente di collegare un assistente AI al tuo conto di trading utilizzando le credenziali API di Capital.com e l'autenticazione a due fattori (2FA). Funge da ponte tra il tuo account e l'intelligenza artificiale, consentendo all'assistente di accedere ai dati di mercato e dell'account e di rispondere alle tue istruzioni in tempo reale.

Una volta integrato, il tuo assistente AI potrà:

• Ricercare i mercati disponibili (come il forex, le azioni, le materie prime e gli indici).
• Mostrarti le posizioni aperte, gli ordini in esecuzione e le informazioni sull'account.
• Recuperare i dati storici sui prezzi e sul sentiment dei clienti.
• Visualizzare in anteprima ed eseguire le operazioni, previa conferma esplicita di voler effettuare l'operazione.

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.

Quali assistenti AI posso utilizzare?

Questa guida illustra la configurazione di Claude Code, Codex, Claude Desktop, Cursor e Windsurf.

Se non sai da dove cominciare, Claude Code potrebbe essere un'ottima scelta, a patto che tu abbia dimestichezza con Terminal. Claude Desktop potrebbe essere più adatto alle tue esigenze se preferisci modificare un file di configurazione.

Passo 1. Crea le tue credenziali API

Per prima cosa, genera le credenziali API dal tuo account Capital.com. Ci vorranno circa due minuti.

1. Accedi al tuo account su Capital.com.
2. Abilita l'autenticazione a due fattori (2FA).
3. Vai su Impostazioni → Integrazioni API → Genera nuova chiave.
4. Assegna un'etichetta alla tua chiave, ad esempio: MCP Server.
5. Crea una password API personalizzata. È una password diversa da quella che utilizzi normalmente per accedere a Capital.com.
6. Inserisci il tuo codice 2FA e genera la chiave.
7. Copia immediatamente la chiave API. Non verrà mostrata di nuovo.

Nei passaggi successivi ti serviranno i seguenti dati:

*Esercitati su un conto demo prima di fare trading dal vivo.

Importante: queste credenziali forniscono accesso al tuo conto di trading. Mantienile riservate. Non condividerle, non incollarle nelle finestre di chat e non salvarle in documenti pubblici. Chiunque abbia accesso a questi dati potrebbe accedere al tuo account tramite l'API.

Passo 2. Installa il server MCP di Capital.com

È un'installazione una tantum. Hai due opzioni: l'opzione A è quella consigliata per la maggior parte degli utenti.

Opzione A. Installazione rapida (consigliata)

Il server MCP include un file di installazione che consente a Claude Desktop di gestire l'installazione al posto tuo, senza bisogno di utilizzare il terminale o di modificare i file di configurazione.

Prima di iniziare assicurati che uv sia installato (ad esempio, tramite il comando "brew install uv" su Mac) e che tu abbia installato Node.js per il comando "pack".

1. Nel terminale, clona il repository e crea il pacchetto:

git clone https://github.com/capital-com-sv/capital-mcp

cd capital-mcp

npx @anthropic-ai/mcpb pack . capital-mcp.mcpb

2. Apri il file capital-mcp.mcpb facendo doppio clic su di esso oppure trascinalo su Claude Desktop.
3. Claude Desktop ti chiederà di inserire le tue credenziali API. Inseriscile, quindi clicca su "Installa".
4. Riavvia Claude Desktop e verifica la connessione chiedendo: "Quali strumenti di Capital.com sono disponibili?"

Opzione B. Installazione manuale

Utilizza questa opzione se preferisci non utilizzare il pacchetto o se ti stai collegando a Codex, Cursor o Windsurf.

Terminal (Mac)

1. Scarica i file del server

cd ~/Desktop

git clone https://github.com/capital-com-sv/capital-mcp

cd capital-mcp

2. Crea un ambiente Python isolato e installa le dipendenze

python3 -m venv venv

source venv/bin/activate

pip install -e ".[dev]"

3. Trova il tuo percorso Python

Avrai bisogno di questo nel passaggio successivo:

which python

Dovrebbe restituire un percorso file simile a:

/Users/you/Desktop/capital-mcp/venv/bin/python

Copia e salva questo percorso. Lo incollerai nelle impostazioni del tuo assistente AI nel Passo 3.

Suggerimento: su Mac, puoi trascinare un file dal Finder nella finestra Terminal per visualizzarne il percorso completo.

4. Verifica che il server si avvii correttamente

python -m capital_mcp.server

Se non compaiono errori, l'installazione è completata. Se noti un errore, risolvilo subito: di solito è più facile individuare la causa dei messaggi di errore in questa fase rispetto a quando compaiono nell'interfaccia di un assistente AI.

Prompt dei comandi (Windows)

1. Scarica i file del server

cd %USERPROFILE%\Desktop

git clone  https://github.com/capital-com-sv/capital-mcp

cd capital.com-public-api-mcp

Questo scarica il repository sul tuo Desktop e apre la cartella del progetto.

2. Crea un ambiente virtuale e installa le dipendenze

py -m venv venv

venv\Scripts\activate.bat

pip install -e ".[dev]"

In questo modo si crea un ambiente virtuale che consente di mantenere le dipendenze del progetto separate dal resto del sistema. Attivandolo i pacchetti vengono installati in quell'ambiente.

3. Trova il percorso Python

Ne avrai bisogno nel passaggio successivo:

where python

Dovresti vedere qualcosa di questo tipo:

C:\Users\you\Desktop\capital.com-public-api-mcp\venv\Scripts\python.exe

Copia e salva questo percorso. Lo incollerai nelle impostazioni del tuo assistente AI nel Passo 3.

4. Verifica che il server si avvii correttamente

python -m capital_mcp.server

Se non compaiono errori, l'installazione è completata. Se vedi un errore, risolvilo ora prima di continuare.

Passo 3. Collega il tuo assistente AI

Tutti e tre gli assistenti AI hanno bisogno delle stesse informazioni di base. Prima di iniziare, recupera le informazioni seguenti:

Configurazione Claude Code 

Nel tuo terminale, esegui:

claude mcp add capital-com -- /path/to/capital-mcp/venv/bin/python -m capital_mcp.server

Sostituisci /path/to/capital-mcp/venv/bin/python con il percorso Python che hai copiato al passo 2.

Per verificare la connessione, chiedi a Claude: "Quali strumenti di Capital.com sono disponibili?". Dovresti vedere un elenco di 36 strumenti.

Configurazione Codex 

Vai su Codex → Impostazioni → Server MCP → Aggiungi server e riempi i campi qui sotto.

Comando

Incolla il percorso venv Python, ad esempio:

/Users/you/Desktop/capital.com-public-api-mcp/venv/bin/python

Argomenti

Aggiungili come due voci separate, non unirli:

1. -m
2. capital_mcp.server

Variabili di ambiente

Aggiungi ogni variabile separatamente:

Directory di lavoro

Imposta la directory di lavoro su ~/code.

Salva le tue impostazioni e riavvia Codex.

Digita /mcp nella chat; dovresti vedere capital-com elencato.

Per confermare che la connessione è avvenuta con successo, invia questi tre messaggi:

Controlla lo stato della mia sessione su Capital.com

Accedi al mio account su Capital.com.

Elenca i miei account

Se tutti e tre restituiscono risposte valide, il server è connesso correttamente.

Configurazione Claude Desktop

Terminal (Mac)

Apri Terminal ed esegui i seguenti comandi per creare il file di configurazione:

mkdir -p ~/Library/Application\ Support/Claude

nano ~/Library/Application\ Support/Claude/claude_desktop_config.json

Prompt dei comandi (Windows)

Apri il Prompt dei comandi (CMD) ed esegui:

mkdir "%APPDATA%\Claude"

notepad "%APPDATA%\Claude\claude_desktop_config.json"

Terminal (Mac) e Prompt dei comandi (Windows)

Incolla il modello riportato di seguito nel file e sostituisci ogni segnaposto in MAIUSCOLO con i tuoi valori effettivi:

{

  "mcpServers": {

"capital-com": {

   "command": "/PASTE/YOUR/VENV/PYTHON/PATH",

   "args": ["-m", "capital_mcp.server"],

   "env": {

     "CAP_ENV": "demo",

     "CAP_API_KEY": "PASTE_API_KEY",

     "CAP_IDENTIFIER": "PASTE_YOUR_EMAIL",

     "CAP_API_PASSWORD": "PASTE_API_PASSWORD",

     "CAP_ALLOW_TRADING": "false",

     "CAP_ALLOWED_EPICS": ""

   }

    }

  }

}

Salva il file: premi Ctrl + O, poi Invio, poi Ctrl + X. Riavvia Claude Desktop.

Per confermare che la connessione è avvenuta con successo, chiedi a Claude: "Quali strumenti sono disponibili su Capital.com?"

Dovresti vedere 36 strumenti elencati. Se compaiono meno strumenti, controlla la sezione di risoluzione dei problemi qui sotto.

Configurazione Cursor

Vai su Impostazioni → Strumenti e MCP e aggiungi:

{

  "capital-com": {

"command": "/path/to/venv/bin/python",

"args": ["-m", "capital_mcp.server"],

"env": {

   "CAP_ENV": "demo",

   "CAP_API_KEY": "your_api_key",

   "CAP_IDENTIFIER": "your_email",

   "CAP_API_PASSWORD": "your_password",

   "CAP_ALLOW_TRADING": "false"

}

  }

}

Riavvia Cursor e verifica la connessione con:

Elenca i miei account

Se il comando restituisce le informazioni del tuo account, l'integrazione funziona correttamente.

Configurazione Windsurf

Crea o modifica il file in ~/.windsurf/mcp/servers.json e aggiungi:

{

  "mcpServers": {

"capital-com": {

   "command": "/path/to/capital-mcp/venv/bin/python",

   "args": ["-m", "capital_mcp.server"],

   "env": {

     "CAP_ENV": "demo",

     "CAP_API_KEY": "your_api_key_here",

     "CAP_IDENTIFIER": "your_email@example.com",

     "CAP_API_PASSWORD": "your_custom_password"

     "CAP_ALLOW_TRADING": "false"

   }

    }

  }

}

Sostituisci tutti i segnaposto con le tue credenziali ottenute al passo 1.

Riavvia Windsurf e verifica la connessione con: "Elenca i miei account".

Come effettuare trading con il server MCP

Ogni operazione effettuata tramite il server MCP segue una procedura obbligatoria in tre fasi. Il server impone questa procedura e non consente di aggirarla.

Passo 1 – Anteprima della tua operazione

Chiedi al tuo assistente AI di mostrarti un'anteprima dell'operazione. Restituirà una proposta e un codice univoco preview_id.

Esempio:

Anteprima di acquisto di 1,5 [instrument] con stop a 24,50

Passo 2 –  Rivedi la proposta

Leggi attentamente le informazioni fornite dall'IA prima di procedere. Controlla lo strumento, l'entità, la direzione e i parametri di rischio per assicurarti che corrispondano a come intendi operare.

Se la dimensione richiesta è inferiore al limite minimo o superiore al limite massimo previsto dal broker per quello strumento, il server restituirà un errore. Modifica la dimensione e crea una nuova anteprima.

Passo 3 – Conferma l'esecuzione

Se vuoi procedere, invia un secondo messaggio per la conferma:

Esegui posizione con preview_id abc123 confirm=true

Non è possibile effettuare un'operazione senza un valido preview_id proveniente da un'anteprima completata. Il server richiede che entrambi i passaggi siano completati prima dell'esecuzione.

Ogni ID di anteprima può essere utilizzato una sola volta. Una volta confermata ed eseguita un'operazione, l'anteprima scade immediatamente. Per effettuare un'altra operazione, crea una nuova anteprima.

Prima di passare a un conto reale

Verifica quanto segue:

• Tutti i test sono stati completati in modalità demo (CAP_ENV = demo).
• CAP_ALLOW_TRADING è stato impostato e mantenuto su false per tutta la configurazione.
• L'accesso alla sessione, l'elenco degli account e i dati di mercato funzionano correttamente
• L'anteprima completa e il flusso di esecuzione sono stati testati con successo su un conto demo.
• Hai deciso consapevolmente di modificare CAP_ENV su live e CAP_ALLOW_TRADING su true.

Per limitare i mercati su cui il server può effettuare operazioni di trading, aggiungi un elenco di codici degli strumenti, separati da virgole, a CAP_ALLOWED_EPICS. Lascialo vuoto per consentire l'accesso a tutti i mercati disponibili sul tuo conto.

Risoluzione dei problemi: errori comuni e soluzioni {#errors}

Cosa posso chiedere al mio assistente AI? 

Una volta effettuato l'accesso, puoi iniziare con alcuni comandi di base:

Controlla il tuo account

Controlla lo stato della mia sessione su Capital.com

Accedi al mio account

Elenca i miei account

Ricerca i mercati

Cerca i mercati del bitcoin

Mostrami [instrument] i dettagli del mercato

Visualizza l'andamento dei prezzi nell'ultima ora per [instrument]

Qual è il sentiment dei clienti riguardo a [instrument]?

Rivedi il portafoglio

Mostra le mie posizioni aperte

Elenca i miei ordini in corso

Verifica l'esposizione del mio portafoglio

Effettua un'operazione (inizia in modalità demo)

Crea una proposta commerciale per [instrument] con un rischio dell'1%

Anteprima di acquisto di 1,5 [instrument] con stop a 24,50

Esegui posizione con preview_id abc-123 confirm=true

Chiudi posizione DEAL_ID confirm=true

I codici degli strumenti distinguono tra maiuscole e minuscole. Usa i nomi propri in maiuscolo (ad es. SILVER, non silver) per evitare errori.

Controllo attentamente le anteprime delle operazioni prima di confermarne l'esecuzione. I risultati generati dall'intelligenza artificiale sono solo strumenti pensati per supportare la tua analisi. Non sostituiscono il tuo giudizio e non eliminano i rischi associati al trading con i CFD.

FAQ

Devo avere un account Capital.com realee per poter utilizzare il server MCP?

No. Il server MCP funziona con un account demo. Potresti voler configurare il sistema e provarlo in modalità demo prima di collegarti a un account reale.

La mia password di accesso a Capital.com è la stessa di CAP_API_PASSWORD?

No. Sono due password separate. CAP_API_PASSWORD è una password personalizzata che crei quando generi la tua chiave API. Inserire la password di accesso in questo campo è un errore di configurazione comune che causa un errore di autenticazione.

L'intelligenza artificiale può effettuare un'operazione di trading senza il mio consenso?

No. Ogni operazione richiede una fase di anteprima seguita da un messaggio di conferma esplicito separato, contenente confirm=true. Il server non eseguirà un'operazione di trading senza entrambi i passaggi. Devi confermare esplicitamente ogni operazione di trading prima dell'esecuzione.

Cos'è CAP_ALLOW_TRADING e devo attivarlo?

CAP_ALLOW_TRADING è un'impostazione che controlla se il server può eseguire operazioni di trading. Mantienilo impostato su false durante la configurazione e il test. Cambialo in true solo dopo aver verificato la connessione in modalità demo e una volta compresi i rischi del trading di CFD dal vivo.

A cosa serve CAP_ALLOWED_EPICS?

Limita il server alla negoziazione di strumenti specifici. Se lasci il campo vuoto, potrai accedere a tutti i mercati disponibili sul tuo account. Aggiungi un elenco di codici degli strumenti, separati da virgole, per limitare la negoziazione solo a quelli selezionati.

Ho completato la configurazione, ma Claude mostra meno di 36 strumenti. Qual è il problema?

Server non avviato correttamente Esegui tail -f ~/Library/Logs/Claude/mcp-server-capital-com.log per vedere il log. Le cause comuni includono un errore di sintassi JSON nel file di configurazione o un percorso Python che punta al Python di sistema invece che all'ambiente virtuale.

Dichiarazione di non responsabilità – Utilizzo dell'API pubblica di Capital.com con strumenti di terze parti

Integrazione di terze parti

Questa pagina descrive come i clienti possono integrare l'API pubblica di Capital.com 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 da Capital.com 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 di Capital.comavviene 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 di Capital.comavviene 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 attentamente.

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, a titolo esemplificativo ma non esaustivo: 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'uso dell'API pubblica, e di qualsiasi strumento ad essa collegato, non deve essere finalizzato a manipolare la piattaforma Capital.com, 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 Capital.com, dell'API pubblica e di eventuali strumenti o integrazioni di terze parti sia conforme ai Termini e condizioni di Capital.com, alle condizioni di trading elettronico 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.