Conecta un asistente de IA vía MCP

Antes de empezar

1. Una cuenta de AlgoVesta. La prueba de 7 días es suficiente — no necesitas un plan de pago para probar esto.
2. Un cliente MCP: Claude en web, escritorio o móvil, Claude Code, Cursor, ChatGPT en un plan de pago, Gemini CLI, o cualquier otro que hable Model Context Protocol.
3. Una clave. No necesitas un exchange conectado para empezar: una clave paper ejecuta todo el conjunto de herramientas contra un saldo virtual de $5,000, así que puedes configurarlo todo y practicar antes de que intervenga ninguna cuenta real.

1. Crea tu enlace MCP

1. Abre el panel de AlgoVesta y ve a la pestaña Conexión MCP
2. Haz clic en Crear clave, dale una etiqueta que indique dónde vivirá (por ejemplo claude-desktop o cursor-laptop)
3. Elige un alcance: read solo para preguntas sobre la cartera, paper para el conjunto completo de herramientas contra el saldo virtual de $5,000, o live para órdenes reales
4. Copia la dirección que aparece. Se ve así:

https://api.algovesta.com/u/avmcp_<your-key>/mcp

2. Añádelo a Claude

1. En Claude, abre Configuración → Conectores
2. Haz clic en Añadir conector personalizado
3. Dale un nombre (AlgoVesta) y pega tu enlace MCP en el campo de URL
4. Guarda y luego inicia una conversación nueva — las herramientas aparecen en la lista de herramientas de la conversación

Este conector se sincroniza entre Claude en web, escritorio y móvil, así que añadirlo una vez también cubre tu teléfono. Si prefieres no pegar una dirección secreta, AlgoVesta también ofrece un endpoint estándar OAuth 2.1 en https://api.algovesta.com/mcp con PKCE (S256) y Registro Dinámico de Clientes — apunta el conector ahí en su lugar y se te enviará a través de una pantalla de consentimiento de navegador normal.

3. Añádelo a Claude Code

Un solo comando registra el servidor mediante HTTP en streaming:

claude mcp add --transport http algovesta https://api.algovesta.com/u/avmcp_<your-key>/mcp

Ejecuta claude mcp list después para confirmar que el servidor está registrado y es accesible.

4. Añádelo a Cursor o ChatGPT

Cursor lee un archivo de configuración JSON. Añade una entrada a mcp.json:

{"mcpServers":{"algovesta":{"url":"https://api.algovesta.com/u/avmcp_<your-key>/mcp"}}}

Gemini CLI usa la misma entrada, pero llama al campo httpUrl en lugar de url. Todo lo demás es idéntico.

ChatGPT admite conectores MCP personalizados en planes de pago, con el modo desarrollador activado en la configuración. Añade el conector ahí y pega el mismo enlace.

5. Verifica la conexión

1. Inicia una conversación nueva en tu cliente
2. Pregunta: How is my portfolio?
3. El asistente debería llamar a la herramienta get_portfolio_context y responder con tus saldos reales y posiciones abiertas — con una clave paper, con el saldo virtual de $5,000

Si responde con generalidades sin llamar a ninguna herramienta, el servidor no está conectado: el asistente está hablando sobre trading en general, no sobre tu cuenta. Vuelve a comprobar el enlace y reinicia el cliente.

Qué puede hacer el asistente una vez conectado

Se exponen veinte herramientas. Catorce de ellas leen o simulan y no cambian nada: get_portfolio_context, get_market_price, get_trade_history, compare_venues, simulate_order, list_open_orders, list_strategies, verify_receipt, replay_channel y compile_policy. Seis de ellas mueven órdenes: place_order, close_position, modify_position, cancel_order, create_strategy y update_strategy.

No llamas a estas por su nombre. Pregunta en lenguaje natural — "¿qué tengo en cartera?", "¿cuánto me costaría 0,1 BTC ahora mismo?", "cierra la mitad de mi posición en ETH" — y el asistente elige las herramientas y las encadena. Se requiere un stop-loss en cada posición que abre, y no existe ninguna herramienta para eliminarlo después. Los esquemas completos de cada herramienta están en la documentación para desarrolladores.

401 unauthorized

La clave fue revocada, eliminada, o la dirección está mal escrita. Este es el fallo más común cuando el enlace se pegó a mano o se copió con un espacio al final. Comprueba que la clave todavía existe en la pestaña Conexión MCP; si existe, elimínala y crea una nueva en lugar de intentar reparar la cadena.

insufficient_scope

La herramienta que el asistente intentó llamar necesita un alcance mayor que el que tiene la clave. Una clave read no puede llamar a place_order, y una clave paper no puede acceder a una cuenta real. Los alcances están jerarquizados, así que una herramienta que requiere paper rechaza una clave read. Acepta el límite o emite una clave nueva con el alcance que realmente necesitas — pasar a live requiere un segundo factor.

user_frozen

El interruptor de emergencia está activo en tu cuenta, lo que detiene todas las claves a la vez. Esto es intencional: es el freno de emergencia. Desactívalo en el panel cuando quieras que el trading se reanude. Si solo querías cortar el acceso a un cliente, revoca esa única clave en su lugar — las demás siguen funcionando.

rate_limited

Has superado 60 solicitudes por minuto en esa clave. Se aplican límites más estrictos a las herramientas costosas: place_order está limitada a 10 por minuto y replay_channel a 5 por hora. Espera y vuelve a intentarlo. Ver esto repetidamente normalmente significa que un agente está en un bucle, no que estés operando con rapidez — vale la pena comprobar qué está haciendo realmente el asistente antes de aumentar el límite de solicitudes.