Implementación completa disponible en shinpr sub-agents-mcp
Quería probar Cursor y otras herramientas de codificación con IA emergentes, pero siempre chocaba con los mismos problemas sin subagentes: contaminación de contexto, resultados inconsistentes y agotamiento del contexto a mitad de tarea.
Claude Code resolvió esto con subagentes, asistentes de IA especializados con contextos separados para tareas específicas. Así evitas agotar tokens y mejoras la precisión. Como otras herramientas no lo tenían, construí un servidor MCP que lo hace posible en cualquier entorno compatible con Model Context Protocol.
Qué hacen realmente los subagentes
Los subagentes son asistentes de IA especializados que gestionan una tarea concreta con su propio contexto, procesos claros y salidas reproducibles. Beneficios clave: contexto aislado sin contaminación, precisión orientada a la tarea y resultados consistentes al definirlos una vez en Markdown.
El puente MCP
Cree un servidor MCP que lleva los subagentes de Claude Code a cualquier herramienta compatible con MCP como Cursor o Claude Desktop. Al integrarlo, tu asistente puede invocar un agente especialista que trabaja con un contexto fresco, separado del hilo principal, y te devuelve una salida estructurada adecuada a la tarea.
Cómo funciona
Basta con indicar al asistente que use un subagente para una tarea concreta, por ejemplo revisar un documento o auditar código. El agente especializado se activa con su propio contexto, aplica las reglas definidas en su archivo Markdown y entrega un informe estructurado con hallazgos, severidades y recomendaciones accionables.
Configuración rápida
1 Configura tu herramienta MCP añadiendo el servidor sub-agents y define AGENTS_DIR con una ruta absoluta y AGENT_TYPE con el cliente que vas a usar como cursor o claude. 2 Crea tu primer agente como code-reviewer md describiendo su objetivo, criterios de revisión y estructura de salida. Con eso, ya puedes pedir al asistente que ejecute el subagente code-reviewer sobre un archivo o carpeta.
Consejos para diseñar subagentes eficaces
Da a cada subagente una sola responsabilidad, incluye solo la información necesaria, y divide tareas para que quepan en una ventana de contexto. Recomiendo separar generación de contenido de su revisión, ya que la implementación acumula contexto que no es útil durante la revisión y suele agotar el límite.
Ejemplo de agente revisor de documentos
Un document-reviewer puede definir un objetivo primario evaluar completitud y consistencia, un proceso en fases análisis y validaciones y una salida obligatoria con metadatos, puntuaciones, listado de incidencias con severidades crítica importante recomendada y un veredicto final aprobado rechazado condicional con lógica clara. Las reglas obligan a dar referencias específicas y propuestas accionables.
Retos e implementación
Cursor CLI puede tardar varios minutos según la complejidad, así que conviene ampliar el tiempo de espera del cliente MCP hasta un máximo de diez minutos. Para usar Cursor CLI hay que iniciar sesión con cursor-agent login y renovarla periódicamente. Puedes elegir AGENT_TYPE cursor para Cursor CLI o claude para Claude Code. El servidor expone los archivos de agentes como recursos MCP y ofrece una herramienta run_agent que recibe el nombre del agente, el prompt y parámetros opcionales como directorio de trabajo o argumentos extra. Internamente, pasa el contenido completo del archivo del agente como contexto del sistema al cliente elegido y gestiona la interacción por streaming.
Lecciones aprendidas y próximos pasos
Al principio parecía tan simple como pasar prompts y devolver respuestas, pero la necesidad de streaming y los formatos distintos entre modelos exigieron una buena abstracción. El siguiente hito será soportar salidas en JSON cuando Cursor CLI lo incorpore, lo que abrirá automatizaciones más ricas y fiables. Ideas y mejoras son bienvenidas en el repositorio.
Repositorio Sub-Agents MCP Server en GitHub
Cómo puede ayudarte Q2BSTUDIO
En Q2BSTUDIO somos una empresa de desarrollo de software especializada en aplicaciones a medida y software a medida, con foco en inteligencia artificial, agentes IA e ia para empresas. Integramos subagentes y patrones agentic en tus flujos de trabajo para acelerar la entrega, mejorar la calidad y estandarizar revisiones técnicas. Además ofrecemos ciberseguridad y pentesting, servicios cloud aws y azure, automatización de procesos, y servicios inteligencia de negocio con power bi para convertir tus datos en decisiones. Si quieres aplicar IA práctica en tu organización, descubre cómo lo hacemos en IA para empresas. Y si buscas una solución robusta y escalable, consulta nuestro servicio de desarrollo de software a medida para llevar tus sistemas al siguiente nivel.