MCP-сервер для ИИ-клиентов

TikMatrix включает MCP-сервер. После включения ИИ-приложение на том же компьютере (Claude Desktop, Claude Code, Cursor или любой другой MCP-клиент) может видеть ваши устройства, аккаунты и задачи, планировать новые задачи и читать логи и скриншоты прямо из чата.

ИИ ничего не меняет самостоятельно. Создание, остановка или повтор задач, а также добавление пользовательского скрипта ждут вашего одобрения в окне TikMatrix.

Требование лицензии

MCP-сервер доступен на планах Pro, Team и Business, как и локальное API. На Starter ИИ-клиент может подключиться, но каждый инструмент будет отвечать сообщением о необходимости обновления тарифа.

Включение

1. Откройте TikMatrix → Настройки → API для разработчиков.
2. Включите ИИ-клиенты (MCP). По умолчанию это выключено.
3. Скопируйте конфигурацию для вашего ИИ-клиента из того же раздела. Она уже содержит правильное имя сервера, адрес и, для Claude Desktop, полный путь к программе TikMatrix на этом компьютере.

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

Подключение ИИ-клиента

Claude Desktop

Claude Desktop запускает MCP-серверы как программы, поэтому TikMatrix предоставляет небольшой режим ретрансляции. Откройте в Claude Desktop Settings → Developer → Edit Config и добавьте фрагмент, скопированный из TikMatrix, в claude_desktop_config.json. Он выглядит так, путь указан для вашего компьютера:

{
  "mcpServers": {
    "tikmatrix": {
      "command": "C:\\Program Files\\TikMatrix\\TikMatrix.exe",
      "args": ["--mcp-stdio"]
    }
  }
}

Перезапустите Claude Desktop. Опция --mcp-stdio не открывает второе окно; она только передаёт сообщения уже запущенному TikMatrix.

Claude Code

claude mcp add --transport http tikmatrix http://127.0.0.1:50809/mcp

Cursor и другие клиенты

Клиенты, которые принимают адрес сервера, подключаются напрямую к конечной точке Streamable HTTP:

{
  "mcpServers": {
    "tikmatrix": {
      "url": "http://127.0.0.1:50809/mcp"
    }
  }
}

Имя сервера зависит от редакции (tikmatrix, igmatrix или tikmatrix-pro); фрагмент в Настройках использует правильное.

Что может делать ИИ

Инструмент	Что делает	Требует вашего одобрения
list_devices	Подключённые телефоны, онлайн они или заняты, и их группы	Нет
list_accounts	Аккаунты, устройство каждого и вошёл ли он в систему	Нет
list_groups	Группы устройств	Нет
get_script_schema	Настройки, которые принимает каждый скрипт	Нет
list_tasks	Задачи, с фильтром по статусу, устройству или скрипту	Нет
get_task_log	Лог одной задачи	Нет
get_activity_log	Недавняя активность приложения	Нет
device_screenshot	Что сейчас на экране телефона	Нет
list_custom_scripts	Ваши зарегистрированные пользовательские скрипты	Нет
get_custom_script_guide	Как написать пользовательский скрипт	Нет
plan_tasks	Определяет, какие задачи создал бы запрос, без их создания	Нет
create_tasks	Создаёт задачи плана	Да
stop_task	Останавливает выполняющуюся задачу	Да
retry_task	Запускает неудавшуюся задачу снова	Да
create_custom_script	Пишет и регистрирует новый пользовательский скрипт	Да
get_approval	Проверяет, чем закончился запрос, ожидавший одобрения	Нет

Одобрение изменений

Когда ИИ отправляет изменение, TikMatrix выходит на передний план и показывает, что он сделает: для пакета задач это скрипт, его настройки и каждое устройство, аккаунт и цель построчно. Выберите Одобрить, чтобы выполнить, или Отклонить, чтобы отбросить.

• Если вы ответите примерно в течение 50 секунд, ИИ сразу получит результат.
• Если вы ответите позже, ИИ узнает, что запрос ждёт вас. Одобрение позже всё равно выполнит его, и ИИ может запросить итог.
• Неотвеченные запросы истекают через 15 минут вместе с планом, из которого они возникли.
• Задачи, созданные таким образом, в списке задач показывают источник mcp.

Примеры запросов

• «Какие из моих телефонов офлайн и какие аккаунты вышли из системы?»
• «Прогрей все аккаунты группы US-1 в течение 20 минут, начиная с 21:00.»
• «Почему последние три задачи публикации завершились ошибкой? Покажи экран телефона, на котором это произошло.»

Безопасность

• Только локально. Конечная точка принимает соединения только с этого компьютера и отклоняет запросы, сделанные веб-страницами.
• По умолчанию выключено. Ничто не может подключиться, пока вы не включите сервер, а выключение вступает в силу сразу.
• Каждое изменение одобряете вы. Это не зависит от собственных настроек разрешений вашего ИИ-клиента.

Устранение неполадок

Сообщение	Что делать
"AI client access is turned off"	Включите ИИ-клиенты (MCP) в Настройки → API для разработчиков.
"The app is not running"	Запустите TikMatrix и попробуйте снова.
"API access requires Pro or higher plan"	Перейдите на Pro, Team или Business.
ИИ сообщает, что запрос ожидает, но ничего не появляется	Выведите окно TikMatrix на передний план: запрос на одобрение ждёт там.