El servidor MCP de Capital.com permite que tu asistente de IA se comunique directamente con tu cuenta de trading. Datos de mercado, revisión de posiciones, previsualización de operaciones: todo en lenguaje sencillo y sin salir de tu herramienta de IA.
Lo que necesitarás
- Una cuenta de Capital.com
- Tu clave API de Capital.com
- Tu contraseña de API personalizada
- 2FA activado
Nota: puedes gestionar lo anterior desde los ajustes de tu cuenta.
Actualmente no es compatible con dispositivos móviles.
¿Qué es el servidor MCP de Capital.com?
El servidor MCP es un software que se ejecuta en segundo plano en tu computadora. Funciona como un puente seguro entre tu asistente de IA y tu cuenta de Capital.com.
Una vez conectado, tu asistente de IA puede:
- Buscar mercados disponibles en divisas, acciones, materias primas e índices
- Mostrar tus posiciones abiertas, órdenes activas y saldo de cuenta
- Obtener precios históricos y otros datos de mercado
- Previsualizar y abrir operaciones (se requiere tu confirmación en cada ocasión)
Eres totalmente responsable de cualquier decisión de trading tomada mediante el servidor MCP. Revisa siempre las previsualizaciones de las operaciones con cuidado antes de confirmar.
Cosas que revisar antes de empezar
Asegúrate de tener instalado todo lo necesario. Si la respuesta a cualquiera de las siguientes preguntas es «No», deberás seguir el enlace proporcionado antes de continuar.
| Revisar | Sí | No |
|---|---|---|
| ¿Tienes una cuenta de Capital.com? | Continuar | Crear una cuenta |
| ¿Has instalado tu herramienta de IA preferida? | Continuar | Algunas sugerencias: Claude Code, Claude Desktop, Codex, Cursor, Windsurf. |
| ¿Estás en Mac o Windows? | Continuar | Actualmente no es compatible con dispositivos móviles |
Claude Desktop: Guía de configuración rápida
Si no necesitas instrucciones detalladas, esta es la versión corta para Claude Chat en escritorio.
- Obtén tus credenciales de API
- Inicia sesión en la página de ajustes de tu cuenta de Capital.com y obtén tu contraseña de API.
- Descarga el MCP desde Github
- La URL del sitio web es: https://github.com/capital-com-sv/capital-mcp
- Abre el paquete MCPB
- Haz doble clic en el paquete para ejecutarlo o simplemente arrastra el archivo a tu ventana de Claude Desktop.
- Ingresa tus credenciales de API
- Claude Desktop te solicitará los datos de tu API. Ingrésalos y selecciona «Instalar». No olvides activar el MCP.
- Reinicia Claude
- Cierra y vuelve a abrir la aplicación por completo, luego prueba el enlace preguntando: «Enumera mis cuentas».
Guía de configuración completa
Paso 1: Crea tus credenciales de API
Desde tu cuenta de Capital.com:
- Activa la 2FA si aún no lo has hecho. Ajustes → Autenticación de dos factores.
- Genera una nueva clave API. Ajustes → Integraciones de API → Generar clave API.
- Ponle una etiqueta a tu clave (por ejemplo: Servidor MCP).
- Configura tu contraseña de API.
Lee esto antes de escribir nada: estás creando una contraseña completamente nueva, específicamente para el acceso a la API. No está vinculada a tu contraseña de acceso a Capital.com. Lo mejor es elegir algo que recuerdes y anotarlo. No reutilices aquí tu contraseña de inicio de sesión. Mezclar tu contraseña de inicio de sesión con tu contraseña de API es un error de configuración común.
- Ingresa tu código 2FA y haz clic en Generar.
- Copia tu clave API y vuelve a confirmar tu contraseña de API. Ambas se muestran solo una vez. Las necesitarás más adelante. Cuando se cierre esta pantalla, desaparecerán.
Mantenlas en privado. No las pegues en interfaces de chat, no las compartas con otras personas ni las guardes en un documento compartido. Cualquiera que tenga estos valores puede acceder a tu cuenta de trading a través de la API.
Paso 2: Descarga el MCP
El servidor MCP de Capital.com es de código abierto y se encuentra en un repositorio público de GitHub. Para que tu herramienta de IA pueda usarlo, necesitas una copia del código en tu máquina.
Descarga el código del MCP en tu máquina local desde https://github.com/capital-com-sv/capital-mcp
Paso 3: Conecta tu MCP a tu herramienta de IA
Cada herramienta de IA se conecta al MCP de forma ligeramente distinta. Aquí explicamos cómo conectar con Claude Desktop, pero para conexiones con otras plataformas lee aquí:
Para Claude Desktop, haz doble clic en el archivo mcpb para ejecutarlo o simplemente arrastra el archivo a la ventana de tu Claude Desktop.
Verás la siguiente ventana emergente en tu aplicación Claude Desktop. Instala el MCP y actívalo.
Paso 4: Ingresa tus credenciales y configura tu entorno
Ingresa en los campos de configuración las credenciales que obtuviste en el paso 1.
| Valor | Origen |
|---|---|
| Clave API | Tu clave API del paso 1 |
| CAP_IDENTIFIER | Tu correo electrónico de Capital.com |
| CAP_API_PASSWORD | Tu contraseña de API personalizada del paso 1 |
Paso 5: Reinicia tu herramienta de IA y prueba la conexión
Reinicia tu herramienta de IA y prueba los siguientes comandos de forma individual para revisar si tu conexión funciona:
Iniciar sesión en mi cuenta de Capital.com
Listar mis cuentas
Buscar mercados de bitcoin
Cómo abrir una operación
Cada operación a través del servidor MCP sigue 3 pasos obligatorios. El servidor impone esto: no puedes saltarte pasos.
1. Previsualizar
Pídele a tu asistente de IA que previsualice una operación:
Previsualizar la compra de 1.5 de PLATA con stop en 24.50
El asistente devuelve una propuesta de operación completa y un preview_id único. Lee cada detalle antes de continuar.
2. Revisar
Antes de confirmar, revisa:
- ¿Es el instrumento correcto? (Los códigos distinguen mayúsculas de minúsculas: PLATA, no plata)
- ¿Es el tamaño de la posición que deseabas?
- ¿Son correctos los niveles de stop y límite?
- ¿El riesgo parece adecuado para el tamaño de tu cuenta?
Si algo parece incorrecto, detente. Pide una nueva previsualización con los parámetros corregidos.
3. Confirmar
Envía esto solo si estás conforme con la previsualización:
Ejecutar posición con preview_id abc123 confirm=true
No se puede abrir una operación sin un preview_id válido. Cada ID solo puede usarse una vez y vence inmediatamente después de la ejecución.
Antes de cambiar a una cuenta real
Completa primero esta lista de verificación:
- Los 3 comandos de prueba del paso 5 devolvieron datos válidos.
- Has previsualizado y confirmado con éxito al menos una operación en modo demo.
- Entiendes lo que significa cada campo en la previsualización de la operación.
- Has cambiado CAP_ENV a «live» y CAP_ALLOW_TRADING a «true» de forma intencional.
- Has leído los Términos y condiciones, así como los Términos de trading electrónico de Capital.com.
Para restringir en qué mercados puede operar el servidor, añade los códigos de los instrumentos en CAP_ALLOWED_EPICS (por ejemplo: PLATA, ORO, EURUSD). Déjalo vacío para permitir todos los mercados en tu cuenta.
¿Qué puedo preguntarle a mi asistente de IA?
Revisar tu cuenta
Iniciar sesión en mi cuenta
Listar mis cuentas
Revisar el estado de mi conexión con Capital.com
Investigar mercados
Buscar mercados de bitcoin
Muéstrame los detalles del mercado EURUSD
Obtén los precios históricos de 1 hora para el ORO
Revisar tu portafolio
Mostrar mis posiciones abiertas
Listar mis órdenes activas
Revisar la exposición de mi portafolio
Abrir una operación (primero en modo demo)
Previsualizar la compra de 1.5 de PLATA con stop en 24.50
Crear una propuesta de operación para ORO con un riesgo del 1%
Ejecutar posición con preview_id abc-123 confirm=true
Cerrar posición DEAL_ID confirm=true
Solución de problemas
Primero ejecuta la revisión de estado. Pregúntale a tu asistente de IA: Revisa el estado de mi conexión con Capital.com. La respuesta generalmente te dirá qué está mal.
| Qué ves | Causa más probable | Solución |
|---|---|---|
| «Fallo de autenticación» o «Sesión vencida» | CAP_API_PASSWORD está configurada con tu contraseña de inicio de sesión en lugar de la contraseña de API personalizada que creaste en el paso 1. | Usa la contraseña que creaste durante la generación de la clave API, no la contraseña de inicio de sesión del sitio web. |
| «Límite de frecuencia excedido» | Se enviaron demasiadas solicitudes en poco tiempo. | Espera entre 30 y 60 segundos e inténtalo de nuevo. |
| zsh: event not found (solo en Mac) | Tu contraseña de API contiene un signo de exclamación (!) | Escribe el valor de la contraseña entre comillas simples en la configuración: 'tuContraseña!Aquí' |
| «El servidor no responde» / El servidor no arranca | Ruta de Python incorrecta o el servidor no se instaló correctamente. | Abre la Terminal y ejecuta python -m capital_mcp.server directamente; el mensaje de error será legible. |
| Se muestran menos de 36 herramientas | El servidor arrancó, pero la configuración tiene un error. | Revisa: (1) que todos los marcadores de posición se hayan reemplazado con valores reales, (2) que no falten caracteres de comillas " { }, (3) que la ruta de Python apunte a la carpeta venv y no al Python del sistema. |
| No hay respuesta a ningún comando | El archivo de configuración no se guardó o el asistente de IA no se reinició por completo. | Cierra y vuelve a abrir tu asistente de IA por completo; no te limites a cerrar la ventana. |
| «401 No autorizado» | La clave API venció o fue revocada. | Ve a Ajustes → Integraciones de API en Capital.com y genera una nueva clave. |
| «Conflicto de entorno» | CAP_ENV está configurado en live pero las credenciales son para una cuenta demo. | Actualiza CAP_ENV en tu archivo de configuración para que coincida con tu tipo de cuenta. |
¿Sigues con problemas? Envía una solicitud de soporte e incluye: qué asistente de IA estás usando, tu sistema operativo y el mensaje de error completo.
Preguntas frecuentes
¿Necesito un plan de asistente de IA de pago? Algunos asistentes de IA requieren una suscripción de pago para usar las funciones del MCP. Claude Desktop, por ejemplo, requiere un plan de pago para activar los conectores del MCP. El servidor MCP de Capital.com en sí es gratuito.
¿Necesito una cuenta real? No. El servidor funciona con una cuenta demo y ahí es donde recomendamos que empieces.
¿Mi contraseña de inicio de sesión de Capital.com es la misma que CAP_API_PASSWORD? No. Son distintas. CAP_API_PASSWORD es una contraseña nueva que creas específicamente al generar tu clave API. Usar tu contraseña de inicio de sesión aquí causará un fallo de autenticación.
¿Puede la IA abrir una operación sin que yo lo sepa? No. Cada operación requiere un paso de previsualización seguido de un mensaje de confirmación independiente que contenga confirm=true. El servidor no puede ejecutar una operación sin ambos. El ID de previsualización es de un solo uso y vence inmediatamente después de la ejecución.
¿Qué es CAP_ALLOW_TRADING y debería cambiarlo? Es un interruptor de seguridad. Cuando está en false, el servidor puede mostrarte datos de mercado e información de la cuenta, pero no puede abrir ninguna operación. Cámbialo a true solo cuando hayas probado todo en modo demo y estés listo para operar con dinero real.
¿Qué hace CAP_ALLOWED_EPICS? Limita qué instrumentos puede operar el servidor. Déjalo vacío para permitir todos los mercados en tu cuenta. Añade una lista separada por comas (por ejemplo: PLATA, ORO, EURUSD) para restringirlo.
Veo menos de 36 herramientas en mi asistente de IA. ¿Qué pasa? Pregúntale a tu asistente de IA: Revisa el estado de mi conexión con Capital.com. Las causas más comunes son un error de formato en el archivo JSON de configuración o que la ruta de Python apunta al Python del sistema en lugar de a la carpeta venv.
¿Están seguros mis datos de trading? El servidor se ejecuta localmente en tu computadora. Tu credenciales se guardan solo en tu archivo de configuración local y nunca se envían a terceros. Toda la comunicación con Capital.com utiliza cifrado HTTPS.
¿Puedo usar esto en dos computadoras? Sí. Repite el paso 2 en la segunda máquina usando las mismas credenciales de API del paso 1.
¿Puedo conectarme a más de una cuenta de Capital.com? El servidor se conecta a una cuenta a la vez. Para cambiar, actualiza los 4 valores de CAP_ en tu archivo de configuración y reinicia tu asistente de IA.
Aviso legal: Uso de la API pública con herramientas de terceros
Integración de terceros
Esta página describe cómo los clientes pueden conectar la API pública 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 y no forma parte de los servicios de Capital.com. Capital.com no controla, desarrolla, respalda ni acepta ninguna responsabilidad 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 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 elijas utilizar.
Uso de la API pública
El uso de la API pública es enteramente bajo tu discreción y riesgo. Capital.com pone la API pública a disposición con fines informativos y de trading, 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 acepta ninguna responsabilidad 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, funcionalidad y especificaciones de la API pueden ser modificadas, limitadas, suspendidas o interrumpidas 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 detenidamente antes de utilizar la API.
Proveedor de servicios de solo ejecución y sin asesoría de inversión
Capital.com presta sus servicios bajo la modalidad de solo ejecución. El trading con 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 una asesoría de inversión, una recomendación personal ni una solicitud de oferta 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 toman bajo tu propio riesgo y siguen siendo 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: 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 diferentes de los esperados; y órdenes no deseadas o erróneas resultantes de herramientas o parámetros mal configurados. Capital.com no es responsable de ninguna pérdida derivada de tales riesgos o de la interacción entre sus sistemas y cualquier herramienta de terceros. El rendimiento pasado y cualquier resultado generado por herramientas automatizadas no son indicativos de resultados futuros.
Uso prohibido
La API pública y cualquier herramienta conectada no deben utilizarse para manipular la plataforma, explotar precios o latencia, incurrir en abuso de mercado ni obtener ninguna ventaja injusta. Capital.com se reserva el derecho de restringir, suspender o rescindir el acceso a la API o a tu cuenta cuando considere razonablemente que se ha producido o es probable que se produzca tal uso indebido. 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, la API pública y cualquier herramienta o integración de terceros cumpla con los Términos y condiciones de Capital.com y con 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 utilizarlas. Capital.com recomienda encarecidamente que pruebes a fondo cualquier herramienta o integración automatizada utilizando una cuenta demo antes de conectarlas a un entorno de trading real.