🔗MCP и AI-агенты
MCP позволяет подключить настольного AI-агента к работающему ISA Terminal. После подключения агент получает не «доступ ко всему компьютеру», а конкретный набор команд терминала: посмотреть ботов и позиции, прочитать логи, проверить график, управлять пресетами и выполнить другие разрешённые действия.
Что такое MCP
MCP (Model Context Protocol) — стандарт связи между AI-агентом и программой.
Без MCP агент знает о терминале только то, что вы написали ему в чате. С MCP он может запросить актуальные данные непосредственно у ISA Terminal и, если вы дали разрешение, выполнить действие.
Например, вместо ручной передачи скриншотов можно написать агенту:
Проверь всех запущенных ботов, открытые позиции и ошибки в логах за сегодня. Коротко напиши, где есть проблема.
Агент сам вызовет нужные инструменты ISA Terminal, сопоставит ответы и вернёт результат.
Как это работает
Связь выглядит так:
AI-агент → ISAMCPBridge.exe → работающий ISA TerminalAI-агент запускает файл
ISAMCPBridge.exeкак локальный MCP-сервер.Bridge соединяется с backend ISA Terminal через локальный канал Windows.
Агент получает список доступных инструментов.
Когда вы даёте задачу, агент выбирает нужный инструмент и передаёт параметры.
ISA Terminal проверяет разрешения, выполняет запрос и возвращает результат.
Подключение работает локально, поэтому:
ISA Terminal и AI-агент должны быть установлены на одном компьютере или Windows VPS;
терминал должен быть запущен;
MCP должен быть включён в настройках терминала;
нужен настольный AI-агент с поддержкой MCP, например Hermes или OpenClaw; обычная веб-версия чат-бота не подойдёт.
Сам MCP работает локально, но выбранный AI-агент может отправлять полученные данные своему провайдеру модели. Учитывайте это при выборе агента и выданных разрешений.
Как подключить агента
1. Включите MCP в ISA Terminal
Запустите ISA Terminal.
Нажмите значок шестерёнки в правом верхнем углу.
Откройте вкладку MCP.
Включите MCP-сервер.
Выберите разрешения, которые действительно нужны агенту.
Нажмите Сохранить.
Настройки MCP применяются сразу — перезапускать терминал не требуется.
2. Скопируйте промт для подключения
На вкладке MCP терминал показывает готовый промт с правильным путём к ISAMCPBridge.exe.
Скопируйте этот промт и отправьте его своему настольному AI-агенту. Агент должен добавить ISA Terminal как локальный MCP-сервер.
В стандартной конфигурации подключение выглядит примерно так:
Используйте путь, который показан именно в вашем терминале: он может отличаться от примера.
3. Перезапустите AI-агента
После добавления MCP-сервера полностью перезапустите AI-агента. Большинство клиентов загружает список MCP-подключений только при старте.
ISA Terminal оставьте запущенным. Если терминал закрыт или MCP выключен, bridge не сможет подключиться.
4. Проверьте подключение
Напишите агенту:
Подключись к ISA Terminal и покажи список доступных инструментов. Затем безопасно проверь список ботов и настройки, ничего не изменяя.
Если подключение работает, агент увидит инструменты ISA Terminal и сможет вызвать list_bots и get_settings.
Если агент сообщает Connection closed или не видит инструменты:
убедитесь, что ISA Terminal запущен;
проверьте, что MCP-сервер включён и настройки сохранены;
проверьте путь к
ISAMCPBridge.exe;перезапустите AI-агента.
Разрешения агента
После включения MCP агенту доступны команды чтения. Они не изменяют настройки и сущности терминала. При этом отдельные запросы могут быть ресурсоёмкими: например, run_backtest загружает исторические свечи и выполняет расчёты.
Изменяющие команды включаются отдельно:
Управление ботами
Создавать, изменять, запускать, останавливать и удалять ботов.
Управление подключениями
Создавать, удалять, включать и выключать подключения к биржам.
Управление пресетами
Создавать, изменять, удалять, импортировать и экспортировать пресеты.
Управление индикаторами
Добавлять, настраивать и удалять индикаторы на графиках.
Изменение настроек
Менять язык, размер интерфейса, автозапуск, хранение логов и автосохранение рабочего пространства.
Отправка баг-репортов
Создавать баг-репорты и автоматически прикладывать диагностические данные.
Разрешить всё
Одним переключателем включает все перечисленные разрешения.
Не включайте Разрешить всё без необходимости. Для первого знакомства достаточно команд чтения и, при необходимости, отправки баг-репортов.
Разрешение Отправка баг-репортов включено по умолчанию. Отключите его, если агент не должен создавать задачи во внешней системе Yougile и передавать туда диагностические данные.
Если агенту разрешено управлять ботами или подключениями, сначала используйте demo/testnet. Запуск бота через MCP ничем не отличается от запуска кнопкой в терминале: при реальном подключении бот будет торговать реальными средствами.
Инструменты MCP
Tool — это отдельная команда ISA Terminal с понятными параметрами. Агент не нажимает кнопки интерфейса и не получает произвольный доступ к приложению: он работает только через зарегистрированные tools.
Всего ISA Terminal предоставляет 40 инструментов: 19 для чтения и 21 для действий с отдельными разрешениями.
Дополнительно агент получает два справочных ресурса:
app://info— версия терминала, состояние MCP и активные разрешения;swagger://openapi.json— описание HTTP API терминала, чтобы агент понимал структуру данных.
Это справка для агента, а не дополнительные разрешения на действия.
Боты и торговое состояние
Команды чтения:
list_bots— список ботов, их статусы, конфигурация, тикеры и PnL;get_bot_metrics— подробные метрики выбранного бота;list_strategies— доступные стратегии и поддерживаемые рынки;get_strategy_params— параметры выбранной стратегии, значения по умолчанию и допустимые диапазоны;get_active_orders— активные биржевые ордера;get_active_positions— открытые позиции и unrealized PnL;get_closed_trades— история закрытых сделок;get_bots_stats— общая статистика по всем ботам.
С разрешением Управление ботами:
create_bot,update_bot;start_bot,stop_bot,delete_bot;start_all_bots,stop_all_bots.
При остановке агент может передать параметр close_position. Если он включён, открытая позиция закрывается по рынку. stop_all_bots с этим параметром закроет позиции сразу у всех запущенных ботов. start_all_bots массово запустит все остановленные боты.
update_bot применяет изменения к запущенному боту на лету. Удаление бота безвозвратно удаляет связанную с ним статистику, поэтому изменяющие и массовые команды нужно выполнять только по прямому запросу.
Подключения к биржам
Команды чтения:
list_vendors— список сохранённых подключений;get_available_pairs— торговые пары, доступные для выбранного подключения.
С разрешением Управление подключениями:
create_vendor,delete_vendor;enable_vendor,disable_vendor.
Создание подключения требует API Key и Secret. Не передавайте ключи агенту без необходимости. Для тестирования используйте demo/testnet-ключи.
disable_vendor отключает соединение и останавливает зависимых ботов. delete_vendor может затронуть привязанных к подключению ботов.
Графики и индикаторы
Команды чтения:
get_chart— свечи OHLCV и значения активных индикаторов;get_indicators_catalog— каталог доступных индикаторов и их параметры;get_chart_indicators— индикаторы, сохранённые для выбранного подключения;get_calculated_indicators— рассчитанные значения линий индикаторов.
С разрешением Управление индикаторами:
add_chart_indicator;update_chart_indicator;delete_chart_indicator.
Запрос свечей задаётся тремя значениями: подключение, торговая пара и таймфрейм. Агент получает снимок данных, а не бесконечный поток котировок.
Набор индикаторов хранится на уровне подключения (vendor_uuid) и используется для его графиков. Поэтому добавление, изменение или удаление индикатора может быть видно и на других парах и таймфреймах того же подключения.
Бэктест
run_backtest— запускает одну или несколько конфигураций стратегии на исторических свечах.
Инструмент ничего не меняет в терминале и не запускает реальную торговлю. Агент передаёт подключение, пару, таймфрейм, период и наборы параметров. В ответ получает PnL, просадку, win rate, количество сделок, recovery factor и profit factor. Результаты отдельно показывают поведение в Long и Short.
Несколько наборов параметров можно проверить одним вызовом. Перед этим агенту нужно получить допустимые параметры через get_strategy_params, а после прогона — сравнить варианты на одинаковом периоде и таймфрейме.
Результаты сортируются по recovery_factor, но выбирать настройку только по первой строке нельзя. Значение ∞ часто означает прибыль без зафиксированной просадки всего на одной-двух сделках. Проверяйте также количество сделок, просадку и баланс между Long и Short.
Бэктест может выполняться долго: терминал загружает исторические свечи с биржи и сохраняет их в кеш. Первый прогон длинного периода, особенно на минутном таймфрейме, может занять несколько минут.
Пресеты
Команды чтения:
list_presets— список всех пресетов;list_presets_by_strategy— пресеты конкретной стратегии.
С разрешением Управление пресетами:
create_preset,update_preset,delete_preset;export_presets,import_presets.
Агент может подготовить несколько вариантов параметров, сохранить их как пресеты и проверить, какие пресеты уже существуют. Пресет хранит параметры стратегии, но не является готовым ботом.
Настройки, логи и баг-репорты
get_settings— прочитать настройки приложения;get_logs— получить логи за выбранную дату с фильтрами по уровню, источнику, боту и тексту сообщения;update_settings— изменить разрешённые настройки приложения;create_bug_report— создать задачу с описанием проблемы.
get_logs возвращает не более 500 записей за один запрос. update_settings в отдельных случаях может вызвать автоматический перезапуск приложения, поэтому терминал показывает подтверждение при выдаче этого разрешения.
create_bug_report создаёт задачу во внешней системе Yougile. Терминал автоматически прикладывает backend-логи за сегодня и вчера и историю ордеров. Перед выдачей этого разрешения учитывайте, что диагностические данные покинут компьютер.
Что можно поручить агенту
Проверить состояние торговли
Покажи активные позиции, ордера и ботов. Найди ботов с ошибками или необычным PnL. Ничего не меняй.
Разобраться с ошибкой
Проверь error-логи за сегодня по этому боту, сопоставь их с активными ордерами и объясни причину простыми словами.
Настроить график
Для выбранного подключения добавь EMA 50 и RSI 14, затем проверь их значения на BTCUSDT, 1h.
Для этого потребуется разрешение на управление индикаторами.
Подготовить пресет
Покажи параметры стратегии GRID и создай отдельный demo-пресет с указанными настройками. Бота не запускай.
Для этого потребуется разрешение на управление пресетами.
Сравнить настройки на бэктесте
Получи допустимые параметры стратегии, подготовь несколько вариантов и прогони их на BTCUSDT за один и тот же период. Сравни recovery factor, просадку, количество сделок и результаты Long/Short. Ничего не запускай в реальной торговле.
run_backtest доступен в режиме чтения. Для сохранения выбранного варианта в пресет или применения к боту потребуется отдельное разрешение.
Создать баг-репорт
Найди ошибки в логах, собери шаги воспроизведения и отправь один понятный баг-репорт.
Что MCP даёт пользователю
Состояние ботов, позиций, ордеров, метрик и логов можно проверить одним запросом вместо нескольких окон и скриншотов.
Несколько наборов параметров стратегии можно сравнить на одинаковом историческом периоде.
Агенту можно выдать только нужные права: например, разрешить пресеты, но запретить запуск ботов и управление биржами.
При разборе ошибки агент может собрать диагностический контекст и подготовить баг-репорт.
Ограничения
MCP не гарантирует прибыль и не делает стратегию безопасной автоматически.
Агент может ошибиться в выводах или выбрать неподходящие параметры.
Без разрешений агент не сможет изменять данные.
При закрытом ISA Terminal подключение не работает.
Агент видит только данные и действия, которые ISA Terminal отдаёт через MCP.
Котировки через MCP запрашиваются снимками; постоянный поток графика агенту не передаётся.
Любое действие с реальным биржевым подключением нужно проверять так же внимательно, как ручное действие в терминале.
Для начала используйте MCP в режиме чтения или на demo-подключении. Расширяйте разрешения только под конкретную задачу.
Last updated