Как настроить coding-агент, MCP и разрешения

Backend-разработчик Владимир Бандов из компании Домклик опубликовал на Хабре разбор того, как он настраивает coding-агента в OpenCode Desktop. По его словам, долгое время он отказывался от использования агентов, считая, что справится сам, но после перехода на них столкнулся с обратной проблемой — избыточной инициативностью модели и сложностью конфигурации.

Основная трудность, по описанию автора, — обилие сущностей: навыки (Skills), MCP-инструменты, плагины, команды и разрешения (Permissions). Через неделю работы он уже не помнил, что именно подключено и где это лежит, а агент нередко выполнял лишние шаги и реализовывал задачи, которых ему не ставили.

Решение Бандов свёл к простой схеме из двух команд и одного файла справки. Команда /add принимает запрос на естественном языке, передаёт его навыку environment-manager, который ищет готовые решения и предлагает план с таблицей вариантов. Команда /help читает файл HELP.md и показывает только релевантный раздел, не проводя полный аудит среды — это экономит токены.

Ключевой принцип — агент не меняет конфигурацию самостоятельно. Любое изменение сначала оформляется как Diff и выполняется только после подтверждения пользователя словом «ДЕЛАЕМ!». После подтверждённого изменения HELP.md обновляется в том же плане, чтобы справка не устаревала.

Отдельное внимание уделено разрешениям: в OpenCode есть три режима — allow, ask и deny, причём при совпадении нескольких правил побеждает последнее. Автор придерживается правила «чем необратимее действие, тем строже режим»: новые MCP-инструменты всегда стартуют в режиме ask, а write-доступ к PostgreSQL, почте, облаку и базам без отдельного запроса не выдаётся.

Бандов честно перечисляет ограничения подхода. Загрузка навыка и правило «не выходить за рамки задачи» — это инструкции модели, а не технический запрет; HELP.md может устаревать, а runtime-статус MCP через /help не проверяется — его нужно смотреть в интерфейсе. Реальной защитой он называет не текст промпта, а Diff, подтверждение и разрешения.

Автор подчёркивает, что переносится именно паттерн, а не файлы один к одному: естественный запрос, анализ вариантов, Diff, подтверждение и обновление справки. Старые файлы .claude/commands/*.md продолжают работать, а $ARGUMENTS раскрывается в строку аргументов. В финале Бандов спрашивает читателей, как они «кодируют» своих агентов для удобной работы.