Serwer MCP dla klientów AI

TikMatrix zawiera serwer MCP. Po włączeniu aplikacja AI działająca na tym samym komputerze — Claude Desktop, Claude Code, Cursor lub dowolny inny klient MCP — może widzieć twoje urządzenia, konta i zadania, planować nowe zadania oraz czytać logi i zrzuty ekranu, wszystko z poziomu czatu.

AI nigdy nie zmienia niczego samo. Tworzenie, zatrzymywanie lub ponawianie zadań oraz dodawanie własnego skryptu czekają na twoje zatwierdzenie w oknie TikMatrix.

Wymaganie licencji

Serwer MCP jest dostępny w planach Pro, Team i Business, tak jak Local API. W planie Starter klient AI może się połączyć, ale każde narzędzie odpowie komunikatem o konieczności aktualizacji planu.

Włącz

1. Otwórz TikMatrix → Ustawienia → API dla programistów.
2. Włącz Klienci AI (MCP). Domyślnie jest wyłączone.
3. Skopiuj konfigurację dla swojego klienta AI z tej samej sekcji. Zawiera ona już poprawną nazwę serwera i adres oraz, w przypadku Claude Desktop, pełną ścieżkę do programu TikMatrix na tym komputerze.

TikMatrix musi być uruchomiony, gdy z niego korzystasz. Serwer odpowiada tylko temu komputerowi: inne maszyny w sieci nie mogą się z nim połączyć.

Połącz klienta AI

Claude Desktop

Claude Desktop uruchamia serwery MCP jako program, dlatego TikMatrix udostępnia mały tryb przekaźnika. Otwórz w Claude Desktop Settings → Developer → Edit Config i dodaj fragment skopiowany z TikMatrix do claude_desktop_config.json. Wygląda on tak — ścieżka jest tą z twojego komputera:

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

Uruchom ponownie Claude Desktop. Opcja --mcp-stdio nie otwiera drugiego okna; jedynie przekazuje wiadomości do już działającego TikMatrix.

Claude Code

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

Cursor i inne klienty

Klienty akceptujące adres serwera łączą się bezpośrednio z punktem końcowym Streamable HTTP:

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

Nazwa serwera zależy od edycji (tikmatrix, igmatrix lub tikmatrix-pro); fragment w Ustawieniach używa właściwej.

Co AI może zrobić

Narzędzie	Co robi	Wymaga zatwierdzenia
list_devices	Podłączone telefony, czy każdy jest online czy zajęty, oraz ich grupy	Nie
list_accounts	Konta, urządzenie, na którym każde się znajduje, i czy jest zalogowane	Nie
list_groups	Grupy urządzeń	Nie
get_script_schema	Ustawienia, jakie przyjmuje każdy skrypt	Nie
list_tasks	Zadania, filtrowane po statusie, urządzeniu lub skrypcie	Nie
get_task_log	Log jednego zadania	Nie
get_activity_log	Ostatnia aktywność w aplikacji	Nie
device_screenshot	To, co aktualnie widać na ekranie telefonu	Nie
list_custom_scripts	Twoje zarejestrowane skrypty niestandardowe	Nie
get_custom_script_guide	Jak napisać skrypt niestandardowy	Nie
plan_tasks	Dokładnie ustala, jakie zadania utworzyłoby zapytanie, bez ich tworzenia	Nie
create_tasks	Tworzy zadania z planu	Tak
stop_task	Zatrzymuje działające zadanie	Tak
retry_task	Uruchamia ponownie nieudane zadanie	Tak
create_custom_script	Pisze i rejestruje nowy skrypt niestandardowy	Tak
get_approval	Sprawdza, jak zakończyło się zapytanie czekające na zatwierdzenie	Nie

Zatwierdzanie zmian

Gdy AI przesyła zmianę, TikMatrix wychodzi na wierzch i pokazuje, co zrobi: dla partii zadań — skrypt, jego ustawienia oraz każde urządzenie, konto i cel, wiersz po wierszu. Wybierz Zatwierdź, aby uruchomić, lub Odrzuć, aby ją odrzucić.

• Jeśli odpowiesz w ciągu około 50 sekund, AI od razu dostaje wynik.
• Jeśli zajmie to dłużej, AI zostaje poinformowane, że zapytanie czeka na ciebie. Późniejsze zatwierdzenie nadal je uruchomi, a AI może zapytać o wynik.
• Niezatwierdzone zapytania wygasają po 15 minutach wraz z planem, z którego pochodzą.
• Zadania utworzone w ten sposób mają w liście zadań źródło mcp.

Przykładowe zapytania

• „Które z moich telefonów są offline i które konta są wylogowane?”
• „Rozgrzej wszystkie konta w grupie US-1 przez 20 minut, zaczynając o 21:00.”
• „Dlaczego trzy ostatnie zadania publikacji się nie powiodły? Pokaż ekran telefonu, który zawiódł.”

Bezpieczeństwo

• Tylko lokalnie. Punkt końcowy przyjmuje połączenia wyłącznie z tego komputera i odrzuca żądania wysyłane przez strony internetowe.
• Domyślnie wyłączone. Nic nie może się połączyć, dopóki tego nie włączysz, a wyłączenie działa natychmiast.
• Każdą zmianę zatwierdzasz ty. Nie zależy to od ustawień uprawnień twojego klienta AI.

Rozwiązywanie problemów

Komunikat	Co zrobić
"AI client access is turned off"	Włącz Klienci AI (MCP) w Ustawienia → API dla programistów.
"The app is not running"	Uruchom TikMatrix, a następnie spróbuj ponownie.
"API access requires Pro or higher plan"	Przejdź na plan Pro, Team lub Business.
AI mówi, że zapytanie czeka, ale nic się nie pojawia	Przenieś okno TikMatrix na wierzch; zatwierdzenie czeka właśnie tam.