ربط Cursor باستوديوك

ما هو

Cursor محرر مزوّد بذكاء اصطناعي مدمج. باستخدام موصل الذكاء الاصطناعي، يمكن لمحادثة Cursor الاطّلاع على بيانات استوديوك (المبيعات والعملاء والمواعيد والشؤون المالية) عند طرح سؤالك، وفقًا لصلاحيات المستخدم المرتبطة بالمفتاح. يقتصر دوره على الاطّلاع، ولا يغيّر أي شيء في النظام.

متى تستخدمه

إذا كنت تطوّر تكاملًا أو موقعًا إلكترونيًا وتريد التحقق من بيانات الاستوديو الفعلية دون مغادرة المحرر.
إذا كنت تستخدم محادثة Cursor يوميًا وتريد الاستفسار عن نشاط الاستوديو.

قبل أن تبدأ

جهّز عنوان الموصل ومفتاح API مفعّلًا فيه خيار “السماح بالاستخدام كموصل ذكاء اصطناعي”، وأنشئهما وفقًا للمقال موصل الذكاء الاصطناعي.

خطوة بخطوة

الخطوة 1 — إضافة الموصل

افتح الملف ~/.cursor/mcp.json (أو أنشئه)، وأضف المقطع أدناه، مع استبدال العنوان بالعنوان الذي نسخته عبر نسخ العنوان، واستبدال hk_... بمفتاحك:

{
  "mcpServers": {
    "heya": {
      "url": "https://seu-dominio/mcp",
      "headers": { "Authorization": "Bearer hk_..." }
    }
  }
}

الخطوة 2 — التحقق من الاتصال

في إعدادات Cursor، افتح قسم MCP. يجب أن يظهر الموصل heya نشطًا، مع الأدوات listar_areas وbuscar_ferramentas وexecutar_consulta.

الخطوة 3 — طرح سؤال

اكتب في محادثة Cursor سؤالًا مثل: “ما العملاء الذين تلقوا الخدمة اليوم في الاستوديو؟”.

ماذا يحدث بعد ذلك

يبحث Cursor عن الاستعلام المناسب لسؤالك، وينفّذه، ثم يعرض الإجابة بأرقام النظام.
يظهر المفتاح في علامة التبويب مفتاح API، مع تحديث آخر استخدام.
لإيقاف الوصول، ألغِ المفتاح من علامة التبويب مفتاح API؛ وسيفقد Cursor إمكانية الوصول خلال 30 ثانية كحد أقصى.

أخطاء شائعة وأسئلة

س: يظهر خطأ في الموصل ضمن إعدادات Cursor. ماذا أفعل؟
ج: تحقّق من أن العنوان ينتهي بـ /mcp ومن أنك لصقت المفتاح كاملًا، مع Bearer ومسافة بعده. بعد تعديل mcp.json، أوقف الموصل ثم أعد تشغيله من إعدادات Cursor.

س: هل يمكنني استخدام متغير بيئة بدلًا من المفتاح؟
ج: بعض إصدارات Cursor لا تستبدل المتغير بقيمته في الترويسة، بل ترسل نص المتغير كما هو. إذا لم يتصل الموصل عند استخدام المتغير، فأدخِل المفتاح مباشرةً في ملف المستخدم.

س: هل يمكنني وضع الإعداد في ملف المشروع .cursor/mcp.json؟
ج: تجنّب ذلك؛ فعادةً ما يُضاف هذا الملف إلى نظام التحكم في الإصدارات، ما قد يكشف المفتاح. استخدم ملف المستخدم (~/.cursor/mcp.json).

س: يقول Cursor إن المفتاح يجب أن يتضمن خيار “السماح بالاستخدام كموصل ذكاء اصطناعي”. لماذا؟
ج: أُنشئ المفتاح دون تفعيل هذا الخيار. عدّل المفتاح من علامة التبويب مفتاح API، وفعّل السماح بالاستخدام كموصل ذكاء اصطناعي.

س: فتح Cursor شاشة تسجيل دخول بدلًا من استخدام المفتاح. ماذا أفعل؟
ج: تحقّق من وجود كتلة headers التي تتضمن المفتاح في mcp.json. عند استخدام المفتاح الصحيح، يستجيب النظام مباشرةً ولا تكون هناك حاجة إلى تسجيل الدخول. إذا استمر Cursor في طلب تسجيل الدخول وتعذّر إتمامه، فاستخدم المفتاح مع Claude Code أو Gemini CLI، أو تواصل مع الدعم.

س: هل يستطيع Cursor تعديل بيانات النظام عبر الموصل؟
ج: لا. يقتصر دور الموصل على الاطّلاع. تُجرى التعديلات من داخل النظام.