Cómo configurar el servidor MCP de IA de Capital.com

El servidor MCP de Capital.com te permite conectar un asistente de IA —como Claude Code, Codex, Claude Desktop, Cursor o Windsurf— a tu cuenta de trading. Una vez configurado, puedes usar lenguaje natural para analizar los mercados, consultar la información de tu cuenta, revisar tus posiciones abiertas y órdenes vigentes, así como previsualizar y realizar operaciones desde tu asistente de IA.

Esta guía te llevará paso a paso, desde la creación de tus credenciales de API y la instalación del servidor, hasta la conexión del asistente de IA de tu elección y la revisión y confirmación de cada operación antes de su ejecución. No necesitas ser desarrollador, pero sí sentirte cómodo siguiendo instrucciones técnicas. Te recomendamos empezar en modo demo antes de cambiar a una cuenta real.

¿Qué es el servidor MCP de Capital.com?

El servidor MCP (Model Context Protocol o Protocolo de Contexto de Modelo) de Capital.com es una herramienta gratuita de código abierto que te permite conectar un asistente de IA a tu cuenta de trading mediante tus credenciales de API de Capital.com y la autenticación de dos factores (2FA). Actúa como un puente entre tu cuenta y la IA, para que el asistente pueda acceder a los datos del mercado y de la cuenta, y responder a tus instrucciones en tiempo real.

Una vez conectado, tu asistente de IA puede:

• Buscar mercados disponibles (como divisas, acciones, materias primas e índices).
• Mostrar tus posiciones abiertas, órdenes vigentes e información de la cuenta.
• Extraer precios históricos y datos de sentimiento de los clientes.
• Previsualizar y ejecutar operaciones, con una confirmación explícita obligatoria antes de la ejecución.

Tú eres el único responsable de cualquier decisión de trading tomada mediante el servidor MCP. Revisa siempre las previsualizaciones de las operaciones con cuidado antes de confirmar.

¿Qué asistentes de IA puedo usar?

Esta guía cubre la configuración para Claude Code, Codex, Claude Desktop, Cursor y Windsurf.

Si no sabes por dónde empezar, Claude Code puede ser una opción práctica si te sientes cómodo usando la terminal. Claude Desktop podría ser mejor para ti si prefieres editar un archivo de configuración.

Paso 1. Crea tus credenciales de API

Primero, genera las credenciales de API dentro de tu cuenta de Capital.com. Este proceso toma unos dos minutos.

1. Inicia sesión en tu cuenta de Capital.com.
2. Activa la autenticación de dos factores (2FA).
3. Ve a Configuración → Integraciones de API → Generar nueva clave.
4. Dale una etiqueta a tu clave, por ejemplo: Servidor MCP.
5. Crea una contraseña de API personalizada. Esta es distinta a tu contraseña habitual de inicio de sesión en Capital.com.
6. Ingresa tu código 2FA y genera la clave.
7. Copia la clave de API de inmediato. No se volverá a mostrar.

Necesitarás los siguientes valores en los próximos pasos:

*Practica en una cuenta demo antes de operar en una cuenta real.

Importante: estas credenciales dan acceso a tu cuenta de trading. Mantenlas en privado. No las compartas ni las pegues en interfaces de chat, y no las guardes en documentos públicos. Cualquier persona con acceso a estos datos podría entrar a tu cuenta a través de la API.

Paso 2. Instala el servidor MCP de Capital.com

Esta instalación se realiza una sola vez. Tienes dos opciones; recomendamos la opción A para la mayoría de los usuarios.

Opción A. Instalación rápida (recomendada)

El servidor MCP incluye un archivo de paquete (bundle) que permite que Claude Desktop gestione la instalación por ti; no es necesario usar la terminal ni editar archivos de configuración.

Antes de empezar: asegúrate de tener instalado uv (por ejemplo, mediante brew install uv en Mac) y de contar con Node.js para el comando pack. 

1. En tu terminal, clona el repositorio y construye el paquete:

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

cd capital-mcp

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

2. Abre capital-mcp.mcpb haciendo doble clic o arrástralo a Claude Desktop.
3. Claude Desktop te pedirá tus credenciales de API. Ingrésalas y haz clic en «Instalar».
4. Reinicia Claude Desktop y verifica la conexión preguntando: «¿Qué herramientas de Capital.com están disponibles?».

Opción B. Instalación manual

Usa esta opción si prefieres no usar el paquete o si te vas a conectar a Codex, Cursor o Windsurf.

Terminal (Mac)

1. Descarga los archivos del servidor

cd ~/Desktop

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

cd capital-mcp

2. Crea un entorno de Python aislado e instala las dependencias

python3 -m venv venv

source venv/bin/activate

pip install -e ".[dev]"

3. Busca tu ruta de Python

La necesitarás en el siguiente paso:

which python

Esto debería devolver una ruta de archivo similar a:

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

Copia y guarda esta ruta. La pegarás en los ajustes de tu asistente de IA en el Paso 3.

Tip: En Mac, puedes arrastrar un archivo desde el Finder a la ventana de la terminal para ver su ruta completa.

4. Verifica que el servidor inicie correctamente

python -m capital_mcp.server 

Si no aparecen errores, la instalación se completó. Si ves un error, resuélvelo ahora; los mensajes de error suelen ser más fáciles de diagnosticar en esta etapa que dentro de la interfaz de un asistente de IA.

Símbolo del sistema (Windows)

1. Descarga los archivos del servidor

cd %USERPROFILE%\Desktop

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

cd capital.com-public-api-mcp

Esto descarga el repositorio en tu escritorio y abre la carpeta del proyecto.

2. Crea un entorno virtual e instala las dependencias

py -m venv venv

venv\Scripts\activate.bat

pip install -e ".[dev]"

Esto crea un entorno virtual para mantener las dependencias del proyecto separadas del resto de tu sistema. Al activarlo, te aseguras de que los paquetes se instalen en ese entorno.

3. Busca tu ruta de Python

La necesitarás en el siguiente paso:

where python

Deberías ver algo como:

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

Copia y guarda esta ruta. La pegarás en los ajustes de tu asistente de IA en el Paso 3.

4. Verifica que el servidor inicie correctamente

python -m capital_mcp.server

Si no aparecen errores, la instalación se completó. Si ves un error, resuélvelo antes de continuar.

Paso 3. Conecta tu asistente de IA

Los tres asistentes de IA necesitan la misma información básica. Reúne lo siguiente antes de empezar:

Configuración de Claude Code 

En tu terminal, ejecuta:

claude mcp add capital-com -- /ruta/a/capital-mcp/venv/bin/python -m capital_mcp.server 

Sustituye /ruta/a/capital-mcp/venv/bin/python por la ruta de Python que copiaste en el Paso 2. 

Para confirmar la conexión, pregúntale a Claude: «¿Qué herramientas de Capital.com están disponibles?». Deberías ver una lista con 36 herramientas.

Configuración de Codex 

Ve a Codex → Ajustes → Servidores MCP → Agregar servidor y completa los campos siguientes. 

Comando

Pega tu ruta de Python de venv, por ejemplo:

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

Argumentos

Agrégalos como dos entradas separadas; no los combines:

1. -m
2. capital_mcp.server

Variables de entorno

Agrega cada variable de forma individual:

Directorio de trabajo

Configura el directorio de trabajo como ~/code. 

Guarda tus ajustes y reinicia Codex.

Escribe /mcp en el chat; deberías ver a capital-com en la lista. 

Para confirmar la conexión, envía estos tres mensajes:

Verifica el estado de mi sesión de Capital.com

Inicia sesión en mi cuenta de Capital.com

Enumera mis cuentas

Si los tres devuelven respuestas válidas, el servidor está conectado correctamente.

Configuración de Claude Desktop

Terminal (Mac)

Abre la terminal y ejecuta los siguientes comandos para crear el archivo de configuración:

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

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

Símbolo del sistema (Windows)

Abre el símbolo del sistema (CMD) y ejecuta:

mkdir "%APPDATA%\Claude"

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

Terminal (Mac) y Símbolo del sistema (Windows)

Pega la siguiente plantilla en el archivo y sustituye cada marcador en MAYÚSCULAS por tus valores reales:

{

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

   }

    }

  }

}

Guarda el archivo: presiona Ctrl + O, luego Enter, y después Ctrl + X.  Reinicia Claude Desktop.

Para confirmar la conexión, pregúntale a Claude: «¿Qué herramientas de Capital.com están disponibles?».

Deberías ver una lista con 36 herramientas. Si aparecen menos, consulta la sección de solución de problemas a continuación.

Configuración de Cursor

Ve a Ajustes → Herramientas y MCP y agrega: 

{

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

}

  }

}

Reinicia Cursor y prueba la conexión con:

Enumera mis cuentas

Si el comando devuelve la información de tu cuenta, la integración funciona según lo esperado.

Configuración de Windsurf

Crea o edita el archivo en ~/.windsurf/mcp/servers.json y agrega:

{

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

   }

    }

  }

}

Sustituye todos los valores de los marcadores por tus credenciales reales del paso 1.

Reinicia Windsurf y prueba la conexión con: «Enumera mis cuentas».

Cómo operar con el servidor MCP

Cada operación realizada a través del servidor MCP sigue un proceso obligatorio de tres pasos. El servidor impone este proceso y no permite omitirlo.

Paso 1: Previsualiza tu operación

Pídele a tu asistente de IA que previsualice una operación. Te devolverá una propuesta y un preview_id único. 

Ejemplo:

«Previsualiza la compra de 1.5 [instrument] con stop en 24.50»

Paso 2: Revisa la propuesta

Lee con atención los detalles que te devuelva la IA antes de realizar cualquier otra acción. Verifica el instrumento, el tamaño, la dirección y los parámetros de riesgo para asegurarte de que coincidan con tu intención.

Si el tamaño solicitado es inferior al mínimo del bróker o superior al máximo para ese instrumento, el servidor devolverá un error. Ajusta el tamaño y crea una nueva previsualización.

Paso 3: Confirma la ejecución

Si quieres continuar, envía un segundo mensaje para confirmar:

Ejecuta la posición con el preview_id abc123 confirm=true

No se puede realizar una operación sin un preview_id válido de una previsualización completada.  El servidor exige ambos pasos antes de la ejecución.

Cada ID de previsualización solo puede usarse una vez. Una vez que se confirma y ejecuta una operación, la previsualización caduca de inmediato. Para realizar otra operación, inicia una nueva previsualización.

Antes de cambiar a una cuenta real

Confirma todo lo siguiente:

• Toda la fase de pruebas se completó en modo demo (CAP_ENV = demo).
• CAP_ALLOW_TRADING se mantuvo como false durante toda la configuración.
• El inicio de sesión, la lista de cuentas y los datos de mercado funcionan correctamente.
• El flujo completo de previsualización y ejecución se probó con éxito en la cuenta demo.
• Has decidido conscientemente cambiar CAP_ENV a «live» y CAP_ALLOW_TRADING a true. 

Para restringir los mercados en los que el servidor puede operar, agrega una lista de códigos de instrumentos separados por comas en CAP_ALLOWED_EPICS. Déjalo vacío para permitir el acceso a todos los mercados disponibles en tu cuenta.

Solución de problemas: errores comunes y soluciones {#errors}

¿Qué puedo preguntarle a mi asistente de IA? 

Una vez conectado, puedes empezar con algunos ejemplos de instrucciones:

Consulta tu cuenta

Verifica el estado de mi sesión

Inicia sesión en mi cuenta

Enumera mis cuentas

Investiga mercados

Busca mercados de bitcoin

Muéstrame los detalles del mercado [instrument]

Obtén precios históricos de 1 hora para [instrument]

¿Cuál es el sentimiento de los clientes sobre [instrument]?

Revisa tu portafolio

Muestra mis posiciones abiertas

Enumera mis órdenes vigentes

Revisa la exposición de mi portafolio

Realiza una operación (comienza en modo demo)

Crea una propuesta de operación para [instrument] con un riesgo del 1%

Previsualiza la compra de 1.5 [instrument] con stop en 24.50

Ejecuta la posición con el preview_id abc-123 confirm=true

Cierra la posición DEAL_ID confirm=true

Los códigos de los instrumentos distinguen entre mayúsculas y minúsculas. Usa epics en mayúsculas (p. ej. SILVER, no silver) para evitar errores.

Revisa siempre las previsualizaciones de las operaciones con cuidado antes de confirmar la ejecución. Los resultados generados por la IA son herramientas de apoyo para tu análisis. No reemplazan tu criterio ni eliminan los riesgos asociados al trading de CFD.

Preguntas frecuentes

¿Necesito una cuenta real de Capital.com para usar el servidor MCP?

No. El servidor MCP funciona con una cuenta demo. Es recomendable configurarlo y probarlo en modo demo antes de conectarlo a una cuenta real.

¿Mi contraseña de inicio de sesión de Capital.com es la misma que CAP_API_PASSWORD?

No. Son dos contraseñas distintas. CAP_API_PASSWORD es una contraseña personalizada que tú creas al generar tu clave de API.  Usar tu contraseña de inicio de sesión en este campo es un error común que hará que falle la autenticación.

¿La IA puede realizar una operación sin mi permiso?

No. Cada operación requiere un paso de previsualización seguido de un mensaje de confirmación explícito independiente que contenga confirm=true. El servidor no ejecutará ninguna operación sin ambos pasos. Debes confirmar explícitamente cada operación antes de su ejecución.

¿Qué es CAP_ALLOW_TRADING y debería activarlo?

CAP_ALLOW_TRADING es un ajuste que controla si el servidor puede ejecutar operaciones. Mantenlo en false durante la configuración y las pruebas. Cámbialo a true solo cuando hayas verificado completamente la conexión en modo demo y comprendas los riesgos del trading de CFD en vivo.

¿Qué hace CAP_ALLOWED_EPICS?

Restringe el servidor para que solo opere con instrumentos específicos. Si lo dejas vacío, se podrá acceder a todos los mercados disponibles en tu cuenta. Agrega una lista de códigos epic de instrumentos separados por comas para limitar el trading únicamente a los seleccionados.

Configuré todo, pero Claude muestra menos de 36 herramientas. ¿Qué está mal?

Es probable que el servidor no esté iniciando correctamente. Ejecuta tail -f ~/Library/Logs/Claude/mcp-server-capital-com.log para revisar el registro de salida. Las causas comunes incluyen un error de sintaxis JSON en el archivo de configuración o una ruta de Python que apunta al Python del sistema en lugar del entorno virtual.

Aviso legal: uso de la API pública de Capital.com con herramientas de terceros

Integración de terceros

Esta página describe cómo los clientes pueden conectar la API pública de Capital.com a software, herramientas o integraciones de terceros, incluyendo aquellas impulsadas por inteligencia artificial o modelos de lenguaje de gran tamaño («LLM»). Cualquier software, herramienta o integración de terceros es independiente de Capital.com y no forma parte de los servicios de Capital.com. Capital.com no controla, desarrolla, respalda ni asume responsabilidad alguna por cualquier software de terceros, su funcionalidad, resultados o cualquier consecuencia derivada de su uso. Cualquier uso de herramientas o integraciones de terceros en relación con la API pública de  Capital.com es bajo tu propio riesgo. Eres responsable de revisar los términos, las políticas de privacidad y las prácticas de manejo de datos de cualquier herramienta de terceros que decidas utilizar.

Uso de la API pública

El uso que hagas de la API pública de  Capital.com es bajo tu entera discreción y riesgo.  Capital.com pone la API pública a disposición con fines informativos y operativos, pero no recomienda, respalda ni fomenta ningún uso, integración o estrategia de trading en particular. Eres el único responsable de cómo accedes y utilizas la API, incluyendo los parámetros de cualquier orden enviada, la configuración de cualquier herramienta o sistema conectado y la interpretación de cualquier dato recibido. Capital.com no asume responsabilidad alguna por pérdidas o resultados no deseados derivados del uso de la API, ya sea que se acceda directamente o a través de herramientas de terceros. La disponibilidad, la funcionalidad y las especificaciones de la API pueden modificarse, limitarse, suspenderse o interrumpirse en cualquier momento sin previo aviso. El uso de la API pública está sujeto a los Términos y condiciones y a los Términos de trading electrónico de Capital.com, los cuales debes leer cuidadosamente antes de usar la API.

Servicio de solo ejecución y sin asesoría de inversión

Capital.com presta sus servicios bajo un esquema de solo ejecución. El trading de instrumentos financieros conlleva un riesgo significativo de pérdida. Nada en esta página, en la API pública ni en ningún software o integración de terceros constituye asesoría de inversión, una recomendación personal ni una solicitud para comprar o vender cualquier instrumento financiero. Esto incluye cualquier resultado, señal, sugerencia o análisis generado por IA, herramientas basadas en LLM u otras herramientas automatizadas. Todas las decisiones de trading, incluyendo cualquier actividad automatizada o algorítmica, se realizan bajo tu propio riesgo y son tu exclusiva responsabilidad.

Riesgos del trading automatizado y algorítmico

El uso de la API pública en relación con herramientas de trading automatizadas o algorítmicas conlleva riesgos adicionales, que incluyen, entre otros: ejecución rápida de órdenes sin revisión o intervención humana; errores del sistema, fallas de software o problemas de conectividad; ejecución a precios sustancialmente distintos de los esperados; y órdenes no deseadas o erróneas derivadas de herramientas o parámetros mal configurados. Capital.com no es responsable de ninguna pérdida que surja de dichos riesgos o de la interacción entre sus sistemas y cualquier herramienta de terceros. El desempeño pasado y cualquier resultado generado por herramientas automatizadas no son indicativos de resultados futuros.

Uso prohibido

El uso de la API pública y de cualquier herramienta conectada no debe emplearse para manipular la plataforma de Capital.com, explotar precios o latencia, participar en abuso de mercado ni obtener ninguna ventaja desleal. Capital.com se reserva el derecho de restringir, suspender o terminar el acceso a la API o a tu cuenta cuando considere razonablemente que dicho uso indebido ha ocurrido o es probable que ocurra. Los clientes no deben permitir que ningún tercero ejerza control discrecional sobre su cuenta.

Tus responsabilidades

Eres responsable de garantizar que el uso de la plataforma de Capital.com, de la API pública y de cualquier herramienta o integración de terceros cumpla con los Términos y condiciones de Capital.com, los Términos de trading electrónico y todas las leyes y regulaciones aplicables en tu jurisdicción. Debes considerar cuidadosamente si las herramientas de trading automatizadas son adecuadas para tus circunstancias, experiencia y tolerancia al riesgo antes de usarlas. Capital.com recomienda encarecidamente que pruebes a fondo cualquier herramienta automatizada o integración usando una cuenta demo antes de conectarla a un entorno de trading real.