Cómo configurar el servidor MCP de Capital.com

¿Tiene más preguntas? Enviar una solicitud

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

  1. 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.
  1. Descarga el MCP desde Github
  • La URL del sitio web es: https://github.com/capital-com-sv/capital-mcp

  1. Abre el paquete MCPB
  • Haz doble clic en el paquete para ejecutarlo o simplemente arrastra el archivo a tu ventana de Claude Desktop.

  1. Ingresa tus credenciales de API
  • Claude Desktop te solicitará los datos de tu API. Ingrésalos y selecciona «Instalar». No olvides activar el MCP.
  1. 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:

  1. Activa la 2FA si aún no lo has hecho. Ajustes → Autenticación de dos factores.
  2. Genera una nueva clave API. Ajustes → Integraciones de API → Generar clave API.
  3. Ponle una etiqueta a tu clave (por ejemplo: Servidor MCP).
  4. 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.

  1. Ingresa tu código 2FA y haz clic en Generar.
  2. 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.

Artículos en esta sección

¿Fue útil este artículo?
Usuarios a los que les pareció útil: 0 de 0