Server MCP untuk Klien AI

TikMatrix menyertakan server MCP. Setelah diaktifkan, aplikasi AI di komputer yang sama — Claude Desktop, Claude Code, Cursor, atau klien MCP lainnya — dapat melihat perangkat, akun, dan tugas Anda, merencanakan tugas baru, serta membaca log dan tangkapan layar, semuanya dari satu obrolan.

AI tidak pernah mengubah apa pun dengan sendirinya. Membuat, menghentikan, atau mencoba ulang tugas, serta menambahkan skrip kustom, semuanya menunggu persetujuan Anda di jendela TikMatrix.

Persyaratan Lisensi

Server MCP tersedia di paket Pro, Team dan Business, sama seperti API Lokal. Pada Starter, klien AI masih dapat terhubung, tetapi setiap alat akan menjawab dengan pesan peningkatan paket.

Mengaktifkannya

1. Buka TikMatrix → Pengaturan → API Pengembang.
2. Aktifkan Klien AI (MCP). Fitur ini nonaktif secara default.
3. Salin konfigurasi untuk klien AI Anda dari bagian yang sama. Konfigurasi itu sudah berisi nama server yang benar, alamat, dan untuk Claude Desktop, path lengkap ke program TikMatrix di komputer ini.

TikMatrix harus berjalan saat Anda menggunakannya. Server hanya menjawab komputer ini: komputer lain di jaringan Anda tidak dapat mengaksesnya.

Hubungkan Klien AI Anda

Claude Desktop

Claude Desktop menjalankan server MCP sebagai program, jadi TikMatrix menyediakan mode relay kecil. Buka Settings → Developer → Edit Config di Claude Desktop dan tambahkan cuplikan yang disalin dari TikMatrix ke claude_desktop_config.json. Tampilannya seperti ini — path-nya adalah path di komputer Anda:

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

Restart Claude Desktop. Opsi --mcp-stdio tidak membuka jendela kedua; opsi itu hanya meneruskan pesan ke TikMatrix yang sudah berjalan.

Claude Code

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

Cursor dan klien lainnya

Klien yang menerima URL server terhubung langsung ke endpoint Streamable HTTP:

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

Nama server berbeda menurut edisi (tikmatrix, igmatrix atau tikmatrix-pro); cuplikan di Pengaturan menggunakan nama yang benar.

Yang Dapat Dilakukan AI

Alat	Yang dilakukannya	Perlu persetujuan Anda
list_devices	Ponsel yang terhubung, apakah masing-masing online atau sibuk, dan grupnya	Tidak
list_accounts	Akun, perangkat tempat setiap akun berada, dan apakah sudah login	Tidak
list_groups	Grup perangkat	Tidak
get_script_schema	Pengaturan yang diterima setiap skrip	Tidak
list_tasks	Tugas, difilter berdasarkan status, perangkat, atau skrip	Tidak
get_task_log	Log dari satu tugas	Tidak
get_activity_log	Aktivitas aplikasi terbaru	Tidak
device_screenshot	Yang sedang tampil di layar ponsel	Tidak
list_custom_scripts	Skrip kustom yang sudah Anda daftarkan	Tidak
get_custom_script_guide	Cara menulis skrip kustom	Tidak
plan_tasks	Menghitung tepatnya tugas apa yang akan dibuat sebuah permintaan, tanpa membuatnya	Tidak
create_tasks	Membuat tugas dari sebuah rencana	Ya
stop_task	Menghentikan tugas yang sedang berjalan	Ya
retry_task	Menjalankan ulang tugas yang gagal	Ya
create_custom_script	Menulis dan mendaftarkan skrip kustom baru	Ya
get_approval	Memeriksa bagaimana permintaan yang menunggu persetujuan berakhir	Tidak

Menyetujui Perubahan

Saat AI mengirimkan perubahan, TikMatrix muncul di depan dan menunjukkan apa yang akan dilakukannya: untuk sekumpulan tugas, skrip, pengaturannya, serta setiap perangkat, akun, dan target, baris demi baris. Pilih Setujui untuk menjalankannya atau Tolak untuk membatalkannya.

• Jika Anda menjawab dalam sekitar 50 detik, AI langsung menerima hasilnya.
• Jika Anda lebih lama, AI diberi tahu bahwa permintaan menunggu Anda. Menyetujui setelahnya tetap menjalankannya, dan AI dapat menanyakan hasilnya.
• Permintaan yang tidak dijawab kedaluwarsa setelah 15 menit, bersama rencana asalnya.
• Tugas yang dibuat dengan cara ini menampilkan sumber mcp di daftar tugas.

Contoh Permintaan

• "Ponsel mana saja yang offline, dan akun mana yang logout?"
• "Lakukan pemanasan untuk setiap akun di grup US-1 selama 20 menit, mulai pukul 9 malam ini."
• "Mengapa tiga tugas posting terakhir gagal? Tampilkan layar ponsel yang gagal."

Keamanan

• Hanya lokal. Endpoint hanya menerima koneksi dari komputer ini, dan menolak permintaan yang berasal dari halaman web.
• Nonaktif secara default. Tidak ada yang bisa terhubung sampai Anda mengaktifkannya, dan menonaktifkannya langsung berlaku.
• Setiap perubahan disetujui oleh Anda. Ini tidak bergantung pada pengaturan izin klien AI Anda sendiri.

Pemecahan Masalah

Pesan	Yang harus dilakukan
"AI client access is turned off"	Aktifkan Klien AI (MCP) di Pengaturan → API Pengembang.
"The app is not running"	Mulai TikMatrix, lalu coba lagi.
"API access requires Pro or higher plan"	Tingkatkan ke paket Pro, Team atau Business.
AI mengatakan permintaan sedang menunggu, tetapi tidak ada yang muncul	Bawa jendela TikMatrix ke depan; persetujuan menunggu di sana.