n8n MCP Sunucusu: Yapay Zeka Ajanıyla Müşteri Adayı Bulma
n8n AI Agent artık bir Google Maps lead aramasını kendi başına çalıştırabiliyor. İşi düz cümleyle anlatıyorsunuz, ajan kategoriyi, ülkeyi, şehri ve arama boyutunu kendisi seçiyor, biten satırları geri okuyor. Bağlantı tek düğüm ve tek kimlik bilgisi.
Bu, her parametrenin akış çalışmadan önce sabitlendiği polling akışı rehberinden farklı bir otomasyon şekli. Burada parametreler ajanın kararı. Ucu açık araştırma için gerçekten faydalı, para harcayan her şey için gerçekten riskli. Bu yazının çoğu bu cümlenin ikinci yarısıyla ilgili.
Sabit akış mı, ajan mı?
İki yol da aynı API'yi çağırır ve aynı krediyi harcar. Fark, argümanları kimin seçtiğinde.
| Sabit akış (HTTP Request) | Yapay zeka ajanı (MCP) | |
|---|---|---|
| Kategoriyi ve şehri kim seçer | Siz, kurarken | Model, çalışırken |
| Tekrarlanabilirlik | Her çalıştırmada aynı | İsteğe göre değişir |
| Nerede iyi | Zamanlanmış partiler, kampanya başına tek niş | Araştırma, tek seferlik sorular, sohbet istekleri |
| Nasıl bozulur | Yanlış sonuç, izi kolay sürülür | Yanlış aramadan gelen inandırıcı sonuç |
| Gözden geçirme | Bir kez | Her talimat değişikliğinden sonra |
Pratikte tutan bir kural: aramayı akış çalışmadan önce yazabiliyorsanız yazın. İstek forma değil de cümleye benziyorsa ajana uzanın.
Uç nokta ajana ne veriyor
MCP sunucusu tek bir adres. El sıkışmayı n8n hallediyor.
| Ayar | Değer |
|---|---|
| Uç nokta | https://www.basedonb.com/api/mcp |
| Düğüm | MCP Client Tool, sürüm 1.2 veya üstü |
| Taşıma | HTTP Streamable |
| Kimlik doğrulama | Dynamic Client Registration açık MCP OAuth2, veya mcp kapsamı taşıyan API anahtarıyla Bearer auth |
Bağlandıktan sonra ajan on aracı çağırabilir:
| Araç | Ajan ne için kullanır |
|---|---|
submit_scrape | Arama başlatır. Kredi harcayan tek araç. |
get_scrape_status | İşin hâlâ çalışıp çalışmadığını kontrol eder |
get_scrape_results | Biten satırları sayfa sayfa okur |
list_scrapes | Yenisini başlatmadan önce son işlere bakar |
cancel_scrape | Yanlışlıkla başlatılan işi durdurur |
get_account | Plan ve hesap durumunu okur |
get_credits | Harcamadan önce bakiyeye bakar |
list_countries | Ülkeyi ISO koduna çevirir |
list_states | Noktalı GeoNames eyalet kodunu bulur, örneğin US.TX |
list_cities | Modelin tahmin etmiş olabileceği şehir yazımını doğrular |
Son üçü göründüğünden önemli. Teksas'taki diş hekimleri istenen bir model, eyalet kodunu gönül rahatlığıyla uydurur. Listeleme araçları tahmin yerine kontrol etmesini sağlar ve çağırmaları hiçbir şeye mal olmaz.
Bağlantı
1. Kimlik bilgisini bir kez oluşturun. n8n'de yukarıdaki uç nokta için bir MCP kimlik bilgisi ekleyin. MCP OAuth2 ile Dynamic Client Registration'ı açık bırakırsınız, n8n dönen yenileme jetonunu saklar, yani kimlik bilgisi bir kez kurulur ve sonra elleşilmez. Bearer auth ile panodaki API ve Webhook'lar bölümünden bir anahtar yapıştırırsınız. Ona sadece mcp kapsamını verin.
2. MCP Client Tool düğümünü ekleyin ve o kimlik bilgisini seçin. Taşımayı HTTP Streamable'da bırakın.
3. Düğümü AI Agent'ın araç portuna bağlayın, kullandığınız sohbet modelinin yanına. Ajan araç listesini kendisi keşfeder.
4. Araç listesini kısıtlayın. Düğüm sadece bir bölümünü açmanıza izin verir. Salt okunur araçlarla başlayın, birkaç istek çalıştırın, submit_scrape aracını ancak ondan sonra ekleyin. Kredi harcayamayan bir ajan üzerinde denemeler yapmak güvenlidir.
Sınırları sistem talimatı taşır
Araçlar neyin mümkün olduğunu anlatır. Hiçbiri sizin hesabınız için neyin makul olduğunu anlatmaz, o yüzden bunu talimat yapmak zorunda. İşe yarar bir başlangıç:
BasedOnBusiness araçlarıyla yerel işletme adayları buluyorsun.
Her aramadan önce:
- get_credits çağır. Bakiye istenen lead sayısının altındaysa
arama yapma, bakiyeyi bildir ve dur.
- Her yer adını list_countries, list_states veya list_cities ile
doğrula. Ülke veya eyalet kodunu asla uydurma.
Ararken:
- Kullanıcı açıkça daha büyük bir sayı söylemedikçe tek işte
50 leadden fazlasını isteme.
- Aynı anda tek kategori sor.
- Kredi, iş başlarken düşülür, sonuçlar dönerken değil. İptal
edilen iş krediyi geri vermez.
Asla desteklenmiyor:
- Posta koduyla arama ve bir adresin çevresinde yarıçapla arama
yok. Bunu söyle. Yakındaki bir şehri ikame etme.
İş bitince satır sayısını bildir ve dur. Sonuç listesinin
tamamını yapıştırma.
Oradaki her satır, işin belirli bir şekilde ters gitmesinden doğdu. Pahalı olanı kredi satırı.
Ajanın kendi başına keşfedemeyeceği üç limit
Kredi, gönderim anında ve istenen sayı üzerinden düşülür. 500 lead istemek, iş başladığı anda 500 krediye mal olur; geriye 500 satır da dönse on iki satır da dönse fark etmez. Sonradan uygulanan filtre ücreti azaltmaz, iptal de azaltmaz. Talimata konulacak en önemli cümle budur, çünkü maliyet sinyali olmayan bir model kapsamlı görünmek için sayıları yukarı yuvarlar.
İşlerin sert tavanları var. Bir iş en fazla 10 arama terimi taşıyabilir. Bir hesapta aynı anda 2 açık iş olabilir ve bütün açık işlerin toplam hedefi 5.000 leadi geçemez. Yirmi şehirlik bir listede şehir başına bir iş fırlatan ajan, lead yerine 429 yanıtı toplar. Konumları sırayla işlemesini ve yenisini başlatmadan önce list_scrapes çağırmasını söyleyin.
Coğrafyanın bir sözlüğü var. Ülke GB gibi bir ISO kodudur. Eyalet US.TX gibi noktalı bir GeoNames kodudur ve hiçbir model bunu güvenilir biçimde bilmez. Şehir, doğrulanması gereken bir isimdir. Posta kodu ve yarıçap aramaları hiç desteklenmiyor. En yakın gerçek seçenek custom_geo olarak geçilen çizilmiş bir poligon, ki onu bir ajanın üretmesi kötü fikir, panoda yapılması daha doğru.
Satırları modelin dışında tutun
MCP kullanmanın en güçlü sebebi, aramayı ajanın seçmesi. Bu, veriyi de ajanın taşıması için bir sebep değil.
Sonuçlar sayfa başına en fazla 500 satır olarak bölünür. Bunları modelden geçirmek token yakar, kestirilemez yerlerden keser ve siz tablo isterken size özet üretir. Neyin aranacağına ajan karar versin, iş kimliğini ve satır sayısını bildirsin. Sonra o iş kimliğini sıradan bir HTTP Request düğümüne alın ve satırları Google Sheets'e, bir CRM'e veya veritabanına yazın. Polling akışı rehberi bu ikinci yarıyı imleç sayfalama ve tekrar yazmaya dayanıklı kayıt dahil ayrıntısıyla anlatıyor.
Ajanın listeyi saklamak yerine üzerinde akıl yürütmesini istiyorsanız, sınırlı bir sayfaya karşı tek bir belirli soru sorun, listenin kendisini istemeyin.
Hâlâ ajanın kararı olmaması gerekenler
n8n dışında maliyeti veya sonucu olan her şey. Kime ulaşılacağı, mesajın ne diyeceği, bir telefonun yasal olarak aranıp aranamayacağı. Yasal ve gizlilik rehberi temel kuralları anlatıyor ve arama terimlerini bir modelin seçmiş olması hiçbirini yumuşatmıyor.
Akılda tutmaya değer bir şey daha: Google Maps kayıtlarında e-posta alanı yoktur. Yani ajandan e-posta istendiğinde, zenginleştirme adımının her işletmenin web sitesinde bulduğu şeyle çalışır, Maps'ten gelen bir veriyle değil. E-posta çıkarma rehberi bu tavanın nerede olduğunu anlatıyor.
Sık Sorulan Sorular
n8n'de MCP sunucusu nedir?
MCP, bir yapay zeka modelinin dış araçları çağırmasını sağlayan bir protokoldür. n8n'de AI Agent düğümüne bir MCP Client Tool düğümü bağlarsınız, sunucu adresini verirsiniz ve ajan o sunucunun yayınladığı bütün araçlara kavuşur. BasedOnB uç noktası, Google Maps işletme verisinde arama yapmak ve sonuçları okumak için on araç yayınlar.
BasedOnB'yi n8n AI Agent'a nasıl bağlarım?
Bir MCP Client Tool düğümü ekleyin, uç noktayı https://www.basedonb.com/api/mcp yapın, taşıma olarak HTTP Streamable seçin ve MCP OAuth2 ile veya mcp kapsamı taşıyan bir Bearer API anahtarıyla kimlik doğrulayın. Düğümü AI Agent'ın araç portuna bağlayın. Başka ayar gerekmez.
Yapay zeka ajanı sabit bir akıştan daha çok kredi harcar mı?
Kredi fiyatı aynıdır, çünkü iki yol da aynı API'yi çağırır. Risk farklıdır. Kredi, arama gönderildiği anda istenen lead sayısı üzerinden düşülür. Yani büyük bir sayı seçen ajan o krediyi anında harcar. Sayıyı sistem talimatında sınırlayın ve önce get_credits ile bakiyeyi kontrol ettirin.
Ajan posta koduna veya bir adresin çevresindeki yarıçapa göre arayabilir mi?
Hayır. Arama bir ülke, isteğe bağlı bir eyalet ve isteğe bağlı bir şehir alır. Alternatifi kullanıcının çizdiği bir poligondur. Posta kodu girişi ve yarıçap girişi yoktur. Ajandan beş kilometrelik yarıçap istenirse, yakındaki bir şehri ikame etmek yerine bu şeklin desteklenmediğini söylemelidir.
n8n'de MCP mi kullanmalıyım, REST API mi?
Kategori, konum ve filtreler sabitse ve akış her seferinde aynı çalışmak zorundaysa REST API kullanın. İstek düz cümle olarak geliyorsa ve işe yarayacak parametreler önceden belli değilse MCP kullanın. Çoğu ekip ikisini birden çalıştırır: araştırmayı ajan, üretim partilerini sabit akış yapar.
Ajana hangi araçları açmalıyım?
Sadece işin gerektirdiğini açın. Mevcut işleri okuyan bir araştırma ajanının durum, sonuç ve listeleme araçlarına ihtiyacı vardır, para harcayan hiçbir araca yoktur. submit_scrape aracını ancak talimatta lead sayısına kesin bir üst sınır koyduktan ve ajanı belirsiz isteklere karşı test ettikten sonra ekleyin.
Ajan sonuçların tamamını işleyebilir mi?
Denememeli. Sonuçlar sayfa başına 500 satır olarak bölünür ve büyük bir liste model bağlamını tüketir, hiçbir faydası olmadan token yakar. Neyin aranacağına ajan karar versin, satırları sıradan n8n düğümleriyle Sheets'e, bir CRM'e veya veritabanına taşıyın.
Karşılayabileceğiniz bir görevle başlayın
Ajana salt okunur araçları, bir sohbet modelini ve cevabını zaten bildiğiniz bir soruyu verin. Eyalet kodunu uydurmak yerine çözdüğünü, posta kodu isteğini sessizce bir şehir araması yapmak yerine reddettiğini kontrol edin.
Sonra talimata bir üst sınır koyup submit_scrape ekleyin ve küçük bir iş çalıştırın. Yeni bir BasedOnB hesabı, kart istemeden 50 tek seferlik dışa aktarma kredisiyle geliyor; gerçek bir partiden önce bütün döngünün nasıl davrandığını izlemeye yeter. Ajanı hiç kurmak istemiyorsanız, hazır n8n şablonu bu işin sabit sürümünü on dakikada yapıyor.