MCP-сервер для ИИ-клиентов
TikMatrix включает MCP-сервер. После включения ИИ-приложение на том же компьютере (Claude Desktop, Claude Code, Cursor или любой другой MCP-клиент) может видеть ваши устройства, аккаунты и задачи, планировать новые задачи и читать логи и скриншоты прямо из чата.
ИИ ничего не меняет самостоятельно. Создание, остановка или повтор задач, а также добавление пользовательского скрипта ждут вашего одобрения в окне TikMatrix.
MCP-сервер доступен на планах Pro, Team и Business, как и локальное API. На Starter ИИ-клиент может подключиться, но каждый инструмент будет отвечать сообщением о необходимости обновления тарифа.
Включение
- Откройте TikMatrix → Настройки → API для разработчиков.
- Включите ИИ-клиенты (MCP). По умолчанию это выключено.
- Скопируйте конфигурацию для вашего ИИ-клиента из того же раздела. Она уже содержит правильное имя сервера, адрес и, для 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 на передний план: запрос на одобрение ждёт там. |