Bienvenido a la documentación de megvec

Bienvenida

megvec es un terminal de análisis de trading: el mundo macro en vivo, un motor de charts de precisión, búsqueda vectorial de patrones y una bitácora conectada. Se conecta a tu MetaTrader 5 mediante un complemento de escritorio y funciona en el navegador desde megvec.xyz/vta.

La documentación se organiza en tres bloques: la plataforma VTA (la terminal), el agente (la IA que la opera) y el conector MCP (que convierte tu CLI en ese agente).

Primeros pasos

1. Descarga el complemento VTA. Instala VTA-Setup.exe desde la descarga. Detecta e instala MetaTrader 5 si te falta y se actualiza solo.
2. Inicia sesión una vez en el complemento con tu usuario de megvec.
3. Entra a la plataforma en megvec.xyz/vta y opera con tu MT5 conectado.
4. (Opcional) Activa el agente: pon una API key en Ajustes, o conecta tu CLI por MCP.

La plataforma VTA

Mundo y contexto

Un globo real con macro, noticias, tasas, bonos, order-flow, sentimiento y fuerza relativa de divisas. Es la vista con la que obtienes contexto antes de operar: qué mueve al mercado hoy y cómo se relacionan las divisas entre sí.

Chart y dibujos

Motor de velas nítidas con el precio del servidor de tu bróker en vivo. Temporalidades de 1m a 1M agregadas al vuelo, dibujos (tendencias, rayos, líneas, rectángulos, fibos, texto), plantillas e indicadores programables.

Búsqueda vectorial de patrones

Selecciona un patrón (un rango de velas) y VTA recorre un espacio de mercados × años buscando análogos. Guarda informes, actívalos para predecir y fija predicciones en el chart.

Bittrade — tu bitácora conectada

Trades, análisis, estrategias y notas enlazados como un segundo cerebro estilo Obsidian, con un grafo navegable. Los archivos .bitacora, .analisis, .trade y .estrategia son la memoria de trabajo del agente.

Cuentas, MT5 y bots

Conecta tu MetaTrader 5 con el complemento VTA. Define reglas de cuenta (fondeo), opera, y crea bots con código MT5 que se validan con el motor de backtest determinista (replay en vivo + Monte Carlo) antes de activarse.

El agente

El agente puede ver y hacer todo lo que un usuario: analiza velas reales, lee el contexto macro, dibuja en el chart, lanza búsquedas de patrones, gestiona bots y opera — sin que estés pendiente.

Cómo funciona

Existe un solo runtime de agente, que se ejecuta en tu navegador contra la interfaz (execTool → window.vt). El agente puede llegar por dos caminos, ambos con el mismo motor:

• API propia: pones una API key (Anthropic, DeepSeek, OpenRouter) en Ajustes y el agente corre con ese modelo.
• Por MCP: una CLI externa (Claude Code, …) se conecta y se convierte en el agente — encola acciones que tu navegador ejecuta con el mismo motor.

Como siempre corre el mismo ejecutor, el comportamiento y el modo «Seguir» son idénticos: cada acción navega tu interfaz a la vista correspondiente, en vivo.

Seguir y memoria

Seguir: activa el botón «Seguir» en el chat y la interfaz refleja en vivo cada acción de esa sesión; las tarjetas de acción seguidas quedan con borde azul.

Memoria: el agente recuerda lo que le importa de ti en la nota bittick agente/memoria.md. Es visible y borrable: borrar la nota = el agente olvida todo sobre ti. El agente añade recuerdos con la acción remember.

El conector MCP

El MCP VTA no tiene herramientas propias de trading. Cuando tu CLI se conecta, se vuelve el agente: su pensamiento y sus respuestas aparecen en el chat de la plataforma, y las acciones las ejecuta tu navegador con el mismo motor que el agente local. No importa el contexto con el que llegue la IA; importa lo que le pidas por el chat.

Instalar en tu CLI (un comando)

El instalador hace dos cosas: registra el MCP VTA en tu CLI e instala el daemon de activación como servicio del sistema con auto-arranque y auto-reinicio. Desde la raíz del repo:

# toma las credenciales del bloque VTA de .mcp.json
python vta-mcp/install.py

# o pásalas explícitas
python vta-mcp/install.py --user tu-usuario --pass tu-clave

Para Claude Code el MCP se registra solo (claude mcp add-json, scope usuario). En Windows crea una Tarea Programada (inicio de sesión + reinicio ante fallo); en macOS un launchd con KeepAlive; en Linux un servicio systemd --user con Restart=always. Al terminar, reinicia tu CLI para que cargue el MCP.

"VTA": {
  "command": "python",
  "args": ["C:\\ruta\\al\\repo\\vta-mcp\\server.py"],
  "env": {
    "VTA_BASE_URL": "https://megvec.xyz",
    "VTA_USER": "tu-usuario",
    "VTA_PASS": "tu-clave",
    "VTA_CLI": "Claude Code"
  }
}

Plugin y daemon de activación

Un servidor MCP es pasivo: solo corre cuando la CLI lo llama. Para que la plataforma pueda abrir una sesión de chat en tu CLI cuando le escribes desde megvec, hace falta un daemon que escuche la señal del servidor y lance la CLI headless.

El plugin vta-agente lo empaqueta todo para Claude Code: el MCP VTA más un hook SessionStart que mantiene vivo el daemon (ensure_daemon.py, idempotente y multiplataforma). Así, instalar el plugin = MCP + daemon auto-reiniciable en un paso.

1. Instalas el MCP/plugin en tu CLI (instalador o manual).
2. El daemon queda vivo y se re-arranca solo (servicio del SO + hook de la CLI).
3. Le escribes al agente desde megvec; si no hay nadie atendiendo, el daemon despierta tu CLI con el modelo elegido y responde.

Otras CLIs (opencode, etc.)

Funciona con cualquier CLI que tenga MCP y un modo headless. Instala el MCP en esa CLI, contáctate una vez desde ella (para que quede registrada en la plataforma) y dile al daemon cómo lanzarla con una plantilla de arranque:

python vta-mcp/install.py --cli opencode \
    --launch-argv '["opencode","run","--model","{model}","{prompt}"]'

Placeholders de la plantilla: {prompt}, {model}, {model_label}, {mcp_config}, {cli}. Cada daemon responde solo a las señales dirigidas a su CLI.

La CLI y el modelo en el chat

En el chat de la plataforma, el selector superior elige la fuente (un proveedor de API con key guardada, o una CLI contactada por MCP) y el selector inferior, el modelo de esa fuente.

• Sin ninguna API key verificada, no aparece ningún modelo de API — solo las CLIs que se hayan contactado.
• Cada CLI registrada aparece con sus modelos, aunque no haya una IA viva ahora mismo.
• Elige una CLI + modelo y escribe: si el dispositivo de esa CLI está encendido, el daemon abre una sesión automática con ese modelo. El chat muestra «<CLI> · <modelo>» (p. ej. «Claude Code · Opus 4.8»), no «vía MCP».

Las 6 primitivas del MCP

El bucle del agente: connect → atiende pendientes (think/act/say) → poll en bucle → disconnect al terminar.

Catálogo de acciones (vta_act)

Es la misma superficie que un usuario. Nombres e input salen del contract que devuelve vta_connect. Un resumen:

Solución de problemas