Сервер для ИИ-помощников

MCP расшифровывается как Model Context Protocol. Это общий язык между ИИ-помощником и небольшими программами, которые делают настоящую работу. Помощник просит названное действие с названными доводами, программа выполняет его и отвечает.

В ARMANOS такая программа уже есть. Это один файл на Node без сторонних зависимостей. Ваш ИИ-инструмент сам запускает его и разговаривает с ним через обычный ввод и вывод.

Сам сервер ничего не открывает в браузере. Каждый вызов инструмента превращается ровно в один запрос к локальному интерфейсу на 127.0.0.1, к тому же самому, куда ходит скрипт на Python или JavaScript.

То есть помощнику не выдают новую дорогу к вашим профилям. Ему выдают ту, что и так была, с тем же токеном и по тем же правилам.

Список инструментов записан в самом файле сервера. Каждый инструмент указывает на ход, который локальный интерфейс уже умеет, поэтому в списке нет ничего обещанного на будущее.

У каждого инструмента есть описание, написанное для модели, а не для меню. В нём сказано, что вернётся и когда этот вызов уместен, чтобы помощник выбирал, а не угадывал.

Доводы нарочно узкие. Большинству инструментов не нужно ничего, остальным нужен profileId, а create_profile берёт те же поля, что и форма создания профиля.

Второго хранилища нет, и выгрузки тоже нет. list_profiles читает те же записи, что и экран профилей, а созданный помощником профиль сразу появляется в программе.

Все изменения проходят через ту же проверку, что и кнопки в окне. Заблокированная лицензия не даст запустить профиль, а создание сверх тарифа откажет с той же причиной, которую назвала бы сама программа. Отдельного послабления для MCP нет.

Запуск отвечает адресом отладки, если он есть. На движке ARMANOS Browser у каждого профиля свой адрес, и Puppeteer подключается именно к нему. На встроенном движке есть только общий адрес всей программы, и в ответе это сказано прямо.

• profileId, имя, сценарий

  Опознаватели, которые остальные инструменты берут доводом.

• группа и шаблон отпечатка

  В какой группе лежит профиль и какой из пяти шаблонов на нём надет.

• краткие данные прокси

  Протокол, узел и порт. Логин и пароль остаются внутри программы.

• метки, дата создания, последнее использование

  Достаточно, чтобы помощник отсортировал и выбрал, ничего не открывая.

• признак работы

  Открыто ли окно этого профиля прямо сейчас.

Всё, что вы вставляете, программа собирает за вас. Она знает путь к файлу сервера внутри установки, адрес, на котором интерфейс действительно слушает, и ваш нынешний токен.

Состояние MCP на панели зависит от интерфейса, а не от отдельной настройки. Оно показывает «Готов» только пока локальный интерфейс правда слушает, так что вы не вставите настройку для несуществующего сервера.

1. 1

   Включите локальный интерфейс

   Откройте раздел API & MCP в ARMANOS и переключите тумблер. Признак должен показывать «Работает», а состояние MCP «Готов».

2. 2

   Поставьте Node.js

   Ваш ИИ-инструмент запускает сервер командой node. Без Node.js на этом компьютере он сообщит только о ненайденной команде.

3. 3

   Скопируйте настройку клиента

   Одна кнопка копирует весь блок JSON, где путь, адрес и токен уже подставлены.

4. 4

   Вставьте её и перезапустите клиент

   В Claude Desktop: настройки, затем раздел для разработчика, затем правка файла настроек. Другие клиенты MCP читают файл такого же вида.

Никакой учётной записи заводить не нужно, и никакого ключа от нас тоже. Две переменные окружения это вся настройка, и сервер читает их один раз при запуске.

Если порт 50325 занят другой программой, ARMANOS садится на свободный и говорит об этом на панели. В скопированном блоке тогда стоит тот порт, который взят на самом деле, а не тот, который не вышел.

Смена токена действует для интерфейса немедленно. В уже вставленном блоке остаётся прежний токен, поэтому скопируйте блок заново и перезапустите клиент, иначе каждый вызов вернёт 401.

Путь в поле args ведёт внутрь установленной программы. В сборке AppImage для Linux программа сначала кладёт файл сервера рядом со своими данными: AppImage разворачивается во временный каталог с новым именем при каждом запуске. Путь туда сработал бы один раз и молча сломался бы.

command

node

args[0]

…/Resources/mcp/armanos-mcp-server.js

env.ARMANOS_API_URL

http://127.0.0.1:50325

env.ARMANOS_API_TOKEN

токен из раздела API & MCP

Весь блок лежит внутри mcpServers.armanos, в том виде, который читает большинство клиентов MCP.

Допустим, вы просите открыть три профиля для магазинов и дать код входа для одного из них. Номеров ваших профилей помощник не знает, поэтому начинает со списка.

Запуску отведено девяносто секунд, остальным вызовам пятнадцать. Открытие окна на движке ARMANOS Browser ждёт, пока движок объявит свой порт отладки, а это дольше, чем прочитать список.

Внутри сервера ничего не копится и не склеивается. Один вызов инструмента это один запрос и один ответ, поэтому в журнале вашего клиента видно, о чём именно просили и что пришло в ответ.

1. 1

   list_profiles

   Читает все профили и сопоставляет ваши слова с именами, группами и метками.

2. 2

   launch_profile, три раза

   По вызову на профиль. Каждый проходит проверку лицензии и тарифа и возвращает свой адрес отладки.

3. 3

   get_one_time_code

   Возвращает нынешние шесть цифр и остаток секунд для профиля, у которого сохранён ключ двухфакторной защиты.

4. 4

   stop_profile

   Когда работа сделана, по вызову на профиль закрывает его окна и сообщает, сколько закрыл.

Интерфейс слушает 127.0.0.1 и больше нигде. Он выключен, пока вы его не включите, а при первом запуске программа пишет случайный токен из 48 знаков в файл, который на macOS и Linux создаётся только для вашей учётной записи.

Одной петли для защиты мало. Страницы, которые вы открываете, работают на этой же машине, а подменённое имя домена достаёт до 127.0.0.1 как до своего. Поэтому интерфейс отклоняет запрос, похожий на приход со страницы, ещё до любого ответа, включая версию программы.

И честно про другой конец. Сервер ничего не отправляет нам и не нуждается в сети, но всё, что вернул инструмент, попадает в переписку с помощником. Где эта переписка обрабатывается, решает ваш ИИ-инструмент, а не ARMANOS.

• Только петля

  Другой компьютер до интерфейса не дотянется, и остальная сеть тоже.

• Токен на каждый вызов

  Уходит заголовком x-api-token. Открыт только /status, и только для программы на этой машине.

• Странице не отвечают

  Заголовок Origin, Sec-Fetch-Site не равный none или чужое имя узла получают отказ 403.

• В ответах нет паролей

  Список прокси отдаётся без паролей, а в списке профилей есть только протокол, узел и порт.

• Коды, а не ключи

  get_one_time_code возвращает шесть цифр и остаток секунд. Сам ключ двухфакторной защиты из программы не выходит.

Сервер написан так, чтобы не умирать от битого кадра, недоступного интерфейса или испорченного ответа. Неудача превращается в обычную ошибку инструмента с текстом, который помощник может вам прочитать.

Потолок в пять мегабайт важнее, чем кажется. Большой список профилей с длинными заметками до него дорастает, а оборванное чтение раньше оставляло вызов неразрешённым навсегда, и со стороны это выглядело как зависший помощник.

Отказы интерфейса передаются со своим текстом, а не пересказываются. Отказ про предел тарифа доходит до вас именно как предел тарифа, а не как безымянная неудача.