OpenCode — ИИ-агент с поддержкой MCP-серверов. Его можно подключить к локальному MCP Deskgram 2, чтобы агент получал доступ к разрешённым инструментам программы: например, читал список модулей, схемы параметров и состояние задач. Языковая модель, которую использует OpenCode, настраивается отдельно.
Подготовка Deskgram
Запустите Deskgram и откройте настройки MCP. Задайте токен доступа, включите listener и сохраните настройки. Локальный адрес по умолчанию — http://127.0.0.1:8765/mcp. Если изменили порт, используйте своё значение в конфигурации агента.
Для первой проверки оставьте режим чтения и разрешите только необходимые инструменты. Возможности конкретной сборки проверяются через MCP-каталог; список инструментов может меняться вместе с программой.
Конфигурация OpenCode
Добавьте сервер в конфигурацию OpenCode. Пример использует переменную окружения DESKGRAM_MCP_TOKEN: задайте в ней тот же токен, который сохранили в Deskgram, до запуска агента.
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"deskgram": {
"type": "remote",
"url": "http://127.0.0.1:8765/mcp",
"headers": {
"Authorization": "Bearer {env:DESKGRAM_MCP_TOKEN}"
},
"oauth": false,
"enabled": true
}
}
}
Если конфигурация уже содержит MCP-серверы, добавьте запись deskgram в существующий объект mcp, сохранив остальные настройки. oauth: false используется для подключения с Bearer-токеном вместо автоматической попытки OAuth.
127.0.0.1 относится к компьютеру, на котором работает OpenCode. Если агент запущен в контейнере, на удалённом сервере или в другой среде, этот адрес не будет автоматически указывать на ваш Deskgram.
Первая проверка без запуска задач
Выполните opencode mcp list и проверьте состояние подключения. Затем попросите агента вызвать deskgram_health и deskgram_list_modules. Для знакомства с параметрами используйте deskgram_get_module_schema, например для profile_setup.
Чтение схемы не запускает модуль. Перед созданием задачи проверьте список аккаунтов, параметры, разрешения MCP и режим выполнения. Отдельные инструменты изменения требуют дополнительных разрешений в Deskgram. Наличие инструмента в каталоге не означает, что он разрешён в текущих настройках.
Чем OpenCode отличается от OpenRouter
OpenCode работает как агент: ведёт диалог, выбирает инструменты и обращается к MCP. OpenRouter предоставляет API языковых моделей. Если выбрать OpenRouter в качестве провайдера модели для OpenCode, его ключ и оплату нужно настроить отдельно.
Ключ OpenRouter в настройках Deskgram также не подключает OpenCode к MCP. Для связи агента с программой используется отдельный MCP-токен из примера выше.
Ошибки подключения
- Нет соединения: проверьте, запущен ли Deskgram, включён ли listener и совпадают ли порт и путь
/mcp. - Ошибка авторизации: проверьте значение переменной окружения и заголовок Bearer. После изменения окружения перезапустите OpenCode.
- Проверка адреса браузером вернула 405: обычный GET не проверяет полноценный обмен MCP; используйте MCP-клиент.
- Агент не может выполнить действие: проверьте разрешения и доступную схему инструмента в вашей сборке.
Документация
Официальная инструкция OpenCode по MCP описывает подключение удалённых серверов. Возможности программы собраны на странице MCP Deskgram. Настройка API моделей разобрана отдельно в статье об OpenRouter.
Материал проверен 20 октября 2026 года по документации OpenCode и текущим контрактам Deskgram. Переход ведёт на официальный сайт OpenCode без реферального кода. Эта инструкция не означает официального партнёрства с разработчиками OpenCode; реальные Telegram-действия при её подготовке не запускались.