Lewati ke konten
GoSosmed Docs

Mengenal MCP Hub

Model Context Protocol (MCP) adalah standar terbuka yang memungkinkan model bahasa besar (LLM) dan asisten AI berinteraksi langsung dengan sistem eksekusi eksternal. GoSosmed menyediakan MCP Hub resmi yang mengekspos 24 tools otomasi Android, memungkinkan agent AI seperti Claude Code, Cursor, Windsurf, ZeroClaw, atau skrip mandiri untuk mengamati dan mengendalikan perangkat Android nyata milik pengguna.

Berbeda dari otomasi web biasa, MCP Hub GoSosmed dirancang khusus untuk ekosistem BYOD (Bring Your Own Device): interaksi terjadi di perangkat fisik pengguna sendiri, tanpa emulasi di awan dan tanpa memindahkan sesi akun sosial media dari ponsel.

Mengapa MCP untuk Mobile BYOD?

Section titled “Mengapa MCP untuk Mobile BYOD?”

Otomasi aplikasi mobile modern (Instagram, TikTok, YouTube, Facebook, Threads) memiliki karakteristik dinamis yang sulit ditangani oleh skrip statis: tata letak antarmuka kerap berubah, dialog verifikasi dapat muncul sewaktu-waktu, dan alur aplikasi memiliki jeda animasi.

Dengan MCP Hub:

  • AI Agent bertindak sebagai pengemudi cerdas: Membaca kondisi layar saat ini, mengambil keputusan kontekstual, dan menjalankan aksi selanjutnya langkah demi langkah.
  • Protokol v2 terpadu: Aksi majemuk (compound actions) memangkas latensi putaran (round-trip) antara AI dan perangkat hingga 50%.
  • Zero Raw Coordinates: Pengetukan dan input berbasis semantik elemen UI (accessibility action), bukan tebakan koordinat piksel mentah yang rapuh terhadap perbedaan resolusi layar.

Konsep Arsitektur Dual-Engine

Section titled “Konsep Arsitektur Dual-Engine”

MCP Hub GoSosmed memanfaatkan arsitektur Dual-Engine pada aplikasi Mobile Agent di ponsel:

Mesin Teknologi Peran & Keunggulan
Inspection Engine Android Accessibility Service Membaca hierarki simpul antarmuka langsung dari memori sistem (<2 ms), mendeteksi teks tombol, deskripsi aksesibilitas (content description), dan status keterlihatan tanpa overhead serialisasi.
Execution Engine Privileged Local Wireless ADB Mengeksekusi pengetukan, geseran (swipe), penekanan tombol perangkat keras, dan pengiriman teks IME secara deterministik di level sistem tanpa memerlukan kabel data atau PC terhubung.

Kombinasi kedua mesin ini menghadirkan kecepatan tinggi sekaligus stabilitas deterministik: AI membaca apa yang sedang tampil di layar lewat Accessibility, lalu menggerakkan aplikasi secara presisi melalui transport lokal ponsel.

Diagram Alur Eksekusi

Section titled “Diagram Alur Eksekusi”
+-------------------------------------------------------+
|  AI Client (Claude Code / Cursor / ZeroClaw / Script) |
+---------------------------+---------------------------+
                            | HTTP SSE / POST (Bearer gsk_live_...)
                            v
+-------------------------------------------------------+
|     GoSosmed MCP Hub (api.bamsbung.id/mcp)            |
|  - Validasi Tenant & Pembatasan Kuota                 |
|  - Smart Auto-Serial Resolver                         |
+---------------------------+---------------------------+
                            | Protokol Kontrol Internal (WSS)
                            v
+-------------------------------------------------------+
|       Mobile Agent APK v1.2.0 (HP Android Fisik)      |
|  - Accessibility Service (In-Memory Node Lookup)      |
|  - Local Wireless ADB Loopback            |
|  - Global Screen Dimming & Sensor Kredensial Otomatis |
+-------------------------------------------------------+

Tiga karakteristik penting dari arsitektur ini:

  1. Koneksi Keluar yang Aman: HP Android pengguna menghubungi server GoSosmed melalui koneksi aman keluar (outbound WebSocket). Ponsel tidak memerlukan IP publik, tidak membuka port ke internet terbuka, dan aman berada di balik NAT atau Wi-Fi seluler.
  2. Isolasi Penuh Multi-Tenant: Kunci API pengguna (gsk_live_...) secara ketat diisolasi ke tingkat ruang kerja (tenant). Agent AI yang terhubung hanya dapat melihat dan mengontrol perangkat serta akun milik pengguna yang bersangkutan.
  3. Kedaulatan Sesi Login: Kredensial dan sesi login akun sosial media tetap berada di dalam aplikasi resmi pada HP pengguna. Server dan AI tidak pernah menyimpan kata sandi akun Anda.

Smart Auto-Serial Fallback

Section titled “Smart Auto-Serial Fallback”

Dalam arsitektur multi-perangkat tradisional, AI sering kali mengalami kegagalan karena harus menanyakan nomor seri perangkat terlebih dahulu (device discovery round-trip).

MCP Hub GoSosmed dilengkapi fitur Smart Auto-Serial Fallback:

  • Jika sebuah tool dipanggil dengan parameter serial kosong (serial: "") atau tanpa menyertakan argumen serial, sistem secara cerdas menyelesaikan target ke perangkat aktif tunggal milik tenant yang sedang online.
  • Jika tenant memiliki lebih dari satu perangkat online, AI dapat menyaring perangkat secara eksplisit melalui tool list_devices dan menyertakan serial spesifik.
  • Hal ini menyederhanakan instruksi kerja LLM dan mengeliminasi kegagalan akibat halusinasi ID.

Efisiensi Token Dramatis (>99% Token Saving)

Section titled “Efisiensi Token Dramatis (>99% Token Saving)”

Tantangan terbesar mengoperasikan AI Agent pada aplikasi mobile adalah konsumsi token konteks jendela LLM. Pendekatan konvensional yang membuang seluruh dump hierarki UI XML (100–300 KB) dapat menghabiskan 30.000 hingga 50.000 token per langkah, menyebabkan biaya API melonjak dan respons menjadi lambat.

GoSosmed MCP Hub menyelesaikan masalah ini melalui dua teknik kompresi cerdas:

  1. Set-of-Marks Visual Compact (annotated_screenshot): Alih-alih mengirim gambar resolusi penuh mentah atau pohon XML raksasa, MCP Hub menghasilkan tangkapan layar teranotasi nomor [1], [2], [3] beserta koordinat pusat ringkas. Metode ini memangkas konsumsi token hingga 150–300 token per observasi (penghematan >99%).
  2. Native In-Memory Polling (wait_for_node): Pengecekan apakah sebuah tombol atau layar telah terbuka dilakukan langsung di dalam RAM HP (<200 ms). Server dan AI tidak perlu melakukan penarikan XML berulang (zero polling overhead).

Langkah Selanjutnya

Section titled “Langkah Selanjutnya”