Files
MikrotikManager/docs/mcp-server-control-call-audit-20261114.md
T

10 KiB

Проверка MCP-вызовов серверов, событий и управления операциями

Сверены 15 вызовов раздела servers, два вызова dashboard и семь вызовов mcp с текущим реестром. В таблицах указано, где вызывается RouterOS, а где проверяется контракт MikrotikManager. Это аудит исходников. Результаты исполнения ниже приведены только для явно указанных тестов.

Серверы

Вызов Контракт и следующая проверка
mm_servers_list Каталог БД с областью подключения и пагинацией. Проверить чужой ID и следующую страницу.
mm_servers_create_plan План записи подключения в БД. Проверить привязку секрета к назначению, сохранённый ID и скрытие пароля.
mm_servers_update_plan План обновления записи в БД. Проверить, что изменение endpoint инвалидирует старую привязку, а чужой сервер исключён.
mm_servers_delete_plan План удаления записи MikrotikManager. Проверить зависимости и историю операции в отдельной БД.
mm_servers_api_ping_settings_get Настройки приложения из БД. Проверить область доступа.
mm_servers_api_ping_settings_update_plan План обновления enabled и intervalSec в приложении. При применении обновляется расписание. Само редактирование настройки не изменяет конфигурацию RouterOS.
mm_server_snapshots_get Снимки выбранного сервера из БД. Проверить предел, порядок и отказ для чужого сервера.
mm_server_source_address_get Разрешение управляющего host на стороне приложения. Ответ явно содержит interfaceAddressVerified:false.
mm_server_wan_runtime_get GET /rest/ip/dhcp-client, /rest/ip/address, /rest/ip/route. Проверить фильтрацию IPv4/main, связь шлюза с интерфейсом и отсутствие заявления о forwarding.
mm_server_test_connection_plan После одобрения два GET /rest/system/identity и /rest/system/resource по закреплённому адресу. Проверить ограничения перенаправлений, DNS и подтверждённую идентичность.
mm_server_poll_plan План глобального опроса и обслуживания. Четыре GET к синтетическому RouterOS подтверждены отдельно. Подробный аудит
mm_server_probe_plan После одобрения: bounded POST /rest/tool/ping, /rest/tool/traceroute или /rest/tool/bandwidth-test; route использует GET /rest/ip/route; DNS выполняет Manager. MTU использует ping с count=1, interval=0.2s, конкретным size и do-not-fragment=true. Каждую ветвь проверять раздельно.
mm_server_probe_receipt_get Читает ограниченную часть подтверждённой квитанции из БД. Проверить привязку к операции, область доступа и хеш.
mm_server_probe_cancel Сигнал отмены в приложении. Проверить квоту и остановку последующих стадий.
mm_server_terminal_diagnostic Типизированный список ниже. Проверить каждую ветвь, отзыв доступа, предел вывода и маскирование.

Маппинг исходников. Серверы и события · Подключение · WAN · Исполнение проб · Клиент RouterOS

Документация RouterOS для нативных путей выше. REST API · DHCP · Адреса · Маршруты · Ping · Traceroute · Bandwidth Test

Варианты терминала

help работает локально. addresses, interfaces, identity, resources, routes, firewall_filters, bgp_sessions и bfd_sessions используют соответственно GET /ip/address, /interface, /system/identity, пару /system/resource и /system/identity, /ip/route, /ip/firewall/filter, /routing/bgp/session и /routing/bfd/session. Меню здесь указаны без REST-префикса. logs читает буфер через GET /log?buffer=memory&.proplist=.id,time,topics,message. ping отправляет POST /tool/ping с адресом, заданным числом проб и интервалом 0.2s. Диспетчер команд · REST API · Log · BFD

ospf_neighbors, ospf_areas, ospf_instances и ospf_interfaces читают /routing/ospf/neighbor, /routing/ospf/area, /routing/ospf/instance и /routing/ospf/interface-template. При отсутствии данных для проекции возможны дополнительные POST /get и /print; для шаблонов парные запросы /print проверяют passive. Ветка с отсутствующим полем проверяется отдельно от обычного GET. REST API · OSPF в RouterOS v7 · Шаблоны OSPF

События и управление

Вызов Контракт и следующая проверка
mm_events_list Чтение событий MikrotikManager с глобальной областью.
mm_events_batch_append_plan План добавления пакета событий в БД. Проверить одобрение, атомарность и подтверждённое число записей.
mm_capabilities_get Каталог по правам текущего подключения. Проверить системные и выданные права.
mm_change_get Чтение собственного плана с проверкой области.
mm_change_cancel Перевод допустимого незапущенного плана в cancelled и запись аудита. Его регистрация как read не делает операцию чистым чтением для тестового журнала.
mm_change_apply Принимает только план и ключ идемпотентности. Нативные вызовы зависят от сохранённых шагов плана. Проверить одобрение, сохранённый ID операции и отсутствие повторной записи.
mm_operation_get Чтение существующей операции и её шагов из БД.
mm_operation_reconcile Сетевая сверка по типу операции и сохранённым шагам. Проверять нативные чтения конкретного действия, точное состояние и отсутствие повторной записи.
mm_global_operation_reconcile Сверка поддержанных глобальных сервисов по имеющимся квитанциям. Проверять область и отсутствие повторного выполнения.

Действия MCP · Сетевая сверка · Глобальная сверка · Пакет событий

Выполненные точечные проверки

Node 22 подтвердил контракт серверных проб в 140 модельных случаях. Локальный HTTP-стаб подтвердил ветви терминала, проверку формата, пределы и отмену. Второй локальный HTTP-тест подтвердил оба GET проверки подключения, закрепление endpoint, запрет redirect и маскирование. При первом запуске песочница не разрешила loopback. После этого повторены только два отказавших теста. Пробы · Терминал · Подключение