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.
El conector MCP requiere un plan con acceso a la API (TRADER o superior). La URL del servidor es siempre la misma; lo que cambia es cómo te autenticas: OAuth (más simple) o API key (para scripts y Claude Code).
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.
- portfolios: portafolios y sus sesiones.
- metrics: métricas de rendimiento.
- notes / profile: notas y datos de tu perfil.
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.
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.