Trama + Alpaca: practica en un broker con tu IA

Alpaca es un broker de Estados Unidos con cuenta de práctica gratuita: dinero ficticio y precios reales del mercado de EE. UU. Tiene un conector MCP oficial. Si agregas en tu app de IA el conector de Trama y el de Alpaca, en una misma conversación puedes crear y probar la estrategia con Trama y llevar las órdenes a tu cuenta de práctica de Alpaca.

Trama no se conecta a tu cuenta de Alpaca ni ve tus claves: el conector de Alpaca corre en tu computadora y habla directo con Alpaca. Trama no tiene relación comercial con Alpaca ni cobra por esto.

Qué necesitas

• Una cuenta de práctica (Paper) en alpaca.markets. Es gratis.
• Una app de IA que acepte conectores locales: Claude Desktop, Claude Code, Cursor o VS Code. Claude en el navegador y ChatGPT todavía no: el conector de Alpaca tiene que correr en tu computadora.
• El conector de Trama ya agregado en esa app (mira la guía «Conector MCP»).
• uv, el programa que arranca el conector de Alpaca. Se instala una sola vez desde docs.astral.sh/uv.

Paso a paso

1. En Alpaca, entra a tu cuenta Paper y genera tus claves de API (Key ID y Secret Key).
2. Instala uv y reinicia la computadora si te lo pide.
3. Agrega Alpaca a tu app con el bloque de abajo, poniendo tus claves. En Claude Desktop va en el archivo claude_desktop_config.json (Ajustes → Desarrollador → Editar configuración); en Cursor, en ~/.cursor/mcp.json; en VS Code, en .vscode/mcp.json con «servers» en lugar de «mcpServers».
4. Cierra y vuelve a abrir la app, y pregunta: «¿Cuánto saldo tiene mi cuenta de práctica de Alpaca?». Si responde con tu saldo, ya está.

{
  "mcpServers": {
    "alpaca": {
      "command": "uvx",
      "args": ["alpaca-mcp-server"],
      "env": {
        "ALPACA_API_KEY": "tu Key ID de la cuenta Paper",
        "ALPACA_SECRET_KEY": "tu Secret Key de la cuenta Paper",
        "ALPACA_PAPER_TRADE": "true"
      }
    }
  }
}

Tus claves quedan solo en ese archivo de tu computadora. Nunca las pegues en el chat ni en Trama. Con ALPACA_PAPER_TRADE en «true» y claves de la cuenta Paper, el conector solo puede operar en práctica.

Cómo usarlos juntos

Pídele a tu IA cada paso en lenguaje normal. Por ejemplo:

1. «Con Trama, busca en la biblioteca una estrategia de tendencia para NVDA en velas diarias y córrele un backtest.»
2. «¿La estrategia está comprada hoy? Fíjate si la última operación del backtest sigue abierta.»
3. «Si está comprada, en mi cuenta de práctica de Alpaca compra NVDA por 1.000 dólares con un stop a la misma distancia que usa la estrategia. Muéstrame la orden antes de enviarla.»
4. «Muéstrame mis posiciones y órdenes abiertas en Alpaca.»

Lo que tienes que saber

• No es un bot automático: la IA envía cada orden cuando tú se lo pides. Si quieres que la estrategia corra sola, activa el bot de práctica de Trama con avisos por Telegram y, cuando llegue un aviso, lleva la orden a Alpaca desde tu IA.
• Los precios no son los mismos: Trama prueba con los perpetuos de Hyperliquid, que operan las 24 horas; Alpaca opera las acciones reales en el horario de la bolsa de EE. UU. Lo que pase en Alpaca puede diferir del backtest.
• Revisa cada orden antes de confirmar: la IA puede equivocarse de activo, cantidad o lado.
• Esta guía es para la cuenta de práctica. Operar con dinero real tiene riesgo de pérdida y depende de las reglas de Alpaca y de tu país.

Si algo falla

• La app no muestra las herramientas de Alpaca: revisa que el archivo no tenga comas o llaves de más y vuelve a abrir la app.
• Error de claves: genera claves nuevas dentro de la cuenta Paper. Las de una cuenta real no sirven en práctica, y al revés.
• La app dice que no encuentra «uvx»: instala uv, reinicia la computadora y vuelve a abrir la app.