Перейти до основного вмісту

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 та інші клієнти​

Клієнти, що приймають URL сервера, підключаються безпосередньо до кінцевої точки 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 на передній план; схвалення чекає там.