ربط AssistFlow CRM بـ Cursor IDE باستخدام MCP: دليل خطوة بخطوة

AssistFlow AI · 2026-05-01

ربط AssistFlow CRM بـ Cursor IDE باستخدام MCP

الوقت: ~3 دقائق · المستوى التقني: منخفض · التكلفة: مجاني

سيقوم هذا الدليل بربط حسابك في AssistFlow بـ Cursor IDE عبر بروتوكول نموذج السياق (MCP). بمجرد الاتصال، يمكنك استخدام أوامر اللغة الطبيعية في لوحة Composer/Agent الخاصة بـ Cursor مثل "قائمة بـ 10 عملاء في قطاع طب الأسنان المعينين لي في إسطنبول الذين لم أتصل بهم اليوم".

ما هو MCP ولماذا هو مهم؟

تم فتح بروتوكول نموذج السياق من قبل Anthropic في نوفمبر 2024، وهو معيار مفتوح يسمح لعملاء الذكاء الاصطناعي (Cursor، Claude Desktop، Continue، Cline، إلخ) بالاتصال بالأنظمة الخارجية بطريقة موحدة. خادم MCP الخاص بـ AssistFlow متوافق تمامًا — لذا تعمل نفس الأدوات في أي عميل متوافق مع MCP.

المتطلبات المسبقة

حساب AssistFlow (حالي أو تجربة مجانية لمدة 14 يومًا)
Cursor IDE 0.42 أو أحدث
Terminal (macOS/Linux) أو PowerShell (Windows) — اختياري، للاختبار

1. إنشاء رمز API شخصي

انتقل إلى الإعدادات → رموز API (يجب تسجيل الدخول).
انقر على "رمز جديد" في الزاوية العلوية اليمنى.
امنحه اسمًا يسهل تذكره: "Cursor IDE الخاص بي — حاسوب العمل المحمول"
يتم عرض الرمز مرة واحدة فقط. انسخه فورًا واحفظه في مكان آمن (1Password، KeePass، إلخ).

تنسيق الرمز: 47 حرفًا يبدأ بـ asf_.

⚠️ الأمان: لا تقم أبدًا بإرسال الرمز إلى GitHub، ولا ترسله عبر البريد الإلكتروني، ولا تعرضه في مشاركة الشاشة. إذا كنت تشك في أنه تم تسريبه، قم بإلغائه فورًا من الإعدادات → رموز API — يصبح غير نشط في غضون ثوانٍ.

2. اختبار أن الرمز يعمل

قبل إدخاله في Cursor، من الجيد التحقق من الرمز عبر PowerShell أو curl.

PowerShell (Windows):

$token = "asf_PASTE_YOUR_TOKEN"
$body  = '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Invoke-RestMethod -Method Post `
  -Uri "https://fhauzjsujvoodywfwuvz.supabase.co/functions/v1/mcp-server" `
  -Headers @{ Authorization = "Bearer $token"; "Content-Type" = "application/json" } `
  -Body $body | ConvertTo-Json -Depth 6

curl (macOS/Linux/WSL):

curl -X POST https://fhauzjsujvoodywfwuvz.supabase.co/functions/v1/mcp-server \\
  -H "Authorization: Bearer asf_PASTE_YOUR_TOKEN" \\
  -H "Content-Type: application/json" \\
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | jq

يجب أن تعرض الاستجابة 10 أدوات: list_my_leads، get_lead، create_ticket، get_call_transcript وغيرها. إذا لم تأتِ أي استجابة، فإن الرمز غير صالح أو منتهي الصلاحية أو ملغى.

3. تعديل ملف mcp.json الخاص بـ Cursor

في Cursor IDE، افتح الإعدادات → إعدادات Cursor → MCP، أو قم بتحرير الملف مباشرة:

Windows:%USERPROFILE%\\.cursor\\mcp.json
macOS / Linux:~/.cursor/mcp.json

قم بإنشاء الملف إذا لم يكن موجودًا. أضف مفتاح assistflow إلى كتلة mcpServers الموجودة:

{
  "mcpServers": {
    "assistflow": {
      "url": "https://fhauzjsujvoodywfwuvz.supabase.co/functions/v1/mcp-server",
      "headers": {
        "Authorization": "Bearer asf_PASTE_YOUR_TOKEN_HERE"
      }
    }
  }
}

4. إعادة تشغيل Cursor

قم بإغلاق Cursor تمامًا وأعد فتحه. افتح لوحة Composer / Chat — تحت "الأدوات" أو "خوادم MCP"، يجب أن ترى خادم assistflow مع جميع الأدوات العشرة المدرجة.

5. البدء في استخدام اللغة الطبيعية

يمكنك الآن كتابة أوامر مثل هذه في Cursor Composer:

"قائمة بـ 10 عملاء في قطاع طب الأسنان المعينين لي في إسطنبول، بدءًا من الذين لم أتصل بهم اليوم."
"تلخيص آخر 5 أنشطة لهذا العميل واقتراح الخطوة التالية."
"انظر إلى نص هذه المكالمة — كيف كان يجب أن أتعامل مع اعتراض العميل؟"
"افتح تذكرة دعم جديدة لهذا العميل بعنوان 'استفسار عن الأسعار'."
"إيقاف التنقيط التلقائي — معدل الارتداد يتجاوز 5%." (للمسؤولين فقط)

يقوم Cursor تلقائيًا باختيار الأداة المناسبة وكتابة النتيجة مباشرة في المحرر. لا حاجة لتبديل النوافذ، ولا لوحة AssistFlow — نظام إدارة علاقات العملاء بالكامل في بيئة التطوير المتكاملة الخاصة بك.

ما هي الأدوات المتاحة؟

نفس الأدوات العشرة كما في النسخة التركية أعلاه: list_my_leads، get_lead، update_lead_status، add_lead_note، get_call_transcript، list_my_tickets، create_ticket، بالإضافة إلى أدوات خاصة بالإدارة get_drip_health، pause_drip، resume_drip.

الأسئلة الشائعة

من يرى ماذا؟

أدوات العملاء/التذاكر/المكالمات تعمل للجميع (بما في ذلك ممثلي المبيعات) — ولكن بفضل سياسات أمان مستوى الصف (RLS) في AssistFlow، يرى كل مستخدم فقط السجلات المعينة له. أدوات إدارة التنقيط مخصصة للمسؤولين.

ماذا لو تم سرقة رمزي؟

قم بإلغائه فورًا من الإعدادات → رموز API. يصبح غير نشط في غضون ثوانٍ. يمكنك أيضًا رؤية أعمدة use_count وlast_used_at لتتبع النشاط.

فقط Cursor؟

لا. أي عميل متوافق مع MCP يعمل: Cursor، Claude Desktop، Continue، Cline وغيرها. نفس عنوان URL والرمز، فقط ملف تكوين مختلف.

هل هناك تكلفة إضافية؟

لا. يمكن لأي شخص لديه اشتراك في AssistFlow إنشاء رموز غير محدودة مجانًا.