Gologin MCP Server

Server MCP GoLogin untuk Agen AI

Kelola profil browser GoLogin, proxy, sidik jari, folder, dan sesi browser cloud melalui percakapan AI. Server Model Context Protocol (MCP) ini menghubungkan klien AI Anda ke API GoLogin.

Memulai Cepat

Anda memerlukan Node.js 22 atau lebih baru, akun GoLogin yang aktif, dan token API GoLogin. Node.js 22 dan 24 LTS telah diuji pada macOS Apple Silicon.

1. Masuk ke akun GoLogin, buka API & MCP, dan buat token di tab API.
2. Tambahkan konfigurasi ini ke klien MCP Anda, ganti placeholder token. Gabungkan ke konfigurasi mcpServers yang sudah ada.

{
  "mcpServers": {
    "gologin-mcp": {
      "command": "npx",
      "args": ["-y", "gologin-mcp"],
      "env": {
        "API_TOKEN": "your-gologin-api-token-here"
      }
    }
  }
}

3. Mulai ulang atau muat ulang koneksi MCP klien Anda, lalu tanyakan: "Tampilkan profil GoLogin saya."

Klien memulai server secara otomatis. -y memungkinkan npm menginstal paket tanpa konfirmasi interaktif. Server ini membaca API_TOKEN; variabel GOLOGIN_TOKEN yang digunakan oleh CLI GoLogin lainnya bukanlah alias di sini.

Untuk pemeriksaan startup terminal, dengan API_TOKEN sudah diatur di lingkungan Anda:

npx -y gologin-mcp

Server berkomunikasi melalui input/output standar (stdio) dan menunggu klien MCP. Server tidak membuka browser atau menyediakan prompt perintah interaktif dengan sendirinya.

Yang Dapat Anda Lakukan

• Buat, baca, perbarui, hapus, dan atur profil browser.
• Konfigurasikan proxy profil dan segarkan sidik jari browser.
• Kelola folder dan keanggotaan profilnya.
• Baca informasi akun.
• Mulai dan hentikan profil browser di cloud GoLogin.

Startup cloud mengembalikan URL koneksi. Server ini tidak mengekspos navigasi halaman, klik, pengisian formulir, atau alat peluncuran Orbita lokal. Untuk otomatisasi halaman, gunakan klien otomatisasi browser terpisah atau CLI GoLogin Agent Browser.

Proses MCP berjalan secara lokal; permintaan API GoLogin dan sesi browser cloud memerlukan akses jaringan. Ketersediaan cloud dan operasi API bergantung pada izin dan paket akun Anda.

Alat

Nama alat dihasilkan dari metode HTTP dan jalur di spesifikasi OpenAPI GoLogin, yang dimuat server saat startup. Berikut adalah pilihan alat yang tersedia, bukan daftar alias tetap. Kueri tools/list di klien MCP Anda untuk nama dan skema input saat ini.

Alat	Deskripsi
get_profile_v2	Daftar dan cari profil, dengan paginasi dan filter folder
post_profile_custom	Buat profil dengan pengaturan parsial seperti nama, OS, dan proxy
get_profile_id	Baca profil berdasarkan ID
put_profile_id_custom	Perbarui pengaturan profil yang dipilih
delete_profile	Hapus profil yang tercantum di profilesToDelete
patch_profile_proxy_many_v2	Konfigurasikan proxy untuk satu atau lebih profil
patch_profile_fingerprints	Segarkan sidik jari untuk profil yang tercantum di browsersIds
get_proxy_v2	Daftar proxy
get_folders	Daftar folder
post_folders_folder	Buat folder berdasarkan nama
patch_folders_folder	Tambah atau hapus profil dari folder
delete_folders_folder	Hapus folder berdasarkan nama
post_profile_id_web	Mulai profil di cloud dan kembalikan URL koneksi
delete_profile_id_web	Hentikan profil cloud
get_user	Baca informasi akun

Misalnya, klien MCP dapat mengirim permintaan tools/call ini untuk membaca profil:

{
  "name": "get_profile_id",
  "arguments": {
    "id": "your-profile-id"
  }
}

Argumen mengikuti skema input setiap alat. Parameter jalur dan kueri, serta kolom isi permintaan, diteruskan sebagai argumen tingkat atas.

Contoh Prompt

• "Tampilkan profil GoLogin saya."
• "Buat profil Linux bernama 'Research'."
• "Ubah nama profil PROFILE_ID menjadi 'Research US'."
• "Perbarui profil PROFILE_ID untuk menggunakan pengaturan proxy ini."
• "Segarkan sidik jari untuk profil PROFILE_ID."
• "Buat folder bernama 'Research' dan tambahkan profil PROFILE_ID ke dalamnya."
• "Mulai profil PROFILE_ID di cloud dan berikan saya URL koneksi."
• "Hentikan sesi cloud untuk profil PROFILE_ID."
• "Tampilkan informasi akun GoLogin saya."

Pengaturan untuk Klien MCP

Claude Desktop

Buka Settings > Developer > Edit Config dan tambahkan konfigurasi Memulai Cepat ke claude_desktop_config.json. Keluar sepenuhnya dan mulai ulang Claude Desktop, lalu periksa bahwa gologin-mcp dan alatnya tersedia.

Lihat panduan pengaturan MCP lokal resmi untuk jalur konfigurasi dan pemecahan masalah.

Cursor

Tambahkan konfigurasi Memulai Cepat ke ~/.cursor/mcp.json untuk akun pengguna Anda, atau .cursor/mcp.json untuk proyek. Muat ulang koneksi MCP dan aktifkan alat server. Simpan konfigurasi yang berisi token API di luar kontrol versi.

Lihat dokumentasi MCP Cursor untuk pengaturan klien saat ini.

Klien MCP Lainnya

Gunakan klien yang mendukung server MCP stdio lokal. Konfigurasikan npx sebagai perintah, -y dan gologin-mcp sebagai argumennya, dan API_TOKEN di lingkungan server. Format dan lokasi konfigurasi bergantung pada klien.

Pemecahan Masalah

• Server tidak terhubung: periksa bahwa Node.js dan npx tersedia untuk klien, lalu mulai ulang koneksi MCP-nya. Server juga memerlukan akses ke docs-download.gologin.com untuk memuat definisi alatnya.
• API mengembalikan 401 Unauthorized: periksa API_TOKEN yang diteruskan ke server dan validitas token di GoLogin. Mulai ulang koneksi setelah mengubahnya.
• Nama alat tidak ditemukan: segarkan daftar alat dan gunakan nama yang dikembalikan oleh tools/list; nama seperti list_profiles dan start_browser bukanlah alias bawaan.
• Startup cloud gagal: periksa respons API dan akses cloud akun Anda. Startup MCP lokal tidak dengan sendirinya memulai Orbita di komputer Anda.

Pengembangan

git clone https://github.com/gologinapp/gologin-mcp.git
cd gologin-mcp
npm ci
npm run build

Untuk menjalankan build lokal Anda dengan API_TOKEN yang sudah dikonfigurasi:

node dist/index.js

Sebelum menerbitkan, jalankan:

npm run release:check

Paket hanya menyertakan server yang dibangun, metadata paket, README, dan lisensi. Pemeriksaan rilis memverifikasi daftar izin ini sehingga status lokal, database, kredensial, dan file pengembangan tidak dapat disertakan sebagai file tambahan. npm publish menjalankan pemeriksaan yang sama secara otomatis.

Rilis Registry MCP

server.json menjelaskan server ini untuk Registry MCP resmi di bawah io.github.gologinapp/gologin-mcp. Paket npm mendeklarasikan pengidentifikasi yang sama di mcpName.

Jaga versi di package.json, package-lock.json, dan server.json tetap selaras. Terbitkan paket npm yang diperiksa terlebih dahulu, lalu jalankan Publish to MCP Registry dari tab Actions repositori di main. Alur kerja memverifikasi bahwa rilis npm berisi pengidentifikasi Registry yang benar dan mengautentikasi menggunakan GitHub OIDC, tanpa token Registry terpisah. Ini tidak menerbitkan ke npm.

Tautan

• GoLogin
• Dokumentasi API GoLogin
• Paket npm
• Direktori Glama

Lisensi

MIT, hak cipta GoLogin.