خادم MCP لرموز QR: استخدم Same-QR في Claude وChatGPT وCursor وCodex

ما هو خادم MCP

ترمز MCP إلى Model Context Protocol، وهو معيار مفتوح للربط بين مساعدات الذكاء الاصطناعي والخدمات الأخرى. يصف خادم MCP أدوات خدمة ما، مثل «إنشاء رمز QR» أو «قراءة الإحصاءات». يرى المساعد هذه الأدوات ويستدعيها حين تحتاج إليها مهمة ما.

ما الذي يوفره خادم Same-QR MCP

يقع الخادم على العنوان https://sameqr.com/api/mcp ويقدم بالضبط أدوات واجهة REST البرمجية، بالأسماء نفسها وعمليات التحقق نفسها وحدود الباقة نفسها:

• الاستعلام عن الحساب والباقة، ليعرف المساعد ما هو ممكن.
• عرض رموز QR وقراءتها وإنشاؤها وتعديلها وحذفها وجلب إحصاءاتها.
• إنشاء صفحات الضيوف وقراءتها وتعديلها ونشرها وإيقافها وحذفها، إضافةً إلى قائمة التصاميم.
• قراءة قوائم الطعام وقوائم الأسعار من الصور أو من ملف PDF.
• إدارة التصنيفات ومشاريع العملاء وقراءة الطلبات الواردة من نماذج الاتصال.

الأدوات القارئة معلَّمة على هذا النحو، وأدوات الحذف معلَّمة على أنها نهائية. ومن أراد تغيير الوجهات أو إيقاف صفحة أو حذفها، عليه أن يسأل المستخدم وأن يرسل الحالة التي قرأها سابقًا. عبر API وMCP لا يُسمح بأكثر من 10 من هذه العمليات في الساعة.

طريقتان لتسجيل الدخول

يضيف ChatGPT وClaude.ai الخادم كموصّل. ويجري تسجيل الدخول عبر OAuth: تسجّل الدخول في المتصفح إلى Same-QR وتحدد بعلامات هل يُسمح للتطبيق بالقراءة فقط، أو أيضًا بالإنشاء وتغيير النصوص، أو إضافةً إلى ذلك بتغيير الوجهات وحذفها.

يتصل Claude Code وCursor وCodex بمفتاح API. تنشئه في لوحة التحكم ضمن الحساب، «الوصول لـ CLI والسكربتات والوكلاء»، وتختار «للقراءة فقط» أو «قراءة + كتابة» (إنشاء وتغيير الأسماء والنصوص) أو «كامل» (وبالإضافة إلى ذلك تغيير الوجهات والإيقاف والحذف)، وتحفظه كمتغير البيئة SAMEQR_API_KEY. وللمفتاح «للقراءة فقط» أثر جانبي جميل: لا يرى المساعد أدوات الكتابة أصلًا.

الإعداد في لمحة

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

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

لـ Cursor إدخال في الملف ~/.cursor/mcp.json:

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

لـ Codex قسم في الملف ~/.codex/config.toml:

[mcp_servers.sameqr]
url = "https://sameqr.com/api/mcp"
bearer_token_env_var = "SAMEQR_API_KEY"

من ثبّت أداة سطر الأوامر sameqr يحصل على هذه البيانات في أي وقت بالأمر «sameqr mcp». اختبر كل اتصال أولًا بسؤال قارئ، مثل «ما رموز QR التي أملكها؟».

الأمان والصلاحيات

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

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

تقدم Same-QR خادم MCP كاملًا بدل حفنة من الوظائف الاستعراضية: رموز QR والإحصاءات وقوائم الطعام وصفحات الضيوف والتصنيفات والمشاريع، لمساعدات المحادثة ووكلاء البرمجة على حد سواء. وهو مشمول في كل باقة، بصلاحيات واضحة وعمليات التحقق نفسها الموجودة في لوحة التحكم.

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

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