Ana içeriğe atla

Genel bakış

Nudgen, uygulama origin’inizin /mcp uç noktasında MCP sunucusu barındırır. Streamable HTTP üzerinden MCP 2026-07-28 desteklenir ve OAuth 2.1 gerekir. Tarayıcıda oturum açıp istenen izinleri onaylayın. Kullanılabilir olduğunda tek bir çalışma alanını seçin veya üyesi olduğunuz mevcut ve gelecekteki tüm çalışma alanlarına açıkça erişim verin. Kontrol panelinde alan değiştirmek MCP varsayılanını değiştirmez.

Birden fazla çalışma alanıyla çalışın

Mevcut bağlantılar, yeniden bağlanıp daha geniş erişimi onaylayana kadar ilk çalışma alanıyla sınırlı kalır. Tüm alanlara erişimde yeni üyelikler otomatik kullanılabilir. Üyelik sona erdiğinde o alandaki sonraki işlemler engellenir. Roller, abonelikler ve kotalar her çalışma alanında ayrı uygulanır. Kimlikleri, adları, slug değerlerini, rolleri ve varsayılan alanı görmek için list_workspaces aracını page ve pageSize ile kullanın. teams:read gerekir. Yalnızca belirli bir işlem için alan seçmek üzere araç çağrısına workspaceId ekleyin. Eklenmezse bağlantının varsayılanı kullanılır. Kampanyayı incelerken ve gönderirken aynı açık çalışma alanı kimliğini iletin. OAuth onayı sırasında varsayılanı seçin. Ayarlar → API Anahtarları → Bağlı MCP uygulamaları bölümünden veya workspaceId ve teams:write izniyle set_default_workspace çağırarak değiştirin. Bu değişiklik bağlantıyı kullanan tüm sohbetleri etkiler. Tek çağrılık seçim varsayılanı değiştirmez. Varsayılan silinirse veya erişilemezse başka bir kimlik belirtin ya da varsayılanı güncelleyin. Nudgen sessizce başka bir alan seçmez.
Mevcut kaynak URI’leri varsayılan alanı kullanır. Bu şablonlar belirli bir alanı açıkça hedefler:

Bu neden önemlidir

Asistanınız kişileri inceleyebilir, işletme arayabilir ve kampanya taslakları oluşturabilir. Gönderime veya zamanlamaya sohbette izin verin; asistan tarayıcı onay bağlantısı olmadan doğrudan işlemi yürütür.

İstemcinizi bağlayın

Üretim uç noktası:
Bu uç noktayı OAuth destekli bir istemciye uzak HTTP MCP sunucusu olarak ekleyin. İstemci, uç noktadan Nudgen’ın yetkilendirme sunucusunu keşfeder ve tarayıcıda oturum açma ve izin verme akışını açar. İstemcinin erişmesini istediğiniz çalışma alanını seçin ve yalnızca ihtiyaç duyduğu kapsamları onaylayın. Keşif belgeleri: Yetkilendirme sunucusu; PKCE S256, kaynak bağlama ve yenileme jetonu rotasyonu ile yetkilendirme kodu akışını kullanır. Client ID Metadata Documents ve dinamik istemci kaydını kabul eder. Codex CLI için şunları kullanın:
nudgen adlı bir istemci zaten yapılandırılmışsa bu kaydı /mcp URL’siyle güncelleyin. Okumak için campaigns:read, taslak ve düzenleme için campaigns:write, izin verilen e-posta işlemleri için campaigns:send kullanın. OAuth izni hâlâ gereklidir.
Kişisel Erişim Jetonları Geliştirici API’sinde kimlik doğrulaması yapar ancak /mcp için kimlik doğrulaması yapmaz. Bir MCP istemcisi OAuth oturum açma işlemini tamamlamalıdır.

Kullanılabilir araçlar

create_campaign, kampanya taslağı (one-time, drip veya lifetime) kaydeder. Doğrudan gönderim yapamaz veya zamanlama oluşturamaz. get_campaign, başlatmadan önce konuyu, içeriği, bağlantıyı, hedef kitleyi ve göndereni kontrol etmenizi sağlar. Sunucu ayrıca campaigns:read kapsamında salt okunur kaynaklar sunar:

Harita potansiyel müşterilerini bulun ve içe aktarın

  1. Asistandan search_map_leads aracını bir konum ve işletme anahtar kelimeleriyle, örneğin bir şehir ve marketing agency ile çağırmasını isteyin.
  2. İsteğe bağlı filtreler; radiusKm (1–100), lat ve lng ile yalnızca e-posta adresi yayımlayan işletmeleri tutmak için emailOnly alanlarıdır.
  3. Sonuçta nextPageToken varsa başka bir sayfa yüklemek için bunu pageToken olarak iletin.
  4. Asistandan aynı konum ve anahtar kelimelerin yanı sıra kaydedilecek potansiyel müşteri nesneleriyle import_map_leads aracını çağırmasını isteyin. Her çağrı en fazla 200 potansiyel müşteri kabul eder.
İçe aktarma işlemi, bağlı çalışma alanına kişiler yazar. E-posta adresi olmayan potansiyel müşteriler atlanır. Zaten mevcut olan bir potansiyel müşteri güncellenir.

Kampanya taslağını başlatın

  1. Kampanya adını, konuyu, içeriği, gerçek göndereni, tahmini alıcı sayısını ve zamanı get_campaign ile inceleyin.
  2. İşleme sohbette izin verin. Asistan kampanya kimliğiyle birlikte hemen gönderim için sendNow: true veya saat dilimi içeren gelecekteki bir zaman için scheduledAt belirterek launch_campaign aracını doğrudan çağırır. Çelişen zaman bilgileri vermeyin. Önceden verilen izin için tekrar onay gerekmez.
  3. Dönen durumu, planlanan zamanı ve panel bağlantısını inceleyin. Kuyrukta veya planlanmış olması teslim edildiği anlamına gelmez. Sonuç belirsizse yeniden denemeden önce get_campaign ve get_campaign_stats ile kontrol edin.
Nudgen çalışma alanı izinlerini, gönderen hazırlığını, uygun alıcıları, aboneliği, kotayı, kampanya sürümünü ve kuyruğu kontrol etmeye devam eder. Oluşturma ve düzenleme yalnızca taslak kaydeder; teslimat kampanya çalışanını gerektirir.

Erişimi yönetin

Erişimi görmek, varsayılanı değiştirmek veya bağlantıyı kesmek için Ayarlar → API Anahtarları → Bağlı MCP uygulamaları bölümünü açın. Çok alanlı bağlantıyı kesmek, ayrı REST bağlantılarını etkilemeden tüm alanlardaki tokenlarını ve bekleyen yetkilendirme kodlarını iptal eder. REST OAuth ve uygulama içi asistan mevcut alan sınırlarını korur.

Sorun giderme

Taşıyıcı jetonlar ve doğrudan REST uç noktaları kullanan komut dosyaları için Geliştirici API’sine bakın.

Arama yarıçapı ve zenginleştirme

API ve MCP varsayılan olarak 5 km kullanır, 1–100 arasında tam sayı radiusKm kabul eder ve panel onay iletişim kutusunu göstermez. nextPageToken değerini pageToken olarak gönderirken arama parametrelerini koruyun. Boş sayfanın da sonraki sayfası olabilir. enrichmentPending tamamlanmamış web sitesi araştırmasını gösterir. Varsa businessSummary ve businessSources alanlarını inceleyin. İçe aktarılan işletme bağlamı kişiselleştirilmiş kampanya girişlerine yardımcı olabilir. Eksik e-posta hâlâ araştırılıyor olabilir. enrichmentRetryToken varsa campaigns:read ile retry_map_leads_enrichment aracına token gönderin. Token bağlı çalışma alanına özeldir, 15 dakikada sona erer ve bir kez kullanılır. İçe aktarmadan önce sonuçları placeId ile birleştirin. emailOnly geçerli yanıtı filtreler; yeniden denemeden sonra yeni potansiyel müşteriler görünebilir.

Taslak düzenleme ve ürün kapsamı

Mevcut bir taslağı düzenlemek için update_campaign, silmek için delete_campaign kullanın. İkisi de campaigns:write gerektirir; e-posta göndermez veya zamanlamaz. Yeni ürün alanları kendi OAuth izinlerini gerektirir. İstendiğinde yeniden bağlanıp bu izinleri onaylayın. Araç listesi kullanılabilir araçları ve parametreleri gösterir. Tarayıcı yönlendirmeleri işlem gerçekleştirmez. Ödemeler, sağlayıcı yetkilendirmesi, davetler, alan oluşturma/silme/katılma ve hassas ödeme ayarları için tarayıcıyı kullanın. MCP hedefi veya varsayılanı kontrol panelindeki alanı değiştirmez. Yönetim, kimlik bilgileri, webhook’lar, izleme geri çağrıları ve dahili asistan kapsam dışındadır. API kapsamını get_api_capabilities ile inceleyin. Sohbette izin verdikten sonra send_test_email, activate_lifetime_campaign veya trigger_lifetime_campaign aracını doğrudan çağırın. Testler yalnızca hesap e-postasına gönderilir. Lifetime etkinleştirme gelecekteki otomatik gönderimleri açar. Tarayıcı onayı veya onay kimliği gerekmez. Sonuç belirsizse yeniden denemeden önce durumu veya işlem geçmişini kontrol edin.