Плагины OpenCode: когда ставить расширение и как проверить его перед запуском
Как выбрать и подключить плагин OpenCode, чем он отличается от MCP-сервера и skills, и какие проверки сделать до выдачи расширению доступа к проекту.
Плагин меняет поведение самого OpenCode: например, добавляет интеграцию или реагирует на события. Это мощный механизм, но нужен он далеко не всегда. Иногда задачу проще решить короткой инструкцией или одним MCP-сервером.
Плагин, skill или MCP
| Механизм | Что добавляет | Когда подходит |
|---|---|---|
| Skill | Инструкцию для агента | Нужен порядок работы или правила проекта |
| MCP-сервер | Инструменты и данные | Агенту требуется читать сервис, API или базу |
| Плагин | Расширение поведения OpenCode | Нужна логика, не выражаемая инструкцией |
Если достаточно чек-листа, хватит skill. Если агенту нужно забрать список задач из сервиса, скорее подойдёт MCP. Чем меньше движущихся частей, тем легче потом понять, почему после обновления что-то изменилось.
Как выбрать расширение
Начни с документации или репозитория автора. Посмотри, с какой версией OpenCode работает плагин, давно ли его обновляли и каких прав он просит. Одного знакомого названия в npm недостаточно: пакет может оказаться чужим или заброшенным, поэтому переходи по ссылке из надёжного источника.
До установки загляни в настройки. Плагин может видеть конфигурацию, переменные окружения и файлы проекта, а иногда ещё и отправлять данные в сеть. Эти возможности должны быть понятно связаны с его задачей. Просьба вставить токен прямо в конфиг проекта — хороший повод остановиться и проверить инструкцию ещё раз.
Подключение и первый тест
Установи плагин по инструкции для своей версии OpenCode, перезапусти агент и проверь одно заметное действие: появилась ли команда, сработал ли обработчик, не возникла ли ошибка в логе. Плагин, который меняет файлы, лучше впервые запускать на отдельной ветке или копии проекта.
Не обновляй одновременно OpenCode, плагин и конфигурацию — иначе при сбое будет трудно найти виновника. Запиши рабочую версию и сохрани минимальный конфиг без секретов. Для диагностики пригодится «OpenCode не работает»; если нужен доступ к сервису, а не новый код в агенте, настрой MCP-сервер.