عقدة n8n MCP Server Trigger: الرابط وإعداد Claude وأمثلة عملية

تحوّل n8n MCP Server Trigger سير العمل العادي إلى خادم MCP يستطيع Claude استدعاءه. تضيف العقدة، وترفق بها بضع عقد أدوات، وتنسخ رابطًا واحدًا، فيصبح Claude قادرًا فجأة على قراءة جدول بيانات، أو النشر على Slack، أو تشغيل سير عمل فرعي، أو بدء مهمة توليد صور، دون أي كود خادم من جهتك. هناك ثلاث تفاصيل تحدد نجاح ذلك أو فشله بصمت: أي رابط تنسخ، وكيف تحميه، وكيف يتصل Claude به.

يشرح هذا المقال التفاصيل الثلاث. ستحصل على ملف إعداد يمكنك لصقه، وأربعة أمثلة لسير العمل، وجدول بأكثر الأعطال شيوعًا، وأسماء الخيارات الدقيقة التي يستخدمها n8n في المحرر، مأخوذة من وثائق العقدة.

ماذا تفعل Trigger الخادم فعلًا

معظم المشغّلات في n8n تبدأ سير العمل وتمرر البيانات إلى العقدة التالية. أما MCP Server Trigger فتعمل بطريقة مختلفة. فهي لا تمرر البيانات إلى الأسفل. بل تتصل بعقد الأدوات فقط، وتعرضها على أي عميل MCP يعرف رابطها. عندما يسأل Claude عمّا يستطيع الخادم فعله، يرد n8n بقائمة الأدوات المرفقة. وعندما يختار Claude أداة، ينفذها n8n ويعيد النتيجة.

يجعل هذا اللوحة تبدو أقرب إلى تعريف API منها إلى الأتمتة. كل أداة قدرة، واسم الأداة مع وصفها هو ما يقرؤه Claude ليقرر متى يستخدمها. تتحدث العقدة بلغة Server-Sent Events (SSE) و_streamable HTTP_. ولا تدعم stdio، ولهذا يحتاج Claude Desktop إلى جسر صغير، وسيُعرض لاحقًا.

عقدة واحدة وأدوات كثيرة

أرفق أي عدد تحتاجه من عقد الأدوات: Google Sheets Tool، أو Gmail Tool، أو HTTP Request Tool، أو Code Tool، أو Calculator، أو Custom n8n Workflow Tool التي تستدعي سير عمل آخر. الأخيرة هي الأهم عمليًا. فهي تتيح لك الاحتفاظ بالمنطق الثقيل في سير عمل عادي، وعرض نقطة دخول رفيعة ومسماة بوضوح فقط.

💡 سمِّ الأدوات بأفعال، واكتب وصف كل أداة في جملة بسيطة واحدة. "find_order: البحث عن طلب بواسطة رقمه وإرجاع الحالة وتاريخ الشحن" أفضل دائمًا من "orders_tool"، لأن Claude يختار الأدوات من هذا النص وحده.

Server Trigger مقابل Client Tool

يقدم n8n عقدتين من نوع MCP يخلط الناس بينهما، وهما تتجهان في اتجاهين متعاكسين.

إذا أردت أن يستخدم Claude n8n، فأنت تحتاج إلى Trigger. وإذا أردت أن يستخدم وكيل n8n أدوات شخص آخر، فأنت تحتاج إلى Client Tool.

العثور على رابط MCP الصحيح

افتح المشغّل وسترى رابطين في أعلى لوحة العقدة. نسخ الرابط الخطأ هو أكثر الأخطاء شيوعًا عند البداية، وهو يُنتج العَرَض الأكثر إرباكًا: كل شيء يعمل طالما المحرر مفتوح، ثم يتوقف في اللحظة التي تغلقه فيها.

رابط الاختبار مقابل رابط الإنتاج

إذا وجّهت Claude إلى رابط الاختبار، فسيعمل العرض التجريبي، ثم ينكسر بمجرد أن تغادر التبويب. أما إذا وجّهته إلى رابط الإنتاج، فسيرد سير العمل على مدار الساعة، ويُسجَّل كل استدعاء في Executions حيث يمكنك فحص المدخلات والمخرجات.

💡 انسخ الرابط مباشرةً من العقدة بدلًا من كتابته. في معظم التثبيتات يبدو عنوان الإنتاج كالتالي https://n8n.example.com/mcp/your-path، ويستبدل عنوان الاختبار /mcp/ بـ /mcp-test/. اعتبر هذا الشكل مجرد إرشاد، وثق بما تعرضه العقدة.

اختر مسارًا ثابتًا

يأتي حقل Path معبأً مسبقًا بسلسلة عشوائية حتى لا تتعارض سيرا العمل مع بعضهما. يمكنك استبدالها بشيء مقروء، مع معاملات المسار إن لزم، حتى يبقى إعداد Claude سليمًا عند إعادة بناء سير العمل. استخدم مسارًا منفصلًا لكل مساعد: orders-assistant، support-lookup، image-studio.

قاعدة أخرى يتعثر فيها كثيرون: سير العمل غير النشط لا يخدم طلبات MCP. إذا اتصل Claude ولم يرَ أي أدوات، فتحقق أولًا من أن سير العمل منشور.

أحكم الحماية باستخدام Bearer auth

يقدم المشغّل ثلاثة خيارات في حقل Authentication: None وBearer auth وHeader auth. خيار None مقبول لتجربة مؤقتة على حاسوبك المحمول. أما أي شيء يمكن الوصول إليه من خارج شبكة موثوقة فيحتاج إلى أحد الخيارين الآخرين، لأن رابط MCP عام بلا مصادقة هو زر عام يشغّل سير عملك.

Bearer أم Header auth

مع Bearer auth يرسل العميل ترويسة Authorization: Bearer <token>. ومع Header auth تختار أنت اسم الترويسة وقيمتها بنفسك، مثل X-MCP-Token. اختر Bearer ما لم تكن هناك بوابة أمامية لـ n8n تتوقع ترويسة مخصصة.

1. افتح المشغّل واضبط Authentication على Bearer auth.
2. أنشئ بيانات اعتماد والصق رمزًا عشوائيًا طويلًا. ينتج openssl rand -hex 32 رمزًا جيدًا.
3. احفظ الرمز في مدير كلمات مرور، فستحتاجه مرة أخرى لإعداد Claude.
4. احفظ سير العمل وانشره من جديد حتى يدخل التغيير حيز التنفيذ.

أبقِ قائمة الأدوات قصيرة

كل أداة مرفقة هي شيء يمكن لأمر نصي أن يشغّله. النموذج الذي يستطيع قراءة الصفوف وحذفها أيضًا سيحذف صفًا في النهاية عندما يكون الطلب غامضًا. امنح كل مساعد مجموعة ضيقة من الأدوات، وللقراءة فقط كلما أمكن، وثبّت المعاملات الخطرة مثل قناة Slack أو معرّف جدول البيانات بدلًا من ترك Claude يختارها.

للنموذج على الطرف الآخر أهمية أيضًا. نماذج استدعاء الأدوات القوية مثل Claude Sonnet 5 وClaude Fable 5 شريكان جيدان للاختبار على PicassoIA: الصق أوصاف أدواتك في محادثة، وأرسل عشرة طلبات نموذجية، وتحقق من الأداة التي كان النموذج سيختارها لكل طلب. أعد كتابة أي وصف يؤدي إلى اختيار خاطئ قبل أن تلمس سير العمل.

ربط Claude بخادمك

يصل Claude إلى خادم MCP عبر ثلاثة مداخل مختلفة، وكل منها يحتاج إلى الرابط الإنتاجي نفسه ولكن بغلاف مختلف قليلًا.

Claude Desktop باستخدام mcp-remote

يشغّل Claude Desktop خوادم stdio المحلية، ولا تتحدث Trigger بلغة stdio. تقع حزمة mcp-remote في المنتصف وتقوم بالترجمة. افتح ملف الإعداد (على Windows في %APPDATA%\Claude\claude_desktop_config.json، وعلى macOS في ~/Library/Application Support/Claude/claude_desktop_config.json) وأضف هذا الإدخال:

{
  "mcpServers": {
    "n8n": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://n8n.example.com/mcp/orders-assistant",
        "--header",
        "Authorization: Bearer ${AUTH_TOKEN}"
      ],
      "env": {
        "AUTH_TOKEN": "paste-your-bearer-token-here"
      }
    }
  }
}

نسخ الأمر النصي

يُحفظ الرمز في env ويشير وسيط الترويسة إليه، فيبقى الوسيط سلسلة نصية واحدة نظيفة. تحتاج إلى تثبيت Node.js لأن npx يجلب الجسر عند أول تشغيل. أغلق Claude Desktop بالكامل ثم أعد فتحه، وستظهر الأدوات في قائمة الأدوات داخل محادثة جديدة.

Claude Code من الطرفية

يستطيع Claude Code التحدث مع الخوادم البعيدة مباشرة، ولا حاجة إلى جسر هنا:

claude mcp add --transport http n8n https://n8n.example.com/mcp/orders-assistant \
  --header "Authorization: Bearer YOUR_TOKEN"

نسخ الأمر النصي

استخدم --transport http لـ streamable HTTP. وإذا كانت نسختك من n8n لا تعرض سوى نقطة SSE القديمة، فبدّل العلامة إلى --transport sse. شغّل claude mcp list للتأكد من أن الخادم يظهر متصلًا، ثم اطلب من Claude Code أن "يعرض أدوات n8n" كفحص أولي.

موصلات claude.ai المخصصة

في claude.ai، افتح إعدادات الموصلات وأضف موصلًا مخصصًا بالرابط الإنتاجي. تأتي الطلبات من جهة Anthropic وليس من حاسوبك المحمول، لذا يجب أن يكون العنوان متاحًا من الإنترنت عبر HTTPS. عنوان localhost أو عنوان IP خاص لن يعمل. ضع n8n خلف reverse proxy أو نفق أولًا.

💡 يوثّق n8n ملاحظة غريبة: يطلب claude.ai تسجيل الدخول حتى عندما تكون المصادقة معطلة في المشغّل، لأنه يفترض أن كل نقطة MCP تستخدم مصادقة المستخدم. ظهور طلب تسجيل الدخول لا يعني أن المشغّل مُعدّ بشكل خاطئ.

أربعة أمثلة تستحق البناء

كل مثال أدناه هو عقدة أداة واحدة مرفقة بالمشغّل نفسه. ابدأ بالأول، وتأكد من أن Claude يستطيع استدعاءه، ثم أضف البقية واحدًا تلو الآخر.

البحث عن الصفوف في Sheets

أرفق Google Sheets Tool، واضبط العملية على الحصول على الصفوف، وصفِّ عمود رقم الطلب بتعبير يتيح أن يملأ Claude القيمة:

{{ $fromAI('order_number', 'The order number the customer gave', 'string') }}

نسخ الأمر النصي

الآن يتحول سؤال "أين الطلب 48213؟" إلى بحث فعلي. وصف الأداة: البحث عن طلب واحد بواسطة رقمه وإرجاع الحالة وتاريخ الشحن. وهي للقراءة فقط، لذلك فهي أكثر أداة أمانًا لتكون الأولى التي تعرضها.

نشر ملخص على Slack

أضف Slack Tool مع عملية إرسال الرسالة. ثبّت القناة واترك Claude يملأ النص فقط:

{{ $fromAI('summary', 'A two sentence summary to post', 'string') }}

نسخ الأمر النصي

بما أن القناة ثابتة في العقدة، فلن يستطيع أمر نصي مرتبك النشر في مكان آخر. هذا القرار الواحد يزيل معظم مخاطر منح مساعد صلاحية الكتابة.

استدعاء سير عمل فرعي

تشغّل Custom n8n Workflow Tool سير عمل آخر يبدأ بـ Execute Workflow Trigger. وهنا تنتمي المهام متعددة الخطوات: إثراء بيانات عميل محتمل، والتحقق من CRM، وكتابة صفحة في Notion، وإرجاع نتيجة قصيرة. يرى Claude أداة واحدة بوصف واحد، وتبقى كل التفرعات داخل سير عمل يمكنك اختباره وحده.

توليد الصور عبر API

تتيح HTTP Request Tool أن يبدأ Claude مهام توليد الصور من محادثة. تعتمد PicassoIA API على نمط Replicate: تنشئ تنبؤًا، ثم تستعلم عنه بشكل دوري حتى تصبح النتيجة جاهزة. عنوان الأساس هو https://api.picassoia.com/v1، وتستخدم الاستدعاءات رمز Bearer يبدأ بـ pia_sk_، وينشأ من صفحة PicassoIA API.

1. أضف HTTP Request Tool باسم create_image مع الوصف إنشاء صورة واقعية كالصور الفوتوغرافية بنسبة عرض إلى ارتفاع 16:9 من أمر نصي، وإرجاع معرّف التنبؤ.
2. اضبط الطريقة على POST واجعل العنوان https://api.picassoia.com/v1/models/picassoia/picassoia-image/predictions.
3. اضبط المصادقة على Bearer والصق رمز pia_sk_ الخاص بك.
4. أرسل جسم JSON يحتوي على كائن input يأتي حقله prompt من $fromAI.
5. أضف HTTP Request Tool ثانية باسم get_image ترسل طلب GET إلى https://api.picassoia.com/v1/predictions/ متبوعًا بمعرّف التنبؤ الذي يمرره Claude.

ينشئ Claude المهمة، وينتظر بضع ثوانٍ، ويستعلم عن get_image، ويعرض لك الرابط النهائي. النموذج الذي يقف خلف الاستدعاء الأول هو PicassoIA Image، ويتولى PicassoIA Image Editor Pro التعديلات بالنمط نفسه. تسمح الحسابات بما يصل إلى 5 تنبؤات في وقت واحد، ويمكن أن تصل الأوامر النصية إلى 4,000 حرف، لذلك اكتب وصف الأداة بحيث يطلب Claude إرسال طلب واحد في كل مرة. تحقق من صفحة API لمعرفة حقول الاستجابة ومتطلبات الخطة قبل أن تعتمد على هذا في بيئة الإنتاج.

إصلاح الأعطال الشائعة

تنتج معظم مشكلات MCP Server Trigger عن واحد من عدد محدود من الأسباب. قبل أن تغيّر أي شيء، افتح تبويب Executions. الاستدعاء الذي لا يظهر هناك لم يصل إلى n8n أصلًا، وهذا يشير إلى الرابط أو الوكيل الوسيط أو إعداد Claude. أما الاستدعاء الذي يظهر مع خطأ فيشير إلى عقدة الأداة نفسها.

انقطاع الاتصال خلف nginx

SSE وstreamable HTTP اتصالات طويلة الأمد. الوكيل العكسي الذي يخزّن الاستجابات مؤقتًا يحتفظ بالتدفق حتى يمتلئ، فيرى Claude توقفًا. يوصي n8n بإيقاف التخزين المؤقت للوكيل، وضغط gzip، وترميز النقل المقسّم (chunked transfer encoding) على مسار MCP، ومسح ترويسة Connection:

location /mcp/ {
    proxy_pass http://n8n:5678;
    proxy_http_version 1.1;
    proxy_set_header Connection '';
    proxy_buffering off;
    gzip off;
    chunked_transfer_encoding off;
}

نسخ الأمر النصي

توجيه وضع الطابور

في وضع الطابور مع عدة نسخ من Webhook، يجب أن يبقى كل اتصال دائم على النسخة التي فتحته. يوثّق n8n توجيه كل طلبات /mcp* إلى نسخة Webhook واحدة مخصصة. أضف قاعدة في موازن الحمل لهذا المسار، وستتوقف الأعطال العشوائية.

جرّبه مع صورك الخاصة

لديك الآن الحلقة كاملة: عقدة مشغّل، ورابط إنتاج، ومصادقة Bearer، وإعداد Claude يشير إليه، وأدوات تنفذ عملًا حقيقيًا. سير عمل الصور هو الأكثر متعة للتجربة أولًا، لأن النتيجة تظهر في محادثتك مباشرة ويمكنك الحكم عليها في ثوانٍ.

افتح Picasso IA وجرّب بعض الأوامر النصية بنفسك قبل أن تربط API. قارن بين GPT Image 2 وSeedream 4.5 وNano Banana 2 Lite باستخدام الأمر النصي نفسه، ثم احتفظ بالأسلوب الذي يناسب مشروعك. وبمجرد أن تعرف أي صيغ للأوامر النصية تنجح، ضعها في وصف الأداة كي يكتب Claude أوامر أفضل بمفرده.

ابنِ الأداة الأولى اليوم: مشغّل واحد، وأداة واحدة للقراءة فقط، واتصال واحد مع Claude. أضف أداة ثانية فقط بعد أن تعمل الأولى بشكل سليم، وسيكبر مساعدك دون أن يفاجئك أبدًا.