Un desarrollador de Domclick enseñó a OpenCode a configurarse solo: MCP, skills y permisos en un par de tardes

Vladímir Bandov, desarrollador backend de Domclick, publicó en Habr un análisis de cómo configurar un agente de código en OpenCode Desktop. La primera media hora de configuración transcurrió sin problemas, pero después llegó el caos de skills, servidores MCP, permisos y varios archivos de ajustes. Encontrar un método que funcionara le llevó un par de tardes libres. El autor califica el resultado de «perezoso»: quizá gaste más tokens, pero el agente ayuda a configurarse a sí mismo y no se pone a improvisar.

Dónde falla la configuración

Según el relato de Bandov, la barrera de entrada resultó más alta que la que muestran los vídeos de formación. Instalar el agente lleva unos minutos. Lograr que trabaje de forma predecible es más difícil. El autor señala tres problemas.

Primero: demasiadas entidades. Las skills, MCP, los permisos (permissions) y los distintos niveles de configuración hay que tenerlos presentes a la vez. En algún momento dejó de recordar para qué servía cada skill.

Segundo: el orden de las acciones. Tenía que explicarle al agente una y otra vez que primero hace falta un plan, después los accesos y las configuraciones, y solo al final el lanzamiento de comandos en la terminal.

Tercero: la hiperiniciativa. El agente daba pasos innecesarios e inventaba e implementaba cosas que no formaban parte de la tarea. En un repositorio de trabajo es el riesgo principal: el código sobrante hay que leerlo y revertirlo.

El enfoque perezoso: el agente se configura a sí mismo

La idea que da título al artículo es gestionar la configuración «con las manos del propio agente». En lugar de editar archivos a mano y recordar la sintaxis, el desarrollador plantea la tarea y el agente propone un plan y hace los cambios: conecta MCP, añade skills y escribe los permisos. El autor detalla los pasos completos y los prompts en el original; el anuncio no los incluye.

Contexto para quien no haya seguido el tema. MCP (Model Context Protocol) es un protocolo abierto que Anthropic presentó en noviembre de 2024 para conectar a los modelos herramientas externas y fuentes de datos. OpenCode es un agente de código de código abierto que funciona en la terminal y en un cliente de escritorio. Los permisos de acción se definen en la configuración con el esquema «permitir, preguntar, denegar». Cuando los servidores MCP se multiplican y cada uno ofrece decenas de herramientas, la administración manual se convierte rápidamente en una tarea rutinaria.

También importa el marco de uso. Bandov no delega en el agente el papel de desarrollador de pleno derecho. Para él, el agente es un ayudante: prepara el plan, ejecuta pasos claros y pregunta donde hace falta control. Ese modo explica por qué está dispuesto a pagar con tokens las iteraciones extra de planificación.

Qué se sabe por el anuncio

• Herramienta: OpenCode Desktop.
• Autor: Vladímir Bandov, desarrollador backend de Domclick.
• Tiempo: unos 30 minutos hasta el momento en que la configuración manual se volvió agotadora; un par de tardes más para dar con un esquema que funcionara.
• Componentes: skills, MCP, permisos (permissions), varias configuraciones.
• Problema principal: el agente hace trabajo que no se le pidió.
• Precio de la solución: posiblemente se consumen más tokens.
• El anuncio no incluye mediciones del ahorro de tiempo ni de coste.

Cómo aplicarlo en tu caso

Del material se pueden extraer varias reglas prácticas que no dependen de un cliente concreto.

Empieza por el plan. Si el agente debe describir primero los pasos y solo después obtener acceso a los comandos, fíjalo en las reglas del proyecto para no repetirlo en cada conversación.

Lo mejor es definir los permisos de forma estricta por defecto. Puedes permitir la lectura de archivos, mientras que la escritura y los comandos de shell deberían exigir confirmación. Conviene relajar las restricciones de forma puntual, para una tarea concreta.

Conecta los MCP de uno en uno y comprueba qué herramientas añade cada uno al contexto. Cada servidor consume tokens en las descripciones y amplía la superficie de errores.

Mantén en git las configuraciones que edita el agente y revísalas con diff. Si el agente cambia sus propios permisos, hay que verlo antes del commit.

Por último, mide. Si el esquema «perezoso» realmente cuesta más tokens, evalúalo con tareas reales durante una semana y compáralo con el tiempo que has dejado de dedicar a la configuración manual.