خادم MCP في n8n: توليد العملاء المحتملين بوكيل ذكاء اصطناعي
صار بإمكان وكيل AI Agent في n8n أن يشغّل بحثًا عن عملاء محتملين في خرائط جوجل بنفسه. تصف المهمة بلغة عادية، فيختار الوكيل الفئة والدولة والمدينة وحجم البحث، ثم يقرأ الصفوف الجاهزة. الربط عقدة واحدة وبيانات اعتماد واحدة.
هذا شكل مختلف من الأتمتة عمّا في دليل سير العمل بالاستطلاع الدوري، حيث يُثبَّت كل معامل قبل التشغيل. هنا المعاملات قرار الوكيل. وهذا مفيد فعلًا للبحث المفتوح، وخطر فعلًا في كل ما ينفق المال. معظم هذه المقالة عن النصف الثاني من هذه الجملة.
سير عمل ثابت أم وكيل؟
المساران يستدعيان نفس الواجهة البرمجية ويكلفان نفس الرصيد. الفارق في من يختار المعاملات.
| سير عمل ثابت (HTTP Request) | وكيل ذكاء اصطناعي (MCP) | |
|---|---|---|
| من يختار الفئة والمدينة | أنت، وقت البناء | النموذج، وقت التشغيل |
| قابلية التكرار | متطابق في كل تشغيل | يتغير حسب الطلب |
| مناسب لـ | دفعات مجدولة، مجال واحد لكل حملة | البحث، الأسئلة المفردة، طلبات المحادثة |
| كيف يفشل | نتيجة خاطئة يسهل تتبعها | نتيجة معقولة من بحث خاطئ |
| المراجعة المطلوبة | مرة واحدة | بعد كل تعديل على التعليمات |
قاعدة أثبتت نفسها عمليًا: إن كان بإمكانك كتابة البحث قبل التشغيل، فاكتبه. اذهب إلى الوكيل حين يصل الطلب على هيئة جملة لا على هيئة نموذج.
ماذا تمنح نقطة النهاية للوكيل
خادم MCP عنوان واحد، و n8n يتولى المصافحة.
| الإعداد | القيمة |
|---|---|
| نقطة النهاية | https://www.basedonb.com/api/mcp |
| العقدة | MCP Client Tool، الإصدار 1.2 أو أحدث |
| النقل | HTTP Streamable |
| المصادقة | MCP OAuth2 مع Dynamic Client Registration، أو Bearer بمفتاح API يحمل نطاق mcp |
بعد الربط يستطيع الوكيل استدعاء عشر أدوات:
| الأداة | فيمَ يستخدمها الوكيل |
|---|---|
submit_scrape | يبدأ بحثًا. الأداة الوحيدة التي تنفق رصيدًا. |
get_scrape_status | يتحقق مما إذا كانت المهمة ما زالت تعمل |
get_scrape_results | يقرأ الصفوف الجاهزة على صفحات |
list_scrapes | ينظر في المهام الأخيرة قبل بدء مهمة جديدة |
cancel_scrape | يوقف مهمة بدأت بالخطأ |
get_account | يقرأ الخطة وحالة الحساب |
get_credits | يفحص الرصيد قبل إنفاقه |
list_countries | يحوّل اسم دولة إلى رمزها ISO |
list_states | يجد رمز GeoNames المنقوط، مثل US.TX |
list_cities | يؤكد كتابة مدينة ربما خمّنها النموذج |
الثلاث الأخيرة أهم مما تبدو. النموذج الذي يُطلب منه أطباء أسنان في تكساس سيخترع رمز الولاية بلا تردد. أدوات القوائم تتيح له التحقق بدل التخمين، واستدعاؤها لا يكلف شيئًا.
الربط
1. أنشئ بيانات الاعتماد مرة واحدة. في n8n أضف بيانات اعتماد MCP لنقطة النهاية أعلاه. مع MCP OAuth2 تترك Dynamic Client Registration مفعّلًا، ويحفظ n8n رمز التحديث المتجدد، فتُعدّ البيانات مرة ثم تُترك وشأنها. ومع Bearer تلصق مفتاح API من لوحة التحكم تحت قسم API والويب هوك. امنحه نطاق mcp فقط.
2. أضف عقدة MCP Client Tool واختر بيانات الاعتماد تلك. اترك النقل على HTTP Streamable.
3. اربط العقدة بمنفذ الأدوات في AI Agent، إلى جانب نموذج المحادثة الذي تستخدمه. الوكيل يكتشف قائمة الأدوات بنفسه.
4. قيّد قائمة الأدوات. تسمح العقدة بإتاحة جزء منها. ابدأ بأدوات القراءة فقط، وجرّب بضعة طلبات، ولا تضف submit_scrape إلا بعد ذلك. الوكيل الذي لا يستطيع إنفاق الرصيد شيء آمن للتجريب عليه.
الحدود مكانها تعليمات النظام
الأدوات تصف ما هو ممكن. لا شيء فيها يصف ما هو معقول لحسابك أنت، وهذه مهمة التعليمات. نقطة بداية عملية:
تجد عملاء محتملين من الأنشطة المحلية عبر أدوات BasedOnBusiness.
قبل أي بحث:
- استدعِ get_credits. إذا كان الرصيد أقل من عدد العملاء
المطلوب، توقف وأبلغ بالرصيد بدل البحث.
- أكّد كل اسم مكان عبر list_countries أو list_states أو
list_cities. لا تخترع أبدًا رمز دولة أو ولاية.
أثناء البحث:
- لا تطلب أكثر من 50 عميلًا في المهمة الواحدة إلا إذا ذكر
المستخدم رقمًا أكبر صراحةً.
- اسأل عن فئة واحدة في كل مرة.
- يُخصم الرصيد عند بدء المهمة لا عند عودة النتائج. الإلغاء
لا يعيد الرصيد.
غير مدعوم إطلاقًا:
- البحث بالرمز البريدي والبحث بنطاق حول عنوان غير موجودين.
قل ذلك. ولا تستبدلهما بمدينة قريبة.
بعد انتهاء المهمة، أبلغ بعدد الصفوف وتوقف. لا تلصق قائمة
النتائج كاملة.
كل سطر هناك موجود بسبب طريقة محددة يفشل بها الأمر. السطر المكلف هو سطر الرصيد.
ثلاثة حدود لا يكتشفها الوكيل وحده
يُخصم الرصيد عند الإرسال وبناءً على العدد المطلوب. طلب 500 عميل يكلف 500 رصيد لحظة بدء المهمة، سواء عاد 500 صف أو اثنا عشر صفًا. المرشح الذي يُطبَّق لاحقًا لا يخفض التكلفة، والإلغاء كذلك. هذه أهم جملة تضعها في التعليمات، لأن النموذج بلا إشارة تكلفة يقرّب الأرقام إلى أعلى ليبدو شاملًا.
للمهام سقوف صارمة. المهمة الواحدة تحمل 10 مصطلحات بحث كحد أقصى. والحساب يحتمل مهمتين مفتوحتين في وقت واحد، ومجموع أهداف المهام المفتوحة لا يتجاوز 5000 عميل. الوكيل الذي يطلق مهمة لكل مدينة في قائمة من عشرين سيجمع استجابات 429 بدل العملاء. اطلب منه معالجة المواقع واحدًا تلو الآخر وفحص list_scrapes قبل بدء مهمة جديدة.
للجغرافيا مفردات. الدولة رمز ISO مثل GB. والولاية رمز GeoNames منقوط مثل US.TX، ولا يعرفه أي نموذج بثقة. والمدينة اسم يحتاج تأكيدًا. أما الرموز البريدية والبحث بنصف قطر فغير مدعومة أصلًا. أقرب خيار حقيقي هو مضلع مرسوم يُمرَّر في custom_geo، وهو شيء يصعب على الوكيل توليده والأفضل التعامل معه من لوحة التحكم.
أبقِ الصفوف خارج النموذج
أقوى سبب لاستخدام MCP هو أن الوكيل يختار البحث. وهذا ليس سببًا لتحميله البيانات أيضًا.
تأتي النتائج في صفحات تصل إلى 500 صف. تمريرها عبر النموذج يحرق الرموز، ويقطع في مواضع لا يمكن توقعها، وينتج ملخصًا في موضع أردت فيه جدولًا. دع الوكيل يقرر ما يبحث عنه ويبلّغ بمعرّف المهمة وعدد الصفوف، ثم خذ ذلك المعرّف إلى عقدة HTTP Request عادية واكتب الصفوف في Google Sheets أو نظام إدارة علاقات العملاء أو قاعدة بيانات. دليل سير العمل بالاستطلاع الدوري يغطي هذا النصف بالتفصيل، بما في ذلك ترقيم الصفحات بالمؤشر والكتابة الآمنة ضد التكرار.
وإن أردت أن يفكر الوكيل في القائمة بدل تخزينها، فاسأله سؤالًا محددًا عن صفحة محدودة، لا القائمة نفسها.
ما ينبغي أن يبقى خارج قرار الوكيل
كل ما له تكلفة أو أثر خارج n8n. من يُتواصل معه، وماذا تقول الرسالة، وهل يجوز قانونًا الاتصال برقم ما. دليل الجوانب القانونية والخصوصية يضع القواعد الأساسية، ولا تلين أي منها لأن نموذجًا هو من اختار مصطلحات البحث.
وثمة أمر آخر يستحق التذكر: بطاقات خرائط جوجل لا تحتوي حقل بريد إلكتروني. فالوكيل الذي يُطلب منه بريد إلكتروني يعمل على ما وجدته خطوة الإثراء في موقع كل نشاط تجاري، لا على بيانات من الخرائط. دليل استخراج البريد الإلكتروني يوضح أين يقع هذا السقف.
الأسئلة الشائعة
ما هو خادم MCP في n8n؟
MCP بروتوكول يتيح لنموذج ذكاء اصطناعي استدعاء أدوات خارجية. في n8n تربط عقدة MCP Client Tool بوكيل AI Agent وتعطيها عنوان الخادم، فيحصل الوكيل على كل أداة ينشرها ذلك الخادم. نقطة نهاية BasedOnB تنشر عشر أدوات للبحث في بيانات الأنشطة التجارية على خرائط جوجل وقراءة النتائج.
كيف أربط BasedOnB بوكيل AI Agent في n8n؟
أضف عقدة MCP Client Tool، واضبط نقطة النهاية على https://www.basedonb.com/api/mcp، واختر نقل HTTP Streamable، ثم صادق باستخدام MCP OAuth2 أو بمفتاح API من نوع Bearer يحمل نطاق mcp. اربط العقدة بمنفذ الأدوات في AI Agent. لا يلزم أي إعداد آخر.
هل يستهلك وكيل الذكاء الاصطناعي رصيدًا أكثر من سير عمل ثابت؟
السعر واحد، لأن المسارين يستدعيان نفس الواجهة البرمجية. الفارق في المخاطرة. يُخصم الرصيد لحظة إرسال البحث وبناءً على عدد العملاء المطلوب، فالوكيل الذي يختار رقمًا كبيرًا ينفقه فورًا. ضع سقفًا للرقم في تعليمات النظام واجعله يفحص الرصيد أولًا عبر get_credits.
هل يستطيع الوكيل البحث بالرمز البريدي أو بنطاق حول عنوان؟
لا. يقبل البحث دولة، ثم ولاية اختيارية ومدينة اختيارية، أو مضلعًا مرسومًا. لا يوجد إدخال للرمز البريدي ولا إدخال لنصف قطر. إذا طُلب من الوكيل نطاق خمسة كيلومترات فعليه أن يوضح أن هذا الشكل غير مدعوم بدلًا من استبداله بمدينة.
هل أستخدم MCP أم الواجهة البرمجية REST في n8n؟
استخدم REST حين تكون الفئة والموقع والمرشحات ثابتة ويجب أن يعمل سير العمل بالطريقة نفسها كل مرة. استخدم MCP حين يصل الطلب بلغة عادية ولا تكون المعاملات المفيدة معروفة مسبقًا. كثير من الفرق تشغّل الاثنين معًا: الوكيل للبحث الاستكشافي وسير عمل ثابت للدفعات الإنتاجية.
ما الأدوات التي ينبغي أن أتيحها للوكيل؟
ما تحتاجه المهمة فقط. وكيل بحث يقرأ مهام قائمة يحتاج أدوات الحالة والنتائج والقوائم، ولا يحتاج أي أداة تنفق المال. أضف submit_scrape فقط بعد أن تضع في التعليمات سقفًا صارمًا لعدد العملاء وبعد اختبار الوكيل أمام طلبات غامضة.
هل يستطيع الوكيل التعامل مع النتائج كاملة؟
لا ينبغي أن يحاول. تأتي النتائج في صفحات من 500 صف، والقائمة الكبيرة تستنزف سياق النموذج وتكلّف رموزًا بلا فائدة. دع الوكيل يقرر ما الذي يبحث عنه، ثم انقل الصفوف إلى Sheets أو إلى نظام إدارة علاقات العملاء أو إلى قاعدة بيانات باستخدام عقد n8n العادية.
ابدأ بمهمة تقدر على تكلفتها
امنح الوكيل أدوات القراءة فقط، ونموذج محادثة، وسؤالًا تعرف إجابته سلفًا. تحقق من أنه يستخرج رمز الولاية بدل اختراعه، ومن أنه يرفض طلب الرمز البريدي بدل البحث في مدينة بصمت.
ثم أضف submit_scrape مع سقف في التعليمات وشغّل مهمة صغيرة. الحساب الجديد في BasedOnB يأتي بـ 50 رصيد تصدير لمرة واحدة وبلا بطاقة، وهو ما يكفي لمراقبة الدورة كاملة قبل أي دفعة حقيقية. وإن كنت تفضل ألا تبني الوكيل أصلًا، فإن قالب n8n الجاهز ينجز النسخة الثابتة من هذا العمل في عشر دقائق تقريبًا.