Claude Code ورموز QR: إعداد Same-QR عبر MCP خطوة بخطوة

ما هو Claude Code

Claude Code هو وكيل برمجة من Anthropic. يعمل في الطرفية أو في بيئة التطوير، ويقرأ الملفات ويعدّلها وينفّذ الأوامر. وعبر MCP، أي Model Context Protocol، يستخدم أيضًا أدوات خدمات أخرى. وعند ربطه مع Same-QR يستطيع التعامل مع رموز QR وصفحات الضيوف وقوائم الطعام والتصنيفات ومشاريع العملاء في حسابك.

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

افتح في لوحة تحكم Same-QR الحساب وقسم «الوصول لـ CLI والسكربتات والوكلاء». أنشئ مفتاحًا. إذا كان Claude Code سيحلل فقط، فاختر «للقراءة فقط»، وحينها لا يرى الوكيل أدوات الكتابة أصلًا. وللإنشاء اختر «قراءة + كتابة»، وإذا أردته أن يغيّر وجهات رموز QR القائمة أيضًا فاختر «كامل». يبدأ المفتاح بـ sqr_live_ ويُعرض مرة واحدة فقط.

الخطوة 2: ضبط المفتاح كمتغير بيئة

احفظ المفتاح في مدير كلمات المرور، ووفّره كمتغير بيئة باسم SAMEQR_API_KEY، مثلًا عند تشغيل الصدفة. أما ملفات المشروع فليس مكانه فيها.

الخطوة 3: إضافة خادم MCP

يكفي أمر واحد في الطرفية:

claude mcp add --transport http sameqr https://sameqr.com/api/mcp --header "Authorization: Bearer $SAMEQR_API_KEY"

ومن ثبّت برنامج سطر الأوامر sameqr يظهر له هذا السطر أيضًا عبر «sameqr mcp».

الخطوة 4: اختبار الاتصال

شغّل Claude Code واسأل أولًا عن شيء لا يغيّر شيئًا: «ما الباقة التي أملكها في Same-QR، وما رموز QR الموجودة؟» يوصي الخادم الوكيل بأن يبدأ بهذا الاستعلام عن الحساب، ليعرف حدود باقتك.

الخطوة 5: رموز QR لصفحة حملة

مهمة نموذجية عندما تظهر صفحة هبوط جديدة في المشروع:

«أنشئ في Same-QR ثلاثة رموز QR ديناميكية للصفحة الجديدة /herbst: ملصق ومنشور وحامل طاولة. أضف إلى الوجهة في كل منها utm_source=qr وutm_medium مع الوسيلة، وامنحها جميعًا التصنيف Herbstaktion، وأرني القائمة قبل ذلك.»

بعد تأكيدك ينشئ Claude Code رموز QR. ولأن لكل مادة دعائية رمز QR خاص بها، سترى لاحقًا في Same-QR وفي تحليلات الويب أي وسيلة استُخدمت وكم مرة. أما ملفات الطباعة بصيغة SVG أو PDF فتنزّلها من لوحة التحكم.

الصلاحيات والتحكم

• عند تغيير رموز QR المطبوعة اطلب دائمًا قائمة أولًا.
• تغيير الوجهات والحذف يتطلبان تأكيدًا بالحالة التي قُرئت، بحد أقصى 10 في الساعة. أكّد عن قصد فقط.
• إذا أردت تحويل المهمة إلى مسار قابل للتكرار، فاجعل Claude Code يكتب سكربتًا باستخدام sameqr-CLI.
• ألغِ المفتاح عند انتهاء المشروع.

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

يتلاءم Same-QR مع Claude Code كأنه أداة مدمجة: أمر واحد للإعداد، وكل وظائف لوحة التحكم كأدوات MCP، ومفاتيح قراءة تخفي أدوات الكتابة، وتوثيق يفهمه الوكيل. في كل باقة، حتى المجانية.

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

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