Разработчик Домклика научил OpenCode настраивать себя: MCP, навыки и права за пару вечеров

Backend-разработчик Домклика Владимир Бандов опубликовал на Habr разбор настройки coding-агента в OpenCode Desktop. Первые полчаса конфигурации прошли без проблем, а потом начался хаос из навыков, MCP-серверов, разрешений и нескольких файлов настроек. На поиск рабочего подхода ушла пара свободных вечеров. Результат автор называет «ленивым»: возможно, он тратит больше токенов, зато агент помогает настраивать сам себя и не уходит в самодеятельность.

Где ломается настройка

По рассказу Бандова, порог входа оказался выше, чем в обучающих видео. Агент можно поставить за несколько минут. Заставить его работать предсказуемо сложнее. Автор называет три проблемы.

Первая: слишком много сущностей. Навыки (skills), MCP, permissions и разные уровни конфигурации нужно держать в голове одновременно. В какой-то момент он перестал помнить, какой навык для чего нужен.

Вторая: порядок действий. Агенту приходилось раз за разом объяснять, что сначала нужен план, потом доступы и конфигурации, и только затем запуск команд в терминале.

Третья: гиперинициативность. Агент делал лишние шаги, придумывал и реализовывал то, что не входило в задачу. Для рабочего репозитория это главный риск: лишний код приходится читать и откатывать.

Ленивый подход: агент настраивает самого себя

Идея из заголовка статьи такова: управлять конфигурацией «руками самого агента». Вместо того чтобы вручную править файлы и помнить синтаксис, разработчик ставит задачу, а агент предлагает план и вносит изменения: подключает MCP, добавляет навыки, прописывает разрешения. Полные шаги и промпты автор разбирает в оригинале, в анонсе их нет.

Контекст для тех, кто не следил. MCP (Model Context Protocol) — открытый протокол, который Anthropic представила в ноябре 2024 года для подключения к моделям внешних инструментов и источников данных. OpenCode — open-source coding-агент, который работает в терминале и десктопном клиенте. Права на действия в нём задаются конфигурацией по схеме «разрешить, спросить, запретить». Когда MCP-серверов становится несколько, а у каждого десятки инструментов, ручное администрирование быстро превращается в рутину.

Важна и рамка использования. Бандов не делегирует агенту роль полноценного разработчика. Агент для него помощник: он готовит план, выполняет понятные шаги и спрашивает там, где нужен контроль. Такой режим объясняет и готовность платить токенами за лишние итерации планирования.

Что известно по анонсу

• Инструмент: OpenCode Desktop.
• Автор: Владимир Бандов, backend-разработчик Домклика.
• Время: около 30 минут до момента, когда ручная настройка стала утомительной; ещё пара вечеров на рабочую схему.
• Компоненты: навыки (skills), MCP, permissions, несколько конфигураций.
• Главная проблема: агент выполняет работу, о которой его не просили.
• Цена решения: возможно, больше расходуется токенов.
• Замеров экономии времени и стоимости в анонсе нет.

Как применить это у себя

От материала можно взять несколько практических правил, которые не зависят от конкретного клиента.

Начинайте с плана. Если агент должен сначала описать шаги и только потом получить доступ к командам, закрепите это в правилах проекта, чтобы не повторять в каждом диалоге.

Разрешения лучше задавать по умолчанию строго. Чтение файлов можно разрешить, запись и shell-команды пусть требуют подтверждения. Ослаблять ограничения лучше точечно, под конкретную задачу.

MCP подключайте по одному и смотрите, какие инструменты он добавляет в контекст. Каждый сервер расходует токены на описания и расширяет поверхность для ошибок.

Конфиги, которые правит агент, держите в git и просматривайте через diff. Если он меняет собственные права, это нужно видеть до коммита.

Наконец, замеряйте. Если «ленивая» схема действительно стоит больше токенов, оцените это на реальных задачах за неделю и сравните с тем временем, которое вы перестали тратить на ручную настройку.