Gologin MCP Server

AI Ajanları için GoLogin MCP Sunucusu

GoLogin tarayıcı profillerini, proxy'leri, parmak izlerini, klasörleri ve bulut tarayıcı oturumlarını yapay zeka konuşmaları aracılığıyla yönetin. Bu Model Context Protocol (MCP) sunucusu, yapay zeka istemcinizi GoLogin API'sine bağlar.

Hızlı Başlangıç

Node.js 22 veya daha yenisine, aktif bir GoLogin hesabına ve bir GoLogin API token'ına ihtiyacınız var. Node.js 22 ve 24 LTS, macOS Apple Silicon üzerinde test edilmiştir.

1. GoLogin hesabınıza giriş yapın, API & MCP bölümünü açın ve API sekmesinde bir token oluşturun.
2. Bu yapılandırmayı MCP istemcinize ekleyin ve token yer tutucusunu değiştirin. Mevcut herhangi bir mcpServers yapılandırmasıyla birleştirin.

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

3. İstemcinizin MCP bağlantısını yeniden başlatın veya yeniden yükleyin, ardından şunu sorun: "GoLogin profillerimi göster."

İstemci sunucuyu otomatik olarak başlatır. -y, npm'in etkileşimli onay olmadan paketi yüklemesini sağlar. Bu sunucu API_TOKEN değerini okur; diğer GoLogin CLI'ları tarafından kullanılan GOLOGIN_TOKEN değişkeni burada bir takma ad değildir.

Terminal başlatma kontrolü için, ortamınızda API_TOKEN zaten ayarlıyken:

npx -y gologin-mcp

Sunucu standart giriş/çıkış (stdio) üzerinden iletişim kurar ve bir MCP istemcisini bekler. Kendi başına bir tarayıcı açmaz veya etkileşimli bir komut istemi sağlamaz.

Neler Yapabilirsiniz

• Tarayıcı profilleri oluşturun, okuyun, güncelleyin, silin ve düzenleyin.
• Profil proxy'lerini yapılandırın ve tarayıcı parmak izlerini yenileyin.
• Klasörleri ve profil üyeliklerini yönetin.
• Hesap bilgilerini okuyun.
• GoLogin bulutunda tarayıcı profillerini başlatın ve durdurun.

Bulut başlatma bir bağlantı URL'si döndürür. Bu sunucu sayfa gezinme, tıklama, form doldurma veya yerel Orbita başlatma araçlarını açığa çıkarmaz. Sayfa otomasyonu için ayrı bir tarayıcı otomasyon istemcisi veya GoLogin Agent Browser CLI kullanın.

MCP süreci yerel olarak çalışır; GoLogin API istekleri ve bulut tarayıcı oturumları ağ erişimi gerektirir. Bulut kullanılabilirliği ve API işlemleri, hesap izinlerinize ve planınıza bağlıdır.

Araçlar

Araç adları, sunucunun başlangıçta yüklediği GoLogin OpenAPI spesifikasyonundaki HTTP yöntemi ve yolundan üretilir. Aşağıdakiler mevcut araçların bir seçkisidir, sabit bir takma ad listesi değildir. Güncel adlar ve giriş şemaları için MCP istemcinizde tools/list sorgulayın.

Araç	Açıklama
get_profile_v2	Sayfalama ve klasör filtreleriyle profilleri listele ve ara
post_profile_custom	Ad, işletim sistemi ve proxy gibi kısmi ayarlarla bir profil oluştur
get_profile_id	Bir profili kimliğine göre oku
put_profile_id_custom	Seçili profil ayarlarını güncelle
delete_profile	profilesToDelete içinde listelenen profilleri sil
patch_profile_proxy_many_v2	Bir veya daha fazla profil için proxy yapılandır
patch_profile_fingerprints	browsersIds içinde listelenen profiller için parmak izlerini yenile
get_proxy_v2	Proxy'leri listele
get_folders	Klasörleri listele
post_folders_folder	Ada göre bir klasör oluştur
patch_folders_folder	Bir klasöre profil ekle veya kaldır
delete_folders_folder	Ada göre bir klasörü sil
post_profile_id_web	Bir profili bulutta başlat ve bir bağlantı URL'si döndür
delete_profile_id_web	Bir bulut profilini durdur
get_user	Hesap bilgilerini oku

Örneğin, bir MCP istemcisi bir profili okumak için şu tools/call isteğini gönderebilir:

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

Argümanlar her aracın giriş şemasını takip eder. Yol ve sorgu parametreleri ile istek gövdesi alanları, üst düzey argümanlar olarak iletilir.

Örnek Komutlar

• "GoLogin profillerimi göster."
• "'Research' adında bir Linux profili oluştur."
• "PROFILE_ID profilini 'Research US' olarak yeniden adlandır."
• "PROFILE_ID profilini bu proxy ayarlarını kullanacak şekilde güncelle."
• "PROFILE_ID profili için parmak izini yenile."
• "'Research' adında bir klasör oluştur ve PROFILE_ID profilini ekle."
• "PROFILE_ID profilini bulutta başlat ve bana bağlantı URL'sini ver."
• "PROFILE_ID profili için bulut oturumunu durdur."
• "GoLogin hesap bilgilerimi göster."

MCP İstemcileri için Kurulum

Claude Desktop

Ayarlar > Geliştirici > Yapılandırmayı Düzenle bölümünü açın ve Hızlı Başlangıç yapılandırmasını claude_desktop_config.json öğesine ekleyin. Claude Desktop'u tamamen kapatıp yeniden başlatın, ardından gologin-mcp ve araçlarının kullanılabilir olduğunu kontrol edin.

Yapılandırma yolları ve sorun giderme için resmi yerel MCP kurulum kılavuzuna bakın.

Cursor

Hızlı Başlangıç yapılandırmasını kullanıcı hesabınız için ~/.cursor/mcp.json öğesine veya bir proje için .cursor/mcp.json öğesine ekleyin. MCP bağlantısını yeniden yükleyin ve sunucunun araçlarını etkinleştirin. API token'ları içeren yapılandırmaları sürüm kontrolü dışında tutun.

Güncel istemci ayarları için Cursor'ın MCP belgelerine bakın.

Diğer MCP İstemcileri

Yerel stdio MCP sunucularını destekleyen bir istemci kullanın. npx komutunu, -y ve gologin-mcp argümanlarını ve sunucu ortamında API_TOKEN değerini yapılandırın. Yapılandırma biçimi ve konumu istemciye bağlıdır.

Sorun Giderme

• Sunucu bağlanmıyor: Node.js ve npx öğesinin istemci tarafından kullanılabilir olduğunu kontrol edin, ardından MCP bağlantısını yeniden başlatın. Sunucunun araç tanımlarını yüklemek için ayrıca docs-download.gologin.com erişimi gerekir.
• API 401 Unauthorized döndürüyor: Sunucuya iletilen API_TOKEN değerini ve token'ın GoLogin'deki geçerliliğini kontrol edin. Değiştirdikten sonra bağlantıyı yeniden başlatın.
• Araç adı bulunamadı: Araç listesini yenileyin ve tools/list tarafından döndürülen adları kullanın; list_profiles ve start_browser gibi adlar yerleşik takma adlar değildir.
• Bulut başlatma başarısız: API yanıtını ve hesabınızın bulut erişimini kontrol edin. Yerel MCP başlatma, bilgisayarınızda Orbita'yı kendisi başlatmaz.

Geliştirme

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

API_TOKEN zaten yapılandırılmışken yerel derlemenizi çalıştırmak için:

node dist/index.js

Yayınlamadan önce şunu çalıştırın:

npm run release:check

Paket yalnızca derlenmiş sunucuyu, paket meta verilerini, README'yi ve lisansı içerir. Sürüm kontrolü bu beyaz listeyi doğrular; böylece yerel durum, veritabanları, kimlik bilgileri ve geliştirme dosyaları ek dosyalar olarak dahil edilemez. npm publish aynı kontrolü otomatik olarak çalıştırır.

MCP Kayıt Sürümleri

server.json, bu sunucuyu io.github.gologinapp/gologin-mcp altındaki resmi MCP Kaydı için tanımlar. npm paketi, mcpName içinde aynı tanımlayıcıyı bildirir.

package.json, package-lock.json ve server.json içindeki sürümleri hizalı tutun. Önce kontrol edilen npm paketini yayınlayın, ardından deponun Eylemler sekmesinden main üzerinde MCP Kaydına Yayınla işlemini çalıştırın. İş akışı, npm sürümünün doğru Kayıt tanımlayıcısını içerdiğini doğrular ve ayrı bir Kayıt token'ı olmadan GitHub OIDC kullanarak kimlik doğrular. npm'e yayınlamaz.

Bağlantılar

• GoLogin
• GoLogin API belgeleri
• npm paketi
• Glama dizini

Lisans

MIT, telif hakkı GoLogin.