Conectar Claude a TradingNote
Conecta Claude (claude.ai, Claude Desktop o Claude Code) a TradingNote vía el conector MCP para que consulte tus cuentas, algoritmos, backtests y portafolios en lenguaje natural.
TradingNote expone un servidor MCP (Model Context Protocol) público. Conectarlo le da a Claude un conjunto acotado de herramientas para leer y trabajar con tus datos —cuentas, operaciones, algoritmos, exploraciones, backtests, portafolios y métricas— directamente desde el chat. Puedes usarlo en claude.ai, Claude Desktop o Claude Code. Esta guía cubre Claude Code, además de la conexión por OAuth y por API key.
Qué ve Claude depende de tu plan: la prueba gratis de 7 días incluye todo el conector salvo operar en vivo; PRO tiene lectura básica (perfil y cuentas) y Claude te dice qué acciones requieren ELITE; ELITE tiene el conector completo. Con FREE o TRADER, Claude solo puede explicarte tu plan. Las API keys (para scripts y Claude Code) siguen siendo exclusivas de ELITE. La URL del servidor es siempre la misma; lo que cambia es cómo te autenticas: OAuth (más simple) o API key.
URL del servidor
Esta es la única URL que necesitas en cualquier cliente de Claude:
https://app.tradingnote.co/api/mcpCómo conectarte
Claude Code es la CLI de Claude. La forma más directa de conectarlo es con una API key de TradingNote pasada como Bearer token. Primero genera la key, luego registra el servidor MCP.
- 1
Genera tu API key
En TradingNote entra a Ajustes → API Keys, crea una nueva key (puedes limitar permisos por categoría) y cópiala. Empieza por «tn_» y solo se muestra una vez.
- 2
Registra el servidor en Claude Code
Desde tu terminal, ejecuta el comando «claude mcp add» con la URL y tu key como header (ver el bloque de código abajo). Reemplaza tn_<tu-key> por la key real.
- 3
Verifica la conexión
Ejecuta «claude mcp list». Deberías ver «tradingnote» como conectado. Ya puedes pedirle a Claude que consulte tus cuentas, algoritmos o backtests.
claude mcp add --transport http tradingnote https://app.tradingnote.co/api/mcp \
--header "Authorization: Bearer tn_<tu-key>"
# Verificar
claude mcp list¿Prefieres OAuth en Claude Code? También funciona: registra el servidor sin el header y Claude abrirá el flujo de autorización en el navegador la primera vez que uses una herramienta.
OAuth es la forma recomendada en claude.ai y Claude Desktop. No necesitas copiar ninguna key: Claude descubre nuestros endpoints automáticamente, se registra como cliente y te muestra una pantalla de consentimiento donde autorizas el acceso.
- 1
Abre la configuración de conectores
En claude.ai ve a Settings → Connectors → Add custom connector. En Claude Desktop, la opción equivalente está en sus ajustes de conectores.
- 2
Pega la URL del servidor
Usa https://app.tradingnote.co/api/mcp como URL del servidor. Claude detectará OAuth automáticamente y mostrará un botón «Connect».
- 3
Inicia sesión y autoriza
Se abrirá la ventana de TradingNote pidiendo tu login (si no estás logueado) y luego la pantalla de consentimiento con los permisos solicitados. Autoriza y volverás a Claude con el conector ya activo.
En claude.ai también puedes usar una API key: al agregar el conector personalizado, cuando pida headers personalizados agrega «Authorization: Bearer tn_…».
Permisos y scopes
Los permisos se piden en formato «categoría:nivel». El nivel read es solo lectura; write permite crear y editar (nunca borrar, ni modificar el balance, ni tocar operaciones cerradas). Cuando generas una API key puedes limitar qué categorías concede.
- accounts: cuentas conectadas y su estado.
- operations: historial de operaciones.
- strategies / strategyDev: algoritmos y su desarrollo.
- backtesting: resultados de backtests y exploraciones, y tus sesiones de backtest manual — Claude puede crearlas, avanzar el replay, ver el gráfico en ese instante (con indicadores y tus operaciones), abrir, ajustar y cerrar operaciones simuladas y anotarlas. Dinero simulado: no toca ninguna cuenta ni bróker.
- portfolios: portafolios y sus sesiones.
- metrics: métricas de rendimiento.
- notes / profile: notas y datos de tu perfil.
- copyTrading: tus masters y suscripciones de copy trading, su historial y su gestión (ver abajo).
Copy trading desde Claude
Con el permiso copyTrading, Claude ve tu Copy Master tal como lo ves en la app y puede gestionar lo esencial sin salir del chat. Las herramientas son las mismas en el conector MCP y en la API REST /api/v1/tools:
- list_copy_masters: tus cuentas master (estado, visibilidad, seguidores, cuenta origen).
- list_copy_subscriptions y get_copy_subscription: tus suscripciones seguidoras con su modo de riesgo (riskMode), lote fijo, multiplicador, % de riesgo, lote máximo, copia inversa, filtros y límites diarios; el detalle incluye las últimas copias y los mapeos de símbolos.
- get_copy_logs: historial de copias de un master (ejecutadas, rechazadas, pendientes) con la latencia de copia (copyDelayMs) y el motivo de rechazo como código estable; filtra por estado y rango de fechas, con paginación. get_copy_trades y get_copy_signals dan las copias por suscripción y las señales emitidas.
- pause_copy_subscription y resume_copy_subscription: pausan o reanudan una suscripción tuya (las posiciones ya copiadas no se tocan). Pausar es libre; reanudar vuelve a copiar con dinero real, así que exige confirm:true y el interruptor «Permitir operar en vivo desde Claude».
- update_copy_sizing: cambia el tamaño y los límites de una suscripción (riskMode, fixedLotSize, multiplier, riskPercent, maxLotSize, límites diarios, filtros…). Mueve dinero real: exige confirm: true y, como el trading manual, el interruptor «Permitir operar en vivo desde Claude» en Ajustes → Acceso de Claude.
Claude no puede crear ni borrar masters o suscripciones, cerrar las posiciones copiadas ni cancelar pendientes: esas acciones siguen siendo exclusivas de la app. Las herramientas solo ven lo que es tuyo (tus masters y tus suscripciones).
Lo que Claude NO puede hacer
- Borrar cuentas, portafolios ni operaciones.
- Modificar el balance de una cuenta ni las operaciones cerradas.
- Sincronizar con brokers ni colocar órdenes en cuentas live.
- Cambiar tu contraseña, email ni acceder al panel admin.
- Crear o borrar masters y suscripciones de copy trading, ni cerrar las posiciones copiadas.
El conjunto de herramientas disponibles es el único control: si no existe una herramienta para una acción, Claude no puede invocarla. No hay forma de que una conversación «se salte» estos límites.
¿El conector no aparece o falla la autorización? Verifica que tu plan incluya acceso a la API, que la URL sea exactamente https://app.tradingnote.co/api/mcp y, si usas API key, que la hayas pegado completa con el prefijo «tn_». Si el problema persiste, escríbenos desde Soporte.