Como configurar o Servidor MCP de IA da Capital.com

O Servidor MCP da Capital.com permite conectar um assistente de IA – como o Claude Code, Codex, Claude Desktop, Cursor ou Windsurf – à sua conta de negociação. Após a configuração, você pode usar linguagem natural para analisar mercados, verificar informações da conta, revisar posições abertas e ordens pendentes, e pré-visualizar e executar negociações diretamente do seu assistente de IA.

Este guia orienta você em cada etapa, desde a criação de suas credenciais de API e instalação do servidor até a conexão com o assistente de IA escolhido, revisando e confirmando cada trade antes da execução. Você não precisa ser um desenvolvedor, mas deve se sentir confortável seguindo instruções técnicas. Recomendamos começar no modo demo antes de migrar para uma conta real.

O que é o Servidor MCP da Capital.com?

O Servidor MCP (Model Context Protocol) da Capital.com é uma ferramenta gratuita e de código aberto que permite conectar um assistente de IA à sua conta de negociação usando suas credenciais de API da Capital.com e autenticação de dois fatores (2FA). Ele atua como uma ponte entre sua conta e a IA, permitindo que o assistente acesse dados de mercado e da conta e responda às suas instruções em tempo real.

Após a conexão, seu assistente de IA pode:  

• Pesquisar mercados disponíveis (como forex, ações, commodities e índices).
• Mostrar suas posições abertas, ordens pendentes e informações da conta.
• Obter preços históricos e dados de sentimento do cliente.
• Pré-visualizar e executar negociações, com confirmação explícita necessária antes da execução.

Você continua a ser totalmente responsável por qualquer decisão de negociação tomada utilizando o Servidor MCP. Sempre revise as visualizações de negociação com atenção antes de confirmar.

Quais assistentes de IA posso usar?

Este guia cobre a configuração para Claude Code, Codex, Claude Desktop, Cursor e Windsurf.

Se você não souber por onde começar, o Claude Code pode ser uma opção prática se você se sentir confortável usando o Terminal. O Claude Desktop pode ser mais adequado se você preferir editar um arquivo de configuração.  

Etapa 1. Criar as suas credenciais API

Primeiro, gere credenciais de API dentro da sua conta Capital.com. Isso leva cerca de dois minutos.

1. Faça login na sua conta Capital.com.  
2. Ative a autenticação de dois fatores (2FA).
3. Acesse Configurações → Integrações de API → Gerar nova chave.  
4. Dê um nome à sua chave, por exemplo: MCP Server.  
5. Crie uma senha de API personalizada. Ela é separada da sua senha de login habitual da Capital.com.
6. Insira o seu código 2FA e gere a chave.
7. Copie a chave API imediatamente. Ela não será mostrada novamente.

Você precisará dos seguintes valores nas próximas etapas:

*Pratique em uma conta demo antes de negociar com conta real.

Importante: estas credenciais fornecem acesso à sua conta de negociação. Mantenha-as em sigilo. Não as compartilhe nem as cole em interfaces de chat, e não as armazene em documentos públicos. Qualquer pessoa com acesso a esses dados pode acessar sua conta via API.

Etapa 2. Instalar o Servidor MCP Capital.com

Esta é uma instalação única. Você tem duas opções – a opção A é recomendada para a maioria dos usuários.

Opção A. Instalação rápida (recomendada)

O Servidor MCP inclui um arquivo de pacote que permite que o Claude Desktop realize a instalação para você – sem necessidade de Terminal ou edição de arquivo de configuração.

Antes de começar: certifique-se de que o uv está instalado (por exemplo, via brew install uv no Mac) e que tem o Node.js instalado para o comando pack.

1. No seu terminal, clone o repositório e crie o pacote:

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

cd capital-mcp

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

2. Abra o arquivo capital-mcp.mcpb clicando duas vezes ou arraste-o para o Claude Desktop. 
3. O Claude Desktop solicitará as suas credenciais de API. Digite-as e clique em "Install".
4. Reinicie o Claude Desktop e verifique a conexão perguntando: "Quais ferramentas da Capital.com estão disponíveis?"

Opção B. Instalação manual

Use esta opção se preferir não usar o pacote ou se estiver conectando ao Codex, Cursor ou Windsurf. 

Terminal (Mac)

1. Baixe os arquivos do servidor

cd ~/Desktop

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

cd capital-mcp

2. Crie um ambiente Python isolado e instale as dependências

python3 -m venv venv

source venv/bin/activate

pip install -e ".[dev]"

3. Encontre o seu caminho do Python

Você vai precisar disto na próxima etapa:

which python

Isso deve retornar um caminho semelhante a:

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

Copie e salve este caminho. Você o colará nas configurações do seu assistente de IA na Etapa 3. 

Dica: No Mac, você pode arrastar um arquivo do Finder para a janela do Terminal para exibir seu caminho completo.

4. Verifique se o servidor inicia corretamente

python -m capital_mcp.server

Se nenhum erro aparecer, a instalação está concluída. Se aparecer um erro, resolva-o agora – as mensagens de erro geralmente são mais fáceis de diagnosticar nesta fase do que dentro da interface do assistente de IA.

Prompt de Comando (Windows)

1. Baixe os arquivos do servidor.

cd %USERPROFILE%\Desktop

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

cd capital.com-public-api-mcp

Isso baixa o repositório para sua Área de Trabalho e abre a pasta do projeto.

2. Crie um ambiente virtual e instale as dependências.

py -m venv venv

venv\Scripts\activate.bat

pip install -e ".[dev]"

Isso cria um ambiente virtual para manter as dependências do projeto separadas do resto do sistema. Ativá-lo garante que os pacotes sejam instalados nesse ambiente.

3. Encontre o seu caminho do Python

Você precisará dele na próxima etapa:

where python

Você deve ver algo como:

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

Copie e salve este caminho. Você o colará nas configurações do seu assistente de IA na Etapa 3.

4. Verifique se o servidor inicia corretamente

python -m capital_mcp.server

Se nenhum erro aparecer, a instalação está concluída. Se aparecer um erro, resolva-o agora antes de continuar. 

Etapa 3. Conectar o seu assistente de IA

Todos os três assistentes de IA precisam das mesmas informações principais. Reúna o seguinte antes de começar:  

Configuração do Claude Code 

No seu terminal, execute:

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

Substitua /path/to/capital-mcp/venv/bin/python pelo caminho do Python que copiou na Etapa 2.

Para confirmar a conexão, pergunte ao Claude: "Quais ferramentas da Capital.com estão disponíveis?" Você deve ver 36 ferramentas listadas.

Configuração do Codex 

Acesse Codex → Configurações → Servidores MCP → Adicionar servidor e preencha os campos abaixo.

Comando

Cole o caminho do seu Python venv, por exemplo:

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

Argumentos

Adicione-os como duas entradas separadas – não as combine:

1. -m
2. capital_mcp.server

Variáveis de ambiente

Adicione cada variável individualmente:

Diretório de trabalho

Defina o diretório de trabalho para ~/code.

Salve suas configurações e reinicie o Codex.

Escreva /mcp no chat – deverá ver capital-com listado.

Para confirmar a conexão, envie estas três mensagens:

Verifique o status da minha sessão da Capital.com

Faça login na minha conta Capital.com

Liste minhas contas

Se todas as três retornarem respostas válidas, o servidor está conectado corretamente.

Configuração do Claude Desktop

Terminal (Mac)

Abra o Terminal e execute os seguintes comandos para criar o arquivo de configuração:

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

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

Prompt de Comando (Windows)

Abra o Prompt de Comando (CMD) e execute:

mkdir "%APPDATA%\Claude"

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

Terminal (Mac) e Prompt de Comando (Windows)

Cole o modelo abaixo no arquivo e substitua cada espaço reservado em CAIXA ALTA pelos seus valores reais:

{

  "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": ""

   }

    }

  }

}

Salve o arquivo: pressione Ctrl + O, depois Enter, depois Ctrl + X. Reinicie o Claude Desktop.

Para confirmar a conexão, pergunte ao Claude: "Quais ferramentas da Capital.com estão disponíveis?"

Você deve ver 36 ferramentas listadas. Se menos ferramentas aparecerem, verifique a seção de solução de problemas abaixo. 

Configuração do Cursor

Acesse Configurações → Ferramentas & MCPs e adicione:

{

  "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"

}

  }

}

Reinicie o Cursor e teste a conexão com:

Liste minhas contas

Se o comando retornar as informações da sua conta, a integração está funcionando conforme o esperado.

Configuração do Windsurf

Crie ou edite o arquivo em ~/.windsurf/mcp/servers.json e adicione:

{

  "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"

   }

    }

  }

}

Substitua todos os valores de espaço reservado pelas suas credenciais reais da etapa 1.

Reinicie o Windsurf e teste a conexão com: "Liste minhas contas". 

Como negociar com o Servidor MCP

Cada negociação colocada através do Servidor MCP segue um processo obrigatório de três etapas. O servidor impõe esse processo e não permite que você o ignore.

Etapa 1 – Pré-visualizar a sua negociação

Peça ao seu assistente de IA para pré-visualizar uma negociação. Ele retornará uma proposta e um preview_id único.

Exemplo:

Pré-visualização de compra de 1,5 [instrument] com stop em 24,50

Etapa 2 –  Revisar a proposta

Leia os detalhes retornados pela IA com atenção antes de tomar qualquer outra atitude. Verifique o instrumento, tamanho, direção e parâmetros de risco para garantir que correspondam à sua intenção.

Se o tamanho solicitado estiver abaixo do mínimo da corretora ou acima do máximo da corretora para aquele instrumento, o servidor retornará um erro. Ajuste o tamanho e crie uma nova visualização.  

Etapa 3 – Confirmar a execução

Se quiser prosseguir, envie uma segunda mensagem para confirmar:

Executar posição com preview_id abc123 confirm=true

Uma negociação não pode ser colocada sem um preview_id válido de uma pré-visualização concluída. O servidor exige ambas as etapas antes da execução.

Cada ID de pré-visualização só pode ser usado uma vez. Após a negociação ser confirmada e executada, a pré-visualização expira imediatamente. Para colocar outra negociação, inicie uma nova pré-visualização.

Antes de mudar para uma conta real

Confirme todos os seguintes pontos:

• Todos os testes concluídos em modo demo (CAP_ENV = demo).
• CAP_ALLOW_TRADING mantido como false durante toda a configuração.
• Login na sessão, listagem de contas e dados de mercado funcionando corretamente
• Fluxo completo de pré-visualização e execução testado com sucesso na conta demo.
• Você decidiu conscientemente mudar CAP_ENV para live e CAP_ALLOW_TRADING para true.

Para restringir os mercados que o servidor pode negociar, adicione uma lista separada por vírgulas de códigos de instrumento a CAP_ALLOWED_EPICS. Deixe vazio para permitir acesso a todos os mercados disponíveis na sua conta.

Resolução de problemas: erros comuns e correções {#errors}

O que posso perguntar ao meu assistente de IA?  

Após a conexão, você pode começar com alguns exemplos de prompts:  

Verificar a sua conta

Verifique o meu status de sessão

Faça login na minha conta da Capital.com

Liste minhas contas

Pesquisar mercados

Busque por mercados de Bitcoin

Mostre-me [instrument] detalhes do mercado

Obtenha preços históricos de 1 hora para [instrument]

Qual é o sentimento do cliente sobre [instrument]?

Revisar seu portfólio  

Mostre minhas posições abertas

Liste minhas ordens ativas

Revise minha exposição de portfólio

Colocar uma negociação (comece em modo demo)

Crie uma proposta de negociação para [instrument] com 1% de risco

Gere uma pré-visualização de compra de 1,5 [instrument] com stop em 24,50

Execute a posição com preview_id abc123 confirm=true

Feche a posição DEAL_ID confirm=true

Os códigos de instrumento são sensíveis a maiúsculas/minúsculas. Utilize epics em maiúsculas (ex: SILVER, não silver) para evitar erros.

Reveja sempre as pré-visualizações das negociações cuidadosamente antes de confirmar. Saídas geradas por IA são ferramentas para apoiar sua análise. Elas não substituem seu julgamento nem removem os riscos associados à negociação de CFDs.

Perguntas Frequentes

Preciso de uma conta real da Capital.com para utilizar o Servidor MCP? 

Não. O Servidor MCP funciona com uma conta de demonstração. Você pode configurar e testar em modo demo antes de conectar a uma conta real.

Minha senha de login da Capital.com é a mesma que CAP_API_PASSWORD?

Não. São duas senhas diferentes. CAP_API_PASSWORD é uma senha personalizada que você cria ao gerar sua chave de API. Usar sua senha de login neste campo é um erro comum de configuração e fará com que a autenticação falhe.

A IA pode colocar uma negociação sem a minha permissão?

Não. Cada negociação requer uma etapa de pré-visualização seguido de uma mensagem de confirmação explícita separada contendo confirm=true. O servidor não executará uma negociação sem ambos as etapas. Você deve confirmar explicitamente cada trade antes da execução.

O que é CAP_ALLOW_TRADING e devo ativá-lo?

CAP_ALLOW_TRADING é uma definição que controla se o servidor pode executar negociações. Mantenha-o como false durante a configuração e testes. Só o altere para true depois de ter verificado totalmente a conexão em modo demo e compreendido os riscos da negociação CFD real.

O que CAP_ALLOWED_EPICS faz?

Restringe o servidor a negociar instrumentos específicos. Se você o deixar vazio, todos os mercados disponíveis na sua conta podem ser acessados. Adicione uma lista separada por vírgulas de códigos epic de instrumento para limitar a negociação apenas aos selecionados.  

Configurei tudo, mas o Claude mostra menos de 36 ferramentas. O que está errado?

O servidor não está iniciando corretamente. Execute tail -f ~/Library/Logs/Claude/mcp-server-capital-com.log para revisar o log de saída. As causas comuns incluem um erro de sintaxe JSON no arquivo de configuração ou um caminho do Python apontando para o Python do sistema em vez do ambiente virtual.

Aviso legal – Uso da API Pública da Capital.com com ferramentas de terceiros 

Integração de Terceiros

Esta página descreve como os clientes podem conectar a API Pública da Capital.com a softwares, ferramentas ou integrações de terceiros, incluindo aqueles alimentados por inteligência artificial ou grandes modelos de linguagem ("LLMs", da sigla em inglês). Qualquer software, ferramenta ou integração de terceiros é independente da Capital.com e não faz parte dos serviços da Capital.com. A Capital.com não controla, desenvolve, endossa nem aceita qualquer responsabilidade por qualquer software de terceiros, sua funcionalidade, resultados ou quaisquer resultados decorrentes de seu uso. Qualquer uso de ferramentas ou integrações de terceiros em conexão com a API Pública da  Capital.com é inteiramente por sua conta e risco. Você é responsável por revisar os termos, políticas de privacidade e práticas de tratamento de dados de qualquer ferramenta de terceiros que escolher usar.  

Uso da API Pública 

Seu uso da API Pública da  Capital.com é inteiramente por sua própria discrição e risco. A Capital.com disponibiliza a API Pública para fins informativos e de negociação, mas não recomenda, endossa ou incentiva qualquer uso, integração ou estratégia de negociação específica. Você é o único responsável por como acessa e usa a API, incluindo os parâmetros de quaisquer ordens submetidas, a configuração de quaisquer ferramentas ou sistemas conectados e a interpretação de quaisquer dados recebidos. A Capital.com não aceita responsabilidade por perdas ou resultados não intencionais decorrentes do seu uso da API, seja acessada diretamente ou por meio de ferramentas de terceiros. A disponibilidade, funcionalidade e especificações da API podem ser modificadas, limitadas em taxa, suspensas ou descontinuadas a qualquer momento, sem aviso prévio. Seu uso da API Pública está sujeito aos Termos e Condições e Termos de Negociação Eletrônica da Capital.com, que você deve ler atentamente antes de usar a API.

Serviço exclusivo de execução e ausência de aconselhamento de investimento 

A Capital.com presta seus serviços com base exclusiva de execução. A negociação de instrumentos financeiros envolve risco significativo de perda. Nada nesta página, na API Pública ou em qualquer software ou integração de terceiros constitui aconselhamento de investimento, recomendação pessoal ou solicitação para comprar ou vender qualquer instrumento financeiro. Isso inclui qualquer resultado, sinal, sugestão ou análise gerada por IA, LLM ou outras ferramentas automatizadas. Todas as decisões de negociação, incluindo qualquer atividade automatizada ou algorítmica, são tomadas por sua conta e risco e permanecem de sua única responsabilidade.

Riscos de negociação automatizada e algorítmica

O uso da API Pública em conexão com ferramentas de negociação automatizada ou algorítmica acarreta riscos adicionais, incluindo, mas não se limitando a: execução rápida de ordens sem revisão ou intervenção humana; erros de sistema, falhas de software ou problemas de conectividade; execução a preços materialmente diferentes dos esperados; e ordens não intencionais ou errôneas decorrentes de ferramentas ou parâmetros mal configurados. A Capital.com não é responsável por quaisquer perdas decorrentes de tais riscos ou da interação entre seus sistemas e quaisquer ferramentas de terceiros. Desempenho passado e quaisquer resultados gerados por ferramentas automatizadas não são indicativos de resultados futuros.

Uso proibido

O uso da API Pública e de quaisquer ferramentas conectadas não deve ser usado para manipular a plataforma Capital.com, explorar precificação ou latência, envolver-se em abuso de mercado ou obter qualquer vantagem indevida. A Capital.com reserva-se o direito de restringir, suspender ou encerrar o acesso à API e/ou sua conta quando considerar razoavelmente que tal uso indevido ocorreu ou é provável que ocorra. Os clientes não devem permitir que terceiros exerçam controle discricionário sobre sua conta.  

Suas responsabilidades 

Você é responsável por garantir que seu uso da plataforma Capital.com, da API Pública e de quaisquer ferramentas ou integrações de terceiros esteja em conformidade com os Termos e Condições, os Termos de Negociação Eletrônica da Capital.com e todas as leis e regulamentos aplicáveis em sua jurisdição. Você deve considerar cuidadosamente se as ferramentas de negociação automatizada são apropriadas para suas circunstâncias, experiência e tolerância ao risco antes de usá-las. A Capital.com recomenda fortemente que você teste quaisquer ferramentas ou integrações automatizadas completamente usando uma conta demo antes de conectá-las a um ambiente de negociação real