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çinlist_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.
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ı:
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
- Asistandan
search_map_leadsaracını bir konum ve işletme anahtar kelimeleriyle, örneğin bir şehir vemarketing agencyile çağırmasını isteyin. - İsteğe bağlı filtreler;
radiusKm(1–100),latvelngile yalnızca e-posta adresi yayımlayan işletmeleri tutmak içinemailOnlyalanlarıdır. - Sonuçta
nextPageTokenvarsa başka bir sayfa yüklemek için bunupageTokenolarak iletin. - Asistandan aynı konum ve anahtar kelimelerin yanı sıra kaydedilecek potansiyel müşteri nesneleriyle
import_map_leadsaracını çağırmasını isteyin. Her çağrı en fazla 200 potansiyel müşteri kabul eder.
Kampanya taslağını başlatın
- Kampanya adını, konuyu, içeriği, gerçek göndereni, tahmini alıcı sayısını ve zamanı
get_campaignile inceleyin. - İşleme sohbette izin verin. Asistan kampanya kimliğiyle birlikte hemen gönderim için
sendNow: trueveya saat dilimi içeren gelecekteki bir zaman içinscheduledAtbelirtereklaunch_campaignaracını doğrudan çağırır. Çelişen zaman bilgileri vermeyin. Önceden verilen izin için tekrar onay gerekmez. - 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_campaignveget_campaign_statsile kontrol edin.
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çinupdate_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.