Cursor مع MCP: إعداد Same-QR في المحرر وإدارة رموز QR

Cursor وMCP باختصار

Cursor محرر أكواد بمساعد ذكاء اصطناعي مدمج يعرف مشروعك وينفّذ مهامًا عبر عدة ملفات. وعبر MCP يستخدم أيضًا أدوات خدمات أخرى. وبالنسبة لمطوري الويب والوكالات يعني هذا أنك تستطيع صيانة الموقع ورموز QR التي تشير إلى صفحاته في الأداة نفسها.

الخطوة 1: إنشاء المفتاح

في لوحة تحكم Same-QR ضمن الحساب، في قسم «الوصول لـ CLI والسكربتات والوكلاء»، تنشئ مفتاحًا: «للقراءة فقط» للتحليلات، أو «قراءة + كتابة» للإنشاء، أو «كامل» إذا أردت تغيير الوجهات أيضًا. وفّره كمتغير بيئة باسم SAMEQR_API_KEY قبل تشغيل Cursor.

الخطوة 2: الإدخال في mcp.json

افتح الملف ~/.cursor/mcp.json أو أنشئه، وأضف Same-QR:

{ "mcpServers": { "sameqr": { "url": "https://sameqr.com/api/mcp", "headers": { "Authorization": "Bearer ${env:SAMEQR_API_KEY}" } } } }

يشير الإدخال إلى متغير البيئة فقط، أما المفتاح نفسه فلا يوجد في الملف. وإذا وُجدت هناك خوادم أخرى، فأضف sameqr داخل mcpServers. كما يعرض لك الأمر «sameqr mcp» الإدخال نفسه.

الخطوة 3: الاختبار

أعد تشغيل Cursor واسأل المساعد: «ما رموز QR التي أملكها في Same-QR؟» إذا ظهرت القائمة فالاتصال يعمل.

الخطوة 4: إعادة إطلاق موقع عميل

عند إعادة الإطلاق تتغير العناوين. إعادة التوجيه على الموقع تراقبها، أما رموز QR المطبوعة فيسهل نسيانها. ومع Cursor يصبح هذا جزءًا من العمل نفسه:

• دع المساعد يعرض كل رموز QR الخاصة بالعميل مع وجهتها الحالية.
• دعه يقارن القائمة بجدول العناوين القديمة والجديدة في المشروع.
• اطلب خطة: أي رمز QR يجب أن يشير إلى أي عنوان جديد.
• راجع الخطة وأكّدها، ثم اجعله ينفّذ التغيير.
• امسح بعض رموز QR بالهاتف بعد التغيير.

إذا كان الموقع مرتبطًا مع Same-QR، وهذا ممكن في الباقات المدفوعة، فإن Same-QR يقترح بنفسه العنوان الجديد بعد إعادة الإطلاق. ولا يُغيَّر شيء إلا بعد التأكيد.

الأمان

• للتحليلات استخدم مفتاحًا «للقراءة فقط»، وحينها لا يرى المساعد أدوات الكتابة.
• لا تكتب المفتاح مباشرة في mcp.json أو في ملفات المشروع.
• اجعله يعرض لك خطة أولًا عند أي تغيير في رموز QR المطبوعة.
• ألغِ المفتاح عند انتهاء المشروع.

الخلاصة: لماذا Same-QR

يجلب Same-QR رموز QR إلى المحرر بإدخال واحد في mcp.json. تحصل على كامل الوظائف، وصلاحيات واضحة، واطمئنان إلى أنه لن يبقى رمز QR مطبوع يؤدي إلى لا شيء بعد إعادة الإطلاق. في كل باقة.

ابدأ الآن: سجّل مجانًا على sameqr.com، فـ 20 رمز QR ديناميكيًا مجانية بشكل دائم. API وCLI وخادم MCP متاحة في كل باقة، والتوثيق على sameqr.com/entwickler.

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