Como configurar o Servidor MCP da Capital.com

O Servidor MCP da Capital.com permite que seu assistente de IA converse diretamente com sua conta de negociação. Dados de mercado, verificações de posições, prévias de negociação – tudo em linguagem simples, sem sair da sua ferramenta de IA.

O que você vai precisar

• Uma conta Capital.com
• Sua chave da API da Capital.com
• Sua senha de API personalizada
• 2FA ativada 

Observação: você pode gerenciar a opção acima a partir das configurações da sua conta.

Os dispositivos móveis não são suportados atualmente.

O que é o Servidor MCP da Capital.com?

  O Servidor MCP é um software que roda em segundo plano no seu computador. Ele atua como uma ponte segura entre seu assistente de IA e sua conta na Capital.com.

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

• Pesquisar mercados disponíveis em forex, ações, commodities e índices
• Mostrar suas posições abertas, ordens pendentes e informações da conta
• Puxar preços históricos e outros dados de mercado
• Visualizar e abrir negociações – com sua confirmação necessária a cada vez

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

Coisas a verificar antes de começar 

Verifique se você tem tudo o que precisa instalado. Se a resposta a qualquer uma das perguntas a seguir for "Não", você precisará acessar o link fornecido antes de continuar. 

Claude Desktop: guia rápido de configuração

Se você não precisa de instruções detalhadas, aqui está a versão curta para Claude Chat no Desktop.

1. Suas quatro credenciais da API 

• Faça login na página de configurações da sua conta capital.com e obtenha sua senha da API.

2. Baixe o MCP do Github

• A url do site é: https://github.com/capital-com-sv/capital-mcp 

3. Abra o pacote MCPB

• Clique duas vezes no pacote para iniciá-lo, ou simplesmente arraste o arquivo para a sua janela do Claude Desktop.

4. Suas quatro credenciais da API

• O Claude Desktop solicitará seus detalhes da API. Insira-os e selecione "Instalar". Não se esqueça de ativar o MCP.

5. Reinicie o Claude

• Feche completamente e reabra o aplicativo, então teste o link perguntando: "Liste minhas contas".

Guia completo de configuração 

Etapa 1 – Crie suas credenciais da API

Dentro da sua conta Capital.com:

1. Ative a 2FA se ainda não o fez. Configurações → Autenticação de dois fatores.
2. Gere uma nova chave de API. Acesse Configurações → Integrações de API → Gerar nova chave.
3. Dê um nome à sua chave, por exemplo: MCP Server.
4. Defina sua Senha da API.

Leia isto antes de digitar qualquer coisa: Você está criando uma nova senha, especificamente para acesso à API. Ela não está vinculada à sua senha de login da Capital.com. É melhor escolher algo que você vai lembrar e anotar. Não reutilize sua senha de login aqui. Confundir sua senha de login com sua senha da API é um erro comum de configuração. 

5. Insira o seu código 2FA e clique em Gerar.
6. Copie sua chave da API e reconfirme sua senha da API.  Ambas são mostradas apenas uma vez. Você vai precisar delas mais tarde. Quando esta tela for fechada, eles desaparecerão. 

Mantenha-as em sigilo. Não as compartilhe nem as cole em interfaces de chat, e não as armazene em documentos compartilhados. Qualquer pessoa com esses valores pode acessar sua conta de negociação via API. 

  Etapa 2 – Baixe o MCP

O servidor MCP da Capital.com é de código aberto e está em um repositório público do GitHub. Antes que sua ferramenta de IA possa usá-la, você precisa de uma cópia do código em sua máquina.

Baixe o código MCP para sua máquina local de https://github.com/capital-com-sv/capital-mcp 

Etapa 3 – Conecte seu MCP à sua ferramenta de IA

Cada ferramenta de IA se conecta ao MCP de maneira ligeiramente diferente. Nós explicamos como conectar ao Claude Desktop aqui, mas para conexões a outras plataformas leia aqui. 

Clique duas vezes no pacote para iniciá-lo, ou simplesmente arraste o arquivo para a sua janela do Claude Desktop.

Você verá a popup abaixo em seu aplicativo do Claude Desktop. Instale o MCP e ative-o.

Etapa 4 – Insira suas credenciais e configure seu ambiente

Insira suas credenciais obtidas na etapa 1 nos campos de configuração

  Etapa 5 – Reinicie sua ferramenta de IA e teste a conexão

Reinicie sua ferramenta de IA e experimente os prompts abaixo individualmente para verificar se sua conexão está funcionando

Faça login na minha conta Capital.com

Liste minhas contas

Busque por mercados de Bitcoin

Como fazer uma negociação

Cada negociação criada através do Servidor MCP segue um processo obrigatório de três etapas. O servidor impõe isso – você não pode pular etapas.

1. Prévia

Peça ao seu assistente de IA para fornecer uma prévia da negociação:

Gere uma prévia de compra de 1,5 de SILVER com stop em 24,50

O assistente retorna uma proposta de negociação completa e um preview_id único. Leia cada detalhe antes de prosseguir.

2. Revisão

Antes de confirmar, verifique:

• O instrumento está correto? (Os códigos diferenciam maiúsculas de minúsculas: SILVER não silver)
• O tamanho da posição é o que você pretendia?
• Os níveis de stop e limite estão corretos?
• O risco parece certo para o tamanho da sua conta?

Se algo parecer errado, pare. Peça uma nova prévia com parâmetros corrigidos.

3. Confirmação

Envie isso apenas se você estiver satisfeito com a prévia:

Executar posição com preview_id abc123 confirm=true

Uma negociação não pode ser criada sem um preview_id válido de uma prévia concluída. Cada ID pode ser usada apenas uma vez e expira após a execução.

Antes de mudar para uma conta real

Complete esta lista de verificação primeiro:

• Todos os 3 prompts de teste na Etapa 5 retornaram dados válidos
• Você visualizou e confirmou com sucesso pelo menos uma negociação no modo demo
• Você entende o que cada campo na prévia de negociação significa
• Você mudou CAP_ENV para live e CAP_ALLOW_TRADING para true de forma intencional
• Você leu os Termos e Condições da Capital.com e os Termos de Negociação Eletrônica

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 (por exemplo: SILVER,GOLD,EURUSD). Deixe vazio para permitir acesso a todos os mercados disponíveis na sua conta.

O que posso perguntar ao meu assistente de IA? 

Verificar a sua conta

Faça login na minha conta

Liste minhas contas

Verifique a saúde da minha conexão com a Capital.com

Pesquisar mercados

Busque por mercados de Bitcoin

Mostre-me detalhes do mercado EURUSD

Obtenha preços históricos de 1 hora para GOLD

Revisar seu portfólio

Mostre minhas posições abertas

Liste minhas ordens ativas

Revise a exposição do meu portfólio

Abra uma negociação (modo demo primeiro)

Gere uma prévia de compra de 1,5 de SILVER com stop em 24,50

Crie uma proposta de negociação para GOLD com 1% de risco

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

Feche a posição DEAL_ID confirm=true

Solução de problemas

Execute a verificação de saúde primeiro. Peça ao seu assistente de IA: Verifique a saúde da minha conexão com a Capital.com A resposta geralmente dirá o que está errado.

Ainda travado? Envie um pedido de suporte e inclua: qual assistente de IA você está usando, seu sistema operacional e a mensagem de erro completa.

Perguntas Frequentes

Preciso de um plano pago de um assistente de IA? Alguns assistentes de IA exigem uma assinatura paga para usar os recursos do MCP. Claude Desktop, por exemplo, requer um plano pago para habilitar conectores MCP. O servidor MCP da Capital.com é gratuito. 

Preciso de uma conta de negociação ao vivo?   Não. O servidor funciona com uma conta demo e é nela que recomendamos que você comece. 

Minha senha de login da Capital.com é a mesma que CAP_API_PASSWORD?   Não. Elas são separadas.   CAP_API_PASSWORD é uma senha personalizada que você cria ao gerar sua chave da API. Usar sua senha de login aqui fará com que a autenticação falhe. 

A IA pode criar uma negociação sem a minha permissão? Não. Cada negociação requer uma etapa de prévia seguida de uma mensagem de confirmação explícita separada contendo confirm=true. O servidor não executará uma negociação sem ambas as etapas. A ID de prévia é de uso único e expira imediatamente após a execução.

O que é CAP_ALLOW_TRADING e devo ativá-lo? É um interruptor de segurança. Quando definido como false, o servidor pode mostrar dados de mercado e informações da conta, mas não pode realizar nenhuma negociação. Só mude para true depois de ter testado tudo no modo demo e estar pronto para negociar com dinheiro real.

O que CAP_ALLOWED_EPICS faz? Ele limita quais instrumentos o servidor pode negociar. Deixe vazio para permitir acesso a todos os mercados disponíveis na sua conta. Adicione uma lista separada por vírgulas (por exemplo: PRATA,OURO,EURUSD) para restringi-lo.

Vejo menos de 36 ferramentas no meu assistente de IA. O que está errado? Peça ao seu assistente de IA: Verifique a saúde da minha conexão com a Capital.com As causas mais comuns são um erro de formatação na configuração do JSON, ou o caminho do Python apontando para o Python do sistema em vez da pasta venv.

Meus dados de negociação estão seguros?  O servidor roda localmente no seu computador. Suas credenciais são armazenadas apenas no seu arquivo de configuração local e nunca são enviadas a terceiros. Toda comunicação com a Capital.com utiliza criptografia HTTPS. 

Posso usar isso em dois computadores?  Sim. Repita a Etapa 2 na segunda máquina usando as mesmas credenciais da API da Etapa 1. 

 Posso me conectar a mais de uma conta da Capital.com?  O servidor se conecta a uma conta por vez. Para alternar, atualize os 4 valores CAP_ no seu arquivo de configuração e reinicie seu assistente de IA.

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 a softwares, ferramentas ou integrações de terceiros, incluindo aqueles alimentados por inteligência artificial ou grandes modelos de linguagem ("LLMs").. Qualquer software, ferramenta ou integração de terceiros é independente 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 é 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 é 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: 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

A API Pública e quaisquer ferramentas conectadas não devem ser usadas para manipular a plataforma, 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, da API Pública e de quaisquer ferramentas ou integrações de terceiros esteja em conformidade com os Termos e Condições 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