بناء مسار عمل n8n باستخدام n8n-MCP و Claude Code

هل تمنيت يومًا أن تتمكن من **إخبار الذكاء الاصطناعي ببناء سير عمل أتمتة**، وأن تجده جاهزًا في n8n؟ ماذا لو كان مساعد الذكاء الاصطناعي الخاص بك يمكنه **مباشرة إنشاء وتحديث وتنفيذ سير عمل n8n** دون نسخ JSON يدويًا أو سحب العقد؟ مرحبًا بكم في **n8n-MCP مع Claude Code**، وهو نظام يحول اللغة الطبيعية إلى أتمتة سير عمل حقيقية وقابلة للنشر.

ما هو n8n-MCP ولماذا يجب أن تهتم به؟

n8n-MCP هو خادم بروتوكول سياق النموذج (Model Context Protocol) الذي يكشف سير عمل n8n الخاص بك كأدوات قابلة للتنفيذ لمساعدي الذكاء الاصطناعي مثل Claude Code. فبدلاً من تشغيل سير العمل يدويًا عبر واجهة المستخدم n8n أو واجهة برمجة تطبيقات REST، فإنك تصف ما تريده باللغة الطبيعية، ويستدعي Claude Code سير العمل الصحيح، ويمرر المعلمات، ويعيد النتائج.

التحول دقيق ولكنه ضخم. مساعدو ترميز الذكاء الاصطناعي التقليديون يولدون التعليمات البرمجية. مع n8n-MCP، فإنهم **ينفذون سير العمل**. يصبح سير عمل بحثك على الويب أداة. يصبح خط أنابيب إثراء البيانات الخاص بك أداة. يصبح تدفق إشعارات Slack الخاص بك أداة. يصبح Claude Code وكيلًا ينسق الأنظمة الحقيقية، وليس مجرد مولد للتعليمات البرمجية.

بالنسبة للمطورين الذين يبنون أدوات داخلية أو يقومون بأتمتة البحث، فهذا يعني أنه يمكنك:

الاستعلام عن واجهات برمجة التطبيقات المباشرة دون كتابة استدعاءات الجلب (fetch calls)
تشغيل خطوط أنابيب البيانات من محرر النصوص الخاص بك
التحقق من صحة البيانات الخارجية قبل الالتزام بالتعليمات البرمجية
بناء وكلاء مخصصين لمكدسك التقني

البروتوكول بسيط: يقوم n8n-MCP بترجمة استدعاءات أدوات Claude Code إلى طلبات HTTP إلى عقدة الويب هوك (webhook) الخاصة بك في n8n، ثم يقوم بترتيب الاستجابات مرة أخرى إلى Claude. تحصل على القوة الكاملة لأكثر من 400 تكامل في n8n داخل سير عمل سطر الأوامر (CLI) الخاص بك.

💡

هل تريد أداة رائعة لاختبار واجهة برمجة التطبيقات (API Testing) تُنشئ وثائق API جميلة؟

هل تريد منصة متكاملة وشاملة لفريق المطورين لديك للعمل معًا بأقصى قدر من الإنتاجية؟

يوفر Apidog جميع متطلباتك، ويحل محل Postman بسعر معقول جدًا!

button

الخطوة 1: تثبيت n8n وإنشاء سير عمل للبحث على الويب

أولاً، تحتاج إلى تشغيل n8n. للتطوير المحلي، يعد Docker الأسرع.

# أنشئ دليلًا لبيانات n8n
mkdir ~/n8n-data && cd ~/n8n-data

# ابدأ n8n باستخدام Docker
docker run -d --name n8n \
  -p 5678:5678 \
  -v $(pwd):/home/node/.n8n \
  --restart unless-stopped \
  docker.n8n.io/n8nio/n8n

افتح http://localhost:5678 وأكمل الإعداد. أنشئ حساب مسؤول.

using n8n self hosted with docker desktop

إنشاء سير عمل البحث على الويب

انقر على **سير عمل جديد (New Workflow)**
أضف عقدة **ويب هوك (Webhook)** (مشغل)

طريقة HTTP: POST
المسار: web-search
وضع الاستجابة: عند انتهاء آخر عقدة

3. أضف عقدة **طلب HTTP (HTTP Request)**

عنوان URL: https://duckduckgo.com/html/?q={{ $json.query }}
الطريقة: GET

4. أضف عقدة **استخراج HTML (HTML Extract)**

خاصية البيانات: data
قيم الاستخراج:
المفتاح: results
محدد CSS: .result__a
قيمة الإرجاع: نص

5. أضف عقدة **ضبط (Set)** لتنسيق المخرجات

القيم المراد ضبطها:
نتائج: {{ $json.results }}

6. اربط ويب هوك ← HTTP ← استخراج HTML ← ضبط

7. قم بتفعيل سير العمل (التبديل في الزاوية العلوية اليمنى)

اختبره يدويًا:

curl -X POST http://localhost:5678/webhook/web-search \
  -H "Content-Type: application/json" \
  -d '{"query":"مواضيع الذكاء الاصطناعي الشائعة 2026"}'

يجب أن ترى مصفوفة JSON لنتائج البحث. هذا السير العمل جاهز الآن للتعرض لـ MCP.

الخطوة 2: تثبيت وتكوين n8n-MCP

يربط خادم n8n MCP بين n8n و Claude Code. قم بتثبيته عالميًا أو في دليل مشروع.

# استنسخ مستودع n8n-MCP
git clone https://github.com/czlonkowski/n8n-mcp.git
cd n8n-mcp

# قم بتثبيت التبعيات
npm install

# قم ببناء المشروع
npm run build

تكوين متغيرات البيئة

أنشئ ملف .env في دليل n8n-MCP:

# .env
N8N_API_URL=http://localhost:5678
N8N_API_KEY=مفتاح_API_n8n_هنا

احصل على مفتاح API الخاص بـ n8n من **الإعدادات ← API** في واجهة مستخدم n8n. إذا لم ترَ قسم مفتاح API، فقد تحتاج إلى تمكينه عبر متغير البيئة عند بدء n8n:

# أوقف وأعد تشغيل n8n مع تمكين API
docker stop n8n
docker rm n8n

docker run -d --name n8n \
  -p 5678:5678 \
  -v $(pwd):/home/node/.n8n \
  -e N8N_BASIC_AUTH_ACTIVE=true \
  -e N8N_BASIC_AUTH_USER=admin \
  -e N8N_BASIC_AUTH_PASSWORD=كلمة_مرورك \
  --restart unless-stopped \
  docker.n8n.io/n8nio/n8n

الآن قم بإنشاء مفتاح API في واجهة المستخدم.

تشغيل خادم MCP

# ابدأ خادم MCP
npm start

بشكل افتراضي، يعمل على http://localhost:3001. يجب أن ترى:

خادم n8n MCP يعمل على http://localhost:3001
الأدوات المتاحة: [ 'web-search' ]

يكتشف الخادم تلقائيًا سير العمل الذي يحتوي على مسارات ويب هوك ويكشفها كأدوات.

الخطوة 3: تكوين Claude Code لاستخدام n8n-MCP

يستخدم Claude Code ملف تكوين لاكتشاف أدوات MCP. أنشئ أو عدّل تكوين Claude Code الخاص بك.

# ابحث عن دليل تكوين Claude Code
# macOS: ~/Library/Application Support/Claude Code
# Linux: ~/.config/Claude Code
# Windows: %APPDATA%/Claude Code

cd ~/Library/Application\ Support/Claude Code

أنشئ ملفًا باسم mcp.json:

{
  "mcpServers": {
    "n8n": {
      "command": "node",
      "args": ["/المسار/إلى/n8n-mcp/dist/index.js"],
      "env": {
        "N8N_API_URL": "http://localhost:5678",
        "N8N_API_KEY": "مفتاح_API_n8n_الخاص_بك"
      }
    }
  }
}

**هام**: استخدم مسارات مطلقة لـ args. تفشل المسارات النسبية عندما يشغل Claude Code العملية.

التحقق من الاتصال

ابدأ Claude Code في مشروعك:

claude

بمجرد التحميل، اكتب:

/list-tools

يجب أن ترى:

الأدوات المتاحة:
- n8n:web-search (ينفذ سير عمل البحث على الويب)

إذا لم تظهر الأداة، فتحقق من السجلات:

# في محطة طرفية أخرى، تابع سجلات Claude Code
tail -f ~/Library/Application\ Support/Claude\ Code/logs/mcp.log

المشكلات الشائعة:

**ENOENT**: مسار خاطئ لـ n8n-mcp/dist/index.js
**ECONNREFUSED**: n8n لا يعمل على localhost:5678
**401**: مفتاح N8N_API_KEY غير صحيح

الخطوة 4: تطبيق عملي - البحث على الويب من Claude Code

الآن يحدث السحر. في أي دليل مشروع، ابدأ Claude Code وقم بالتشغيل:

claude

في الموجه، اكتب:

باستخدام أداة البحث على الويب في n8n، ابحث عن مواضيع الذكاء الاصطناعي الشائعة في عام 2026

سيقوم Claude Code بما يلي:

التعرف على أداة n8n:web-search
تحليل نيتك ("مواضيع الذكاء الاصطناعي الشائعة في عام 2026")
استخراج معامل الاستعلام (query parameter)
استدعاء خادم MCP
يستدعي خادم MCP ويب هوك n8n
يقوم n8n بتشغيل سير العمل وإرجاع النتائج
يعيد MCP JSON إلى Claude Code
يقوم Claude Code بتنسيق وعرض الإجابة

مثال على جلسة

$ claude
> باستخدام أداة البحث على الويب في n8n، ابحث عن مواضيع الذكاء الاصطناعي الشائعة في عام 2026

سأساعدك في البحث عن مواضيع الذكاء الاصطناعي الشائعة في عام 2026 باستخدام أداة البحث على الويب n8n.

جاري استدعاء n8n:web-search بالاستعلام: "مواضيع الذكاء الاصطناعي الشائعة 2026"

أعادت الأداة 8 نتائج:
1. "اختراقات الذكاء الاصطناعي الكمي في عام 2026: ما يحتاج المطورون إلى معرفته"
2. "نماذج LLM متعددة الوسائط: ما وراء النصوص والصور"
3. "نشر الذكاء الاصطناعي على الحافة: خفض تكاليف السحابة بنسبة 40%"
4. "وكلاء مراجعة أكواد الذكاء الاصطناعي: ارتفاع في التبني في المؤسسات"
5. "التعلم الموحد: تدريب الذكاء الاصطناعي مع مراعاة الخصوصية أولاً"
6. "توليد البيانات الاصطناعية: جدل الجودة مقابل الكمية"
7. "اكتشاف هلوسات الذكاء الاصطناعي: أدوات جديدة مفتوحة المصدر"
8. "الحوسبة العصبية: اتجاهات التصميم المشترك للأجهزة والبرمجيات"

بناءً على هذه النتائج، إليك أهم مواضيع الذكاء الاصطناعي الشائعة في عام 2026:
- يصبح تكامل الذكاء الاصطناعي الكمي عمليًا للمطورين
- نماذج متعددة الوسائط تمتد إلى ما وراء النصوص/الصور إلى الصوت/الفيديو
- نشر الذكاء الاصطناعي على الحافة لخفض التكاليف
- وكلاء الذكاء الاصطناعي لمراجعة التعليمات البرمجية يكتسبون زخمًا في المؤسسات
- التعلم الموحد الذي يحافظ على الخصوصية
- خطوط أنابيب البيانات الاصطناعية
- أدوات الكشف عن الهلوسة
- تقدم في أجهزة الحوسبة العصبية

في هذه الأثناء، في واجهة مستخدم n8n الخاصة بك، سترى تنفيذ سير العمل يظهر في الوقت الفعلي، مما يثبت أن Claude Code قام بتشغيله عن بعد.

أنماط متقدمة: بناء سير عمل ذكية (Agentic Workflows)

النمط 1: إثراء البيانات من مصادر متعددة

أنشئ سير عمل يجلب مستخدم GitHub، ثم يبحث عن تغريداته الأخيرة:

عقدة ويب هوك (enrich-user)
طلب HTTP ← GitHub API (/users/{{ $json.username }})
طلب HTTP ← X API (/users/by/username/{{ $json.username }})
عقدة دمج (لدمج الاستجابات)
عقدة ضبط (لتنسيق الكائن النهائي)

الآن في Claude Code:

أثرِ ملف تعريف المستخدم لـ @johndoe باستخدام سير عمل enrich-user

يمرر Claude المعلمات تلقائيًا ويستقبل البيانات المنظمة.

النمط 2: اختيار الأداة الشرطي

أنشئ العديد من سير العمل ودع Claude يختار:

web-search-duckduckgo: مجاني ولكنه أبطأ
web-search-serpapi: مدفوع ولكنه منظم
web-search-google: كاشط مخصص (Custom scraper)

في موجهك:

ابحث عن أنماط Python غير المتزامنة. استخدم أداة البحث على الويب الأسرع المتاحة.

يقرأ Claude أوصاف الأداة ويختار بناءً على تعليماتك.

النمط 3: تسلسل سير العمل

يمكن أن يؤدي مخرج سير عمل واحد إلى تشغيل آخر. أنشئ:

fetch-data: يحصل على البيانات الأولية
analyze-data: يقبل البيانات، ويجري التحليل
summarize-data: يقبل التحليل، وينتج ملخصًا

في Claude Code:

اجلب بيانات المبيعات، حلل اتجاهات الربع الأول، ولخص الرؤى الرئيسية

سيقوم Claude بتسلسل سير العمل الثلاثة بالتتابع، ويمرر المخرجات بينها.

لا تنسَ تأمين الويب هوك الخاص بك

أضف رؤوس المصادقة في n8n:

عدّل عقدة الويب هوك (Webhook)
عيّن **المصادقة (Authentication)**: مصادقة بالرأس (Header Auth)
الاسم: X-API-Key
القيمة: سر_الويب_هوك_الآمن_الخاص_بك

حدث ملف .env لـ n8n-MCP:

N8N_WEBHOOK_SECRET=سر_الويب_هوك_الآمن_الخاص_بك

عدّل خادم MCP لتمرير الرؤوس (ستحتاج إلى تعديل src/index.ts):

// في دالة تنفيذ الأداة
const response = await fetch(webhookUrl, {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': process.env.N8N_WEBHOOK_SECRET
  },
  body: JSON.stringify(parameters)
});

تحديد المعدل (Rate Limiting)

أضف طبقة ذاكرة تخزين مؤقت Redis لمنع إساءة الاستخدام:

// في n8n-MCP، قبل استدعاء الويب هوك
import Redis from 'ioredis';
const redis = new Redis();

const rateLimitKey = `rate_limit:${toolName}:${Date.now() / 60000}`;
const count = await redis.incr(rateLimitKey);
if (count > 10) { // 10 استدعاءات في الدقيقة
  throw new Error('تم تجاوز حد المعدل');
}
await redis.expire(rateLimitKey, 60);

معالجة الأخطاء

عزز خادم MCP لإرجاع أخطاء منظمة:

try {
  const response = await fetch(webhookUrl, {...});
  if (!response.ok) {
    throw new Error(`HTTP ${response.status}: ${await response.text()}`);
  }
  return await response.json();
} catch (error) {
  return {
    error: error.message,
    status: 'فشل'
  };
}

سيعرض Claude Code الخطأ ويمكنه إعادة المحاولة تلقائيًا.

الخاتمة

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

button