Servidor MCP: conecta Claude, ChatGPT y agentes de IA a MetaTrader 5

fxapis ejecuta un servidor alojado de Model Context Protocol (MCP). Agrégalo a una app de IA, inicia sesión en fxapis, y el asistente puede leer tus cuentas de MetaTrader 5, tus posiciones, tus órdenes y tu historial. Si lo permites, también puede operar.

https://api.fxapis.com/mcp

No hay nada que instalar. Las terminales de MT5 corren en nuestra nube de la UE, como en cada llamada a fxapis. Funciona con cualquier broker de MT5.

Todos los planes incluyen el conector: Personal ($9 al mes o $90 al año), Production ($99 al mes), Business ($749 al mes) y Enterprise. También la prueba gratuita de 14 días del plan que elijas, en hasta 5 cuentas demo, sin tarjeta. No hay plan gratuito.

Cómo funcionaCopiar el enlace

• Inicias sesión; no hay clave que copiar. La primera vez que la app usa fxapis, abre la página de inicio de sesión de fxapis. Tú eliges qué puede hacer:
  • Acceso de lectura: cuentas, posiciones, órdenes, deals, cifras y cotizaciones. Siempre está incluido.
  • Trading: apagado por defecto. Actívalo por cuenta: todo lo que la app cambia —abrir, cerrar, stops, cancelar, poner en línea, desconectar— se limita a las cuentas que elijas. Requiere tener activada la verificación en dos pasos; tu sesión ya la demostró al iniciar sesión, así que aquí no hay código que escribir. También puedes definir un tamaño máximo de orden y un número de órdenes por día.
• Revoca cuando quieras. Cada app que conectas aparece en la página de API keys, en Connected apps, con la última vez que se usó. Revoke termina su acceso en su siguiente solicitud. Quitar a alguien del workspace, o cambiar su rol, revoca las apps que conectó.
• Las mismas reglas que la API REST. Una app conectada actúa a través de los endpoints normales de /v1 con exactamente lo que elegiste. Se aplican el aislamiento del workspace, los límites de frecuencia, los límites del plan, la idempotencia y nuestro interruptor de emergencia de trading. Cada llamada a una herramienta cuenta como una o dos llamadas a la API en tu plan.
• Las API keys siguen funcionando para scripts y agentes sin supervisión: envía Authorization: Bearer fx_live_… o X-API-Key. Consulta Agentes con una API key.
• Lo que falta a propósito: conectar una cuenta de MT5 y gestionar claves. Conectar requiere la contraseña del broker, que nunca debe pasar por un modelo de IA. Haz ambas cosas en la consola.

Por dentro:

• el servidor habla Streamable HTTP, sin estado, en las revisiones del protocolo 2026-07-28 y 2025;
• el inicio de sesión es OAuth 2.1 con PKCE, como pide la especificación de autorización de MCP, y se descubre desde https://api.fxapis.com/.well-known/oauth-protected-resource/mcp;
• initialize y tools/list responden sin iniciar sesión. Una llamada a una herramienta sin credencial recibe 401 con un desafío WWW-Authenticate que dirige a la app al inicio de sesión.

Conecta tu appCopiar el enlace

Claude (claude.ai y Claude Desktop)Copiar el enlace

En cualquier plan de Claude:

1. Abre Customize → Connectors → Add custom connector. En Team y Enterprise, un Owner lo agrega en Organization settings → Connectors.
2. Remote MCP server URL: https://api.fxapis.com/mcp. Deja vacíos los campos del cliente OAuth: Claude se registra solo.
3. Haz clic en Connect e inicia sesión en fxapis en la ventana que se abre. Elige solo lectura o trading, y permítelo.

Los conectores que agregas en claude.ai también están en la app de escritorio de Claude.

Claude CodeCopiar el enlace

claude mcp add --transport http fxapis https://api.fxapis.com/mcp

Luego ejecuta /mcp, elige fxapis y Authenticate: tu navegador abre el inicio de sesión de fxapis.

O instala el plugin de fxapis. Agrega el servidor, una skill de trading seguro y un hook que confirma cada operación:

/plugin marketplace add FXapis/fxapis-claude-plugins
/plugin install fxapis@fxapis

ChatGPTCopiar el enlace

Agrégalo en ChatGPT en la web:

1. Abre Plugins, elige + y luego Add custom MCP server.
2. URL: https://api.fxapis.com/mcp, o https://api.fxapis.com/mcp/insights para el conector de solo lectura.
3. Authentication: OAuth. Inicia sesión en fxapis cuando ChatGPT lo pida.

Lo que ChatGPT permite depende de tu plan de ChatGPT. La página de ayuda de OpenAI, Connecting custom MCP servers in ChatGPT (revisada el 26 de octubre de 2026), indica MCP completo, incluidas las acciones que cambian cosas, para Business, Enterprise y Edu, y solo lectura y consulta para Pro. En Business, solo los owners y admins del workspace pueden agregar uno. Configura la app para que pregunte antes de actuar.

Cursor, VS Code y otros clientesCopiar el enlace

Cualquier cliente compatible con el inicio de sesión OAuth de MCP se conecta solo con la URL. fxapis acepta direcciones de retorno del inicio de sesión para Claude, ChatGPT y apps en tu propia computadora (http://localhost y http://127.0.0.1). Los clientes que vuelven a un esquema personalizado, como cursor:// o vscode://, todavía no se aceptan: usa una API key con ellos.

Para probar desde una terminal con el MCP Inspector:

npx @modelcontextprotocol/inspector https://api.fxapis.com/mcp

Agentes con una API keyCopiar el enlace

Para un agente que corre sin supervisión, crea una clave solo para él, con los mínimos alcances que hagan el trabajo:

Envíala como Authorization: Bearer fx_live_…, o como X-API-Key: fx_live_… para los clientes que solo ofrecen ese encabezado.

Claude Code, con una clave:

claude mcp add --transport http fxapis https://api.fxapis.com/mcp --header "Authorization: Bearer $FXAPIS_KEY"

Cursor (~/.cursor/mcp.json):

{ "mcpServers": { "fxapis": { "url": "https://api.fxapis.com/mcp", "headers": { "Authorization": "Bearer ${env:FXAPIS_KEY}" } } } }

VS Code (.vscode/mcp.json):

{
  "inputs": [{ "type": "promptString", "id": "fxapis-key", "description": "fxapis API key", "password": true }],
  "servers": { "fxapis": { "type": "http", "url": "https://api.fxapis.com/mcp", "headers": { "Authorization": "Bearer ${input:fxapis-key}" } } }
}

API de OpenAI (Responses). Pon esto en los tools de la solicitud:

{ "type": "mcp", "server_label": "fxapis", "server_url": "https://api.fxapis.com/mcp", "authorization": "fx_live_…", "require_approval": "always" }

API de Anthropic (Messages). Usa mcp_servers: [{ "type": "url", "url": "https://api.fxapis.com/mcp", "name": "fxapis", "authorization_token": "fx_live_…" }], con una herramienta mcp_toolset para fxapis, como describe la documentación del conector MCP de Anthropic.

Todas las configuraciones también están en fxapis-mcp-examples.

Revocar el accesoCopiar el enlace

• Una app conectada: en la página de API keys, en Connected apps, elige Revoke.
  • Su acceso termina en su siguiente solicitud, su inicio de sesión ya no se puede renovar y se cancela cualquier inicio de sesión todavía en curso.
  • Los owners y admins ven y revocan las apps conectadas de todos. Los members ven las suyas.
• Una clave: revócala en la misma página. Se rechaza desde su siguiente solicitud.

HerramientasCopiar el enlace

Los argumentos están en snake_case. Los ids de cuenta son los UUID de fxapis que da list_accounts, no los logins de MT5. Los volúmenes y los precios son strings ("0.10", "1.08450").

Los resultados son pequeños por diseño:

• una línea para el modelo, más los datos una sola vez como JSON compacto;
• response_format: "detailed" agrega cada campo que tiene la API;
• las listas responden { items, next_cursor, total } de 25 en 25; devuelve next_cursor como cursor.

Responder una pregunta en una llamadaCopiar el enlace

Solo lecturaCopiar el enlace

Ciclo de vida de la cuentaCopiar el enlace

TradingCopiar el enlace

Están marcadas como destructiveHint: true, así que Claude y otros clientes cuidadosos preguntan antes de cada una. Cada una requiere un idempotency_key: un UUID nuevo por acción, y el mismo solo para reintentar esa acción. Con él, una orden reintentada nunca es una segunda orden, y un cierre reintentado nunca es una posición opuesta.

Una app conectada a la que no se le permitió operar y que llama a una herramienta de trading recibe 403 con WWW-Authenticate: Bearer error="insufficient_scope", scope="… trading:execute". La app entonces te pide volver a iniciar sesión, y la página de inicio de sesión se abre con Trading seleccionado.

ErroresCopiar el enlace

Un fallo vuelve como un error de herramienta de MCP (isError: true) cuyo texto empieza con el código de error propio de la API, seguido del mensaje, cualquier details, qué hacer a continuación y el id de la solicitud (en inglés):

ORDER_UNRESOLVED (HTTP 503): Something went wrong and we do not know yet whether the order was sent. We are confirming it with the broker. Do not resend it.
details: [{"orderId":"5b0e7c1a-2f4d-4a8e-9c3b-1d6f0e2a7b94","state":"unknown","retryable":false}]
Next step: Do NOT resend this order. Its outcome is unknown and it may be live at the broker. Poll get_order with the orderId in details until it leaves `unknown`, and tell the user.
requestId: 3f8a1c92-7b4e-4d81-a2f6-0c5e9b3d7a14

El mismo código, estado, mensaje, id de solicitud y siguiente paso están en el _meta del resultado, en com.fxapis/error, para los programas.

Los códigos que más le importan a un agente:

Cada código y su siguiente paso: códigos de error en la skill (en inglés).

Modelo de seguridadCopiar el enlace

Un agente es un nuevo tipo de llamador. Puede malinterpretar una petición, actuar según un texto plantado en una página web o entrar en un bucle. Las protecciones, de la más fuerte a la más débil:

1. Lo que permitiste. Lo aplica la API en cada llamada, decida lo que decida el modelo:

   • lo que eligió una app conectada en la página de inicio de sesión: solo lectura, o trading en las cuentas que elegiste, dentro de los límites de tamaño y diarios que definiste;
   • los alcances y los límites de una clave.

   Una conexión de solo lectura no puede operar. Una conexión con trading no puede cambiar nada en una cuenta que no elegiste: no puede abrir, cerrar, mover stops ni cancelar órdenes ahí, ni poner esa cuenta en línea o desconectarla. Igual puede leer todas las cuentas del workspace.

2. Verificación en dos pasos para operar. Permitir que una app opere requiere tener activada la verificación en dos pasos; iniciar sesión con ella ya la demostró, así que no se pide nada más al dar el consentimiento.

3. Cuentas demo. fxapis no tiene un mercado simulado. Las cuentas demo de los brokers son la forma de probar.

4. Los límites de tu plan y los límites de frecuencia. Cerrar nunca se rechaza por facturación.

5. Las confirmaciones de tu app. Las herramientas de trading están marcadas como destructivas, así que Claude pregunta antes de cada operación. El plugin de Claude Code lo convierte en una regla, y rechaza las cuentas reales hasta que lo permitas.

6. Las descripciones de las herramientas y la skill. Le dicen al modelo que confirme cada operación y que nunca reenvíe una orden sin resolver. Eso orienta el comportamiento; no impone nada. Los puntos 1 y 2 sí.

Cada orden que envía un agente queda registrada como cualquier otra, con la clave o la app conectada que la envió. Las llamadas a herramientas se registran con el nombre de la herramienta, el workspace y el resultado, nunca con los argumentos.

DirectoriosCopiar el enlace

Los directorios de apps de Claude y de ChatGPT no listan herramientas que ejecutan transacciones financieras. Por eso:

• el servidor completo de arriba se agrega por URL, o a través del plugin de Claude Code;
• el conector de solo lectura, que nunca opera, es el que estamos enviando a los directorios. Todavía no aparece ahí: mientras tanto, agrégalo por URL.

Ejemplos de promptsCopiar el enlace

• "¿Cuáles de mis cuentas de MT5 están en línea, y qué posiciones hay abiertas en cada una?"
• "¿Cuál fue mi ganancia realizada en EURUSD esta semana en mi cuenta demo?"
• "¿Cuánto margen necesitarían 0.5 lotes de XAUUSD en la cuenta 2?"
• "Pon en línea todas mis cuentas y avísame cuando estén listas."
• "Mueve el stop loss de mi posición de oro a break-even." (necesita trading:reduce)
• "Cierra la mitad de cada posición abierta de EURUSD en la cuenta demo." (necesita trading:reduce)
• "Compra 0.01 lotes de EURUSD en la cuenta demo con un stop de 20 pips." (necesita trading:execute)
• "¿Algo salió mal con las órdenes de hoy? Muéstrame las que sigan en unknown."

Límites actuales del servidor MCPCopiar el enlace

• Sin streaming ni notificaciones. Las herramientas responden una vez. Sigue a una cuenta que se pone en línea, o a una orden multicuenta que se liquida, consultando repetidamente, como con la API REST. Para tu propio servidor, usa webhooks.
• Los retornos del inicio de sesión a esquemas personalizados (cursor://, vscode://) todavía no se aceptan. Usa una API key con esos clientes.
• Solo MetaTrader 5. MT4 no es compatible.