اربط متجرك بالذكاء الاصطناعيّ — Mystoq MCP (Claude · ChatGPT

ما هو Mystoq MCP؟

MCP (Model Context Protocol) هو المعيار المفتوح الذي يربط نماذج الذكاء الاصطناعيّ بالأنظمة الخارجيّة. خادم Mystoq MCP يمنح المساعد أدواتٍ حقيقيّة على متجرك — لا مجرّد نصّ، بل أفعال: إنشاء منتج، تسعير، نشر، وتحليلات.

مثال: تقول لـClaude «أضِف منتج سمّاعة بلوتوث بسعر 3500 دج وانشره» → ينفّذ ذلك في متجرك فورًا عبر MCP، ويعود إليك برابط المنتج.

النقطة والبروتوكول

العنصر	القيمة
نقطة MCP	`https://mystoq.com/api/mcp`
النقل (Transport)	HTTP (JSON‑RPC 2.0)
إصدار البروتوكول	2024-11-05
الاكتشاف	`/.well-known/mcp.json`
المصادقة (للكتابة)	`Authorization: Bearer <مفتاح الاتّصال>`

أدوات القراءة عامّة (لا تحتاج مفتاحًا)؛ أدوات الكتابة على متجرك تحتاج مفتاح الاتّصال الخاصّ بك.

الأدوات المتاحة

الأداة	النوع	الوظيفة
search_stores	قراءة	اكتشاف المتاجر الجزائريّة العامّة
get_store	قراءة	تفاصيل متجر ومنتجاته العامّة
platform_stats	قراءة	أرقام شبكة Mystoq الحيّة
list_plans	قراءة	باقات وأسعار Mystoq
cod_profit	قراءة	حاسبة ربح الدفع‑عند‑الاستلام و CAC
yalidine_delivery	قراءة	حاسبة سعر شحن Yalidine
order_risk	قراءة	تقدير مخاطر احتيال الطلب
create_store	كتابة	إنشاء متجر جديد (يعيد رمز وصول)
create_product	كتابة	إنشاء منتج في متجرك
set_price	كتابة	تعديل سعر منتج
publish	كتابة	نشر منتج (يظهر في الواجهة)
delete_product	كتابة	حذف منتج من متجرك

مفتاح الاتّصال (Connection Key)

لتديرَ متجرك، يحتاج المساعد مفتاحًا خاصًّا بك — مفتاح دائم وقابل للإبطال، وليس كلمة مرورك ولا رمز جلستك.

افتح لوحتك: لوحة التحكم → المطوّرون → الاتّصال بالذكاء الاصطناعيّ
اضغط «توليد مفتاح الاتّصال» وانسخه فورًا (يُعرَض مرّة واحدة).
ألصقه في مساعدك حسب الخطوات أدناه.
يمكنك إبطاله في أي لحظة من نفس المكان (يقطع وصول المساعد فورًا).

🔒 عامِل المفتاح كأنّه كلمة مرور — من يملكه يستطيع إدارة متجرك. لا تنشره علنًا. إن تسرّب، أبطله وأصدر غيره.

ربط Claude

Claude Desktop (الأوضح)

أضِف الخادم إلى ملفّ إعداد Claude Desktop:

// claude_desktop_config.json
{
  "mcpServers": {
    "mystoq": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mystoq.com/api/mcp",
               "--header", "Authorization: Bearer مفتاحك_هنا"]
    }
  }
}

أعِد تشغيل Claude Desktop → ستظهر أدوات Mystoq. جرّب: «أنشئ منتجًا اسمه قميص قطنيّ بسعر 1900 دج».

claude.ai (Custom Connector)

الإعدادات → Connectors → «Add custom connector».
الرابط: https://mystoq.com/api/mcp
أضِف ترويسة المصادقة إن طُلبت: Authorization: Bearer <مفتاحك>

بدون مفتاح، تعمل أدوات القراءة فقط (اكتشاف المتاجر والحاسبات).

ربط ChatGPT

عبر ميزة Connectors (الأعمال/المتقدّم) التي تدعم MCP:

الإعدادات → Connectors → أضِف خادم MCP.
الرابط: https://mystoq.com/api/mcp
المصادقة: Bearer <مفتاح الاتّصال>

أو أنشئ GPT مخصّصًا باستخدام «Actions» ومانيفست الإضافة: /.well-known/ai-plugin.json.

ربط Gemini

عبر أدوات Gemini التي تدعم MCP (Gemini CLI / Vertex Extensions):

# مثال إعداد خادم MCP في عميل Gemini يدعم MCP
{
  "mcpServers": {
    "mystoq": {
      "httpUrl": "https://mystoq.com/api/mcp",
      "headers": { "Authorization": "Bearer مفتاحك_هنا" }
    }
  }
}

ثم اطلب من Gemini استخدام أدوات Mystoq مباشرةً بلغتك.

نداء خام (JSON‑RPC) — يعمل في أيّ مكان

يمكنك استدعاء الخادم مباشرةً للاختبار:

# قائمة الأدوات
curl -X POST https://mystoq.com/api/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

# إنشاء منتج (كتابة — يحتاج المفتاح)
curl -X POST https://mystoq.com/api/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer مفتاحك" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call",
       "params":{"name":"create_product",
                 "arguments":{"name":"سمّاعة بلوتوث","price":3500}}}'

الأمان

عزل تامّ بين المتاجر: مفتاحك يصل متجرك فقط — لا يمكن لأيّ مساعد لمس متجر آخر.
قابل للإبطال فورًا: ألغِ المفتاح من لوحتك متى شئت.
ليس كلمة مرورك: المفتاح مستقلّ عن حسابك ولا يكشفه.
أدوات القراءة عامّة وآمنة (بيانات متاجر عامّة + حاسبات) ومحدودة المعدّل.
حدّ معدّل على النقطة لمنع الإساءة.

أسئلة أو تكامل مخصّص؟ راجع واجهة المطوّرين أو تواصل مع دعم Mystoq.