Cline MCP сервер: генерация изображений прямо из редактора

Удалённый MCP-сервер в Cline — это набор готовых инструментов, которые агент вызывает по HTTP. Достаточно добавить один блок в JSON-настройки MCP, и Cline получает возможности, которых нет ни у одной языковой модели «из коробки». Генерация картинок — самый наглядный пример. Cline без проблем отрефакторит компоненты, прогонит тесты и напишет миграцию, а затем споткнётся на фразе «а сюда вставьте фото товара».

Быстрый старт для тех, кто не любит ждать. Создайте ключ в профиле BananaBanana, откройте настройки MCP в Cline и вставьте:

{
  "mcpServers": {
    "bananabanana": {
      "type": "streamableHttp",
      "url": "https://bananabanana.pro/api/mcp",
      "headers": {
        "Authorization": "Bearer bb_live_YOUR_KEY"
      },
      "disabled": false,
      "autoApprove": ["list_models", "get_account", "get_result"]
    }
  }
}

В панели появится десяток инструментов. Списания за картинки начинаются от $0.03 с предоплаченного баланса, за видео — от $0.10. Параметр type строго обязателен, и чуть ниже я объясню, к какой неприятной ошибке приводит его отсутствие.

Зачем добавлять генератор изображений в Cline?

Вся суть работы с Cline сводится к принципу: «опиши результат, пусть агент сделает итерации». Это работает ровно до тех пор, пока в результат не входит изображение. Тут цикл прерывается и начинается рутина: открыть браузер, написать промпт, скачать файл, переименовать, переложить в public/, вернуться в редактор и вспомнить, на чём остановился. По пять минут на каждый ассет, причём переключение контекста обходится дороже самого времени.

С MCP-инструментом этот цикл берёт на себя агент. Он сам формулирует промпт, вызывает generate_image, сохраняет готовый файл в нужную папку и прописывает его в разметке. Вам остаётся только проверить итоговый diff.

Экономика тоже идеально подходит пользователям Cline. Cline работает по принципу «своя модель», поэтому его аудитория привыкла платить за фактическое использование, а не ежемесячную подписку. Цены генерации устроены точно так же. Никаких тарифов, мест или минимальных платежей. Картинки от $0.03, видео от $0.10, с баланса, который пополняется по мере необходимости.

Альтернатива — локальный MCP-сервер. А это значит запущенный процесс Node или Python на вашей машине, собственный API-ключ провайдера, управление квотами и биллинг в чужом кабинете. Удалённый эндпоинт избавляет от обоих неудобств. Генерация происходит на нашей стороне через тот же пайплайн, что и веб-генератор, а на руках остаётся единственный ключ, который можно отозвать в любой момент.

Как подключить удалённый MCP-сервер в Cline?

Есть три способа с одинаковым результатом. Инструкция ниже проверена по официальной документации Cline MCP на 20 августа 2026 года.

Через интерфейс. Нажмите иконку MCP Servers на панели инструментов Cline, перейдите на вкладку Remote Servers, укажите имя сервера, URL https://bananabanana.pro/api/mcp и выберите транспорт Streamable HTTP. Нажмите Add Server. Затем откройте настройки и добавьте заголовок Authorization: форма помогает быстро создать запись, но сами секреты хранятся в JSON.

Через редактирование JSON. Та же иконка, вкладка Configure, затем кнопка Configure MCP Servers — откроется конфигурационный файл расширения. Он лежит в глобальном хранилище VS Code, в папке с именем saoudrizwan.claude-dev (ID расширения до сих пор содержит имя автора, что часто путает тех, кто ищет слово «cline»). В CLI-версии путь проще: ~/.cline/mcp.json, а команда cline mcp запускает пошаговый мастер настройки.

Из терминала. Команда cline config mcp --json выводит текущую загруженную конфигурацию — это самый быстрый способ проверить, применились ли правки.

Какой бы путь вы ни выбрали, рабочий адрес эндпоинта — https://bananabanana.pro/api/mcp. Не /mcp, так как это страница документации для людей, которая на любой POST вернёт HTML. На нашей странице MCP-сервера собраны универсальный шаблон и таблица совместимости для проверенных клиентов:

Перед платными вызовами сделайте бесплатный тест. Метод get_account возвращает баланс, имя ключа и дневной лимит; list_models отдаёт список доступных моделей с актуальными ценами. Оба вызова бесплатны и подтверждают авторизацию за секунду.

Практический сценарий: генерация заглушек каталога в режиме Act

Именно здесь Cline раскрывается на полную мощность, и это совсем не то же самое, что разово сгенерировать одну картинку для первого экрана. Сначала режим Plan: описываем каталог на двенадцать товаров, каждому из которых нужна заглушка в едином фирменном стиле, и даём Cline возможность спланировать цикл до внесения изменений. Затем режим Act выполняет задачу.

Единый стиль задаётся базовой фразой, которая повторяется в каждом вызове, меняется только сам объект. Цельность серии обеспечивается неизменной частью промпта, а не тем, что модель «помнит» свои действия минуту назад:

→ generate_image {"prompt": "A photorealistic overhead product shot of a
   small monstera in a matte terracotta pot on a pale linen backdrop, soft
   diffused window light from the left, 50mm lens, subtle natural shadow,
   generous empty space around the subject, no text",
   "model": "nano-banana-pro", "aspect_ratio": "4:5"}
← {"job_id": "…", "status": "processing", "cost_charged_usd": 0.11,
   "balance_remaining_usd": 1110.65}

Второй товар с той же стилистической основой, но другим растением и ракурсом:

Двенадцать таких изображений на Nano Banana Pro обойдутся в $1.32. На стандартной nano-banana-2-lite сумма составит $0.36, и для временных плейсхолдеров, которые дизайнер всё равно заменит, я бы выбрал именно её; в нашем руководстве по Lite подробно описаны границы возможностей бюджетной модели. В этой статье Pro использован потому, что оба примера выводятся на странице в полном размере.

Пакетная генерация — как раз та ситуация, где нужны предохранители. Их здесь два. Для каждого MCP-ключа можно задать дневной лимит в долларах (Профиль → MCP API Keys): если агент уйдёт в бесконечный цикл, списания остановятся на заданной сумме. Кроме того, запросы на несколько картинок (number_of_images больше 1) работают как видео: первый вызов возвращает оценку стоимости и ничего не списывает, пока агент не повторит запрос с флагом confirm_cost.

Генерация видео доступна из того же чата и защищена тем же подтверждением. Четырёхсекундный ролик без звука в 720p на Veo 3.1 Lite стоит от $0.10, а Omni Flash тарифицируется по $0.10 за секунду и всегда включает звук, то есть трёхсекундный ролик обойдётся в $0.30. Рендер занимает от одной до десяти минут, и так как generate_video мгновенно возвращает идентификатор задачи, Cline продолжает писать код и опрашивает get_result в фоновом режиме.

Подводные камни Cline, о которых стоит знать заранее

Пять нюансов в порядке того, сколько времени они способны сэкономить.

1. "type": "streamableHttp" пишется именно так, а пропуск параметра приводит к тихой ошибке. Документация однозначна: если поле не указано, клиент по умолчанию включает устаревший транспорт sse для обратной совместимости. Старый SSE ожидает, что клиент откроет GET-соединение к вашему URL и будет слушать поток событий. Наш эндпоинт работает по протоколу Streamable HTTP без сохранения состояния, поэтому на запрос GET он отвечает 405 Method Not Allowed (я перепроверил это при написании статьи: curl -i https://bananabanana.pro/api/mcp отдаёт 405). В Cline это выглядит как бесконечное подключение с ошибкой, в которой нет ни слова о пропущенном поле. Написание через дефис streamable-http падает с той же ошибкой.

2. Ключ хранится в конфигурации в открытом виде. Документация Cline рекомендует держать секреты в переменных окружения, однако подстановка переменных в объекте headers удалённых серверов не документирована (в отличие от синтаксиса ${env:…} в Cursor или ${file:…} в Windsurf). Плюс в том, что конфигурация хранится в глобальных данных VS Code, а не внутри репозитория проекта, так что случайно закоммитить ключ в git не получится. Тем не менее относитесь к нему как к секрету на диске: установите дневной лимит и сразу отзывайте ключ из профиля, если передаёте рабочий ноутбук.

3. Настройка Auto Approve менее гибкая, чем кажется. В панели Auto Approve переключатель «Use MCP servers» отвечает за категорию MCP-инструментов целиком. Включив его, вы автоматически разрешаете и платные, и бесплатные вызовы. Гранулярная настройка задаётся в самом конфиге через массив autoApprove. Я рекомендую добавить туда три бесплатных метода (list_models, get_account, get_result) и ничего лишнего: так агент не будет отвлекать вас подтверждениями в процессе работы, но каждый платный рендер всё равно потребует одобрения.

4. Режим YOLO в связке с платными инструментами требует осторожности. Режим YOLO в Cline автоматически подтверждает любые действия: изменения файлов, команды в терминале, браузерные переходы и вызовы MCP. В документации он не зря помечен как опасный. Наш механизм подтверждения стоимости здесь не спасёт: автономный агент без колебаний подтвердит обе части запроса. Единственная надёжная защита — дневной лимит расходов на ключ. Настройте его до включения YOLO, а не после.

5. Для удалённых серверов нет установки из каталога, а в организациях действуют свои правила. В расширении для VS Code на базе официального SDK больше нет встроенного каталога MCP Marketplace, поэтому ручная правка JSON остаётся основным путём. У администраторов команд есть свой инструмент: параметр remoteMCPServers в корпоративных настройках централизованно раскатывает конфигурацию на всех сотрудников, а blockPersonalRemoteMCPServers запрещает подключать сторонние серверы. Если вы настраиваете рабочую среду для команды, подключите сервер централизованно и выдайте каждому разработчику личный ключ.

Честно упомянем и ограничение с нашей стороны: метод generate_speech возвращает подписанную ссылку на WAV-файл, а не плеер внутри панели Cline, поэтому для прослушивания файл нужно открыть. Изображения же возвращаются с небольшим предпросмотром прямо рядом со ссылкой. Cline поддерживает отображение картинок в результатах работы инструментов ещё с 2025 года, поэтому на всех актуальных версиях предпросмотр работает корректно.

Поддерживает ли Cline авторизацию через OAuth для MCP?

В официальной документации такой возможности нет, и это важно подчеркнуть, поскольку в других клиентах ситуация отличается. Документация Cline описывает транспорты stdio, SSE и Streamable HTTP, а авторизация реализована через пользовательские заголовки. Поддержки OAuth там нет. Соответствующий запрос на добавление OAuth висит в репозитории Cline с августа 2025 года и остаётся открытым по состоянию на 20 августа 2026 года.

На практике в этом нет никакой проблемы. Наш сервер принимает как токены OAuth 2.1, так и стандартные API-ключи формата Bearer, и именно под ключи спроектирован Cline. Я и сам предпочитаю этот вариант: создание ключей бесплатно, их можно держать несколько штук, и у каждого ведётся отдельный журнал использования (инструмент, модель, стоимость, фрагмент промпта) вместе с дневным лимитом. Если подрядчик сдал проект, вы отзываете один конкретный ключ, не затрагивая остальную инфраструктуру.

Для изоляции расходов создавайте отдельный ключ под каждый проект. Журнал вызовов сразу покажет, сколько ушло на задачи внутреннего дашборда, а сколько — на промо-сайт, что особенно удобно при формировании счетов.

Сколько стоили иллюстрации для этой статьи?

Обычные цены за генерацию — ровно те цифры, которые агент получает через list_models:

Полезная деталь при пополнении баланса: депозиты от $50 дают бонус +5% к сумме, от $100 — +10%, а активный промокод начисляет ещё +10% сверху. Оба бонуса считаются от базовой суммы, поэтому при пополнении на $100 с промокодом на баланс зачисляется $120.

Тот же ключ работает в любых других средах: если вы используете Cursor или VS Code, ничего заново настраивать не придётся — единый баланс, общая история и один эндпоинт. В руководстве по Cursor и настройке для VS Code разобраны сценарии работы с ними. Создайте ключ и поручите Cline собрать вашу первую пачку изображений.

FAQ

Поддерживает ли Cline удалённые MCP-серверы по протоколу Streamable HTTP?

Да, и это рекомендуемый транспорт в официальной документации Cline. Для подключения удалённого сервера указываются url, type со значением streamableHttp и объект headers для авторизации. Устаревший транспорт SSE сохранён для совместимости со старыми серверами. Обязательно указывайте type явно: без него клиент откатывается на SSE, что не сработает с современным stateless-эндпоинтом. Проверено по официальной документации на 20 августа 2026 года.

Где находится файл настроек MCP в Cline?

В зависимости от способа запуска. Расширение для VS Code хранит файл в глобальном хранилище редактора, в папке с ID расширения saoudrizwan.claude-dev. Надёжнее всего открыть его через кнопку Configure MCP Servers на вкладке Configure в панели MCP, а не искать папку вручную. Консольная утилита использует путь ~/.cline/mcp.json. В обоих случаях используется одинаковый объект mcpServers.

Нужен ли собственный аккаунт в облачных сервисах для генерации картинок в Cline?

Нет. Локальный сервер изображений требует API-ключ внешнего провайдера с лимитами и оплатой в его кабинете. Удалённый сервер выполняет генерацию на нашей инфраструктуре, поэтому единственный нужный реквизит — ключ bb_live_ из профиля. Новым аккаунтам начисляется $0.20 на баланс, чего хватает на шесть картинок на базовой модели ещё до первого пополнения.

Как защититься от лишних списаний при работе агента?

Используйте все три уровня контроля. Оставьте в autoApprove только бесплатные инструменты, чтобы каждый рендер запрашивал подтверждение. Задайте дневной лимит в долларах в разделе Профиль → MCP API Keys — это единственная защита, которая продолжает работать даже при включённом режиме YOLO. И полагайтесь на встроенное подтверждение стоимости: запросы на видео и несколько картинок сначала возвращают расчет цены и не списывают средства, пока агент не повторит вызов с параметром confirm_cost.

Почему Cline не подключается к MCP-серверу?

Проверьте следующие пункты по порядку. Указан ли параметр "type": "streamableHttp" именно в camelCase — без него Cline пробует подключиться через legacy SSE, и наш эндпоинт возвращает 405 на GET-запрос. Заканчивается ли адрес на /api/mcp, а не на /mcp. Записан ли заголовок авторизации строго в виде Bearer bb_live_... без лишних пробелов (недействительный или отозванный ключ вернёт 401). Если сервер подключился, но инструменты не появились, перезапустите его в панели MCP. В корпоративных сетях личные удалённые серверы могут быть заблокированы политиками организации.