خادم MCP

بروتوكول سياق النموذج (MCP) هو الطريقة التي يصل بها المساعد الذكي إلى أدوات خارجة عنه. وخادم Namescope الخاص بـ MCP برنامج صغير يتحدث هذا البروتوكول: يطلب المساعد فحص اسم، فيستدعي الخادم الواجهة البرمجية العامة نفسها التي كنت ستستدعيها بنفسك، ثم يعيد النتيجة.

وهو لا يحتفظ ببيانات خاصة به. فالنطاقات والأرصدة وحدود المعدّل تفرضها الواجهة البرمجية تمامًا كما تفعل مع أي طلب مباشر، لذا لا يستطيع الخادم فعل أي شيء لا يستطيع مفتاحك فعله.

تحتاج مفتاح واجهة برمجية يحمل النطاقات scans:read و scans:write و reference:read. أنشئ واحدًا من الإعدادات ← مفاتيح الواجهة البرمجية.

Claude Desktop — أضف الخادم إلى claude_desktop_config.json:

{
  "mcpServers": {
    "namescope": {
      "command": "node",
      "args": ["/path/to/namescope/apps/mcp/dist/main.js"],
      "env": {
        "NAMESCOPE_API_KEY": "ns_live_...",
        "NAMESCOPE_API_URL": "https://api.namescope.dev"
      }
    }
  }
}

Claude Code — بأمر واحد:

claude mcp add namescope \
  --env NAMESCOPE_API_KEY=ns_live_... \
  --env NAMESCOPE_API_URL=https://api.namescope.dev \
  -- node ./apps/mcp/dist/main.js

أداة namescope_scan_name وحدها هي التي تنفق شيئًا، وهي الأداة الوحيدة الموسومة بأنها تكتب، لذا فإن العميل الذي يستأذن قبل إجراءات الكتابة سيستأذن قبل الفحص.

تستغرق عمليات الفحص وقتًا، بينما يعود استدعاء الأداة مرة واحدة. تعيد namescope_scan_name افتراضيًا قيمة scanId فورًا، ثم يقرأ المساعد النتيجة بـ namescope_get_scan.

مرّر waitMs ليتولّى الخادم الانتظار بدلًا من ذلك: يستعلم دوريًا حتى ينتهي الفحص، بدءًا من مرة كل ثانية تقريبًا ثم يوسّع الفاصل إلى خمس ثوانٍ، ثم يعيد النتيجة ضمن الرد. وإذا نفدت المهلة المخصصة فستحصل على الفحص الجزئي بدل رسالة خطأ — فعمليات التحقق التي اكتملت تظل جديرة بالقراءة.

بعد توصيل الخادم تسأل بلغة عادية؛ والمساعد هو من يختار الأدوات. والطلب المفيد هو الذي يسمّي الفئات أو الأسواق، لأن ذلك هو ما يفصل بين تعارض حقيقي وعلامة لا صلة لها بك.

افحص ما إذا كان اسم "Tion Studios" متاحًا لاستوديو ألعاب
في تركيا والاتحاد الأوروبي — فئتا نيس 9 و 41.

سيبحث المساعد عادةً عن الفئات باستخدام namescope_reference، ثم يبدأ الفحص، وينتظره، ويلخّص ما يعيق الاسم وما لا يعيقه.

تعود إخفاقات الواجهة البرمجية على هيئة أخطاء أدوات مقروءة لا على هيئة انهيارات، فيستطيع المساعد أن يشرح المشكلة، وأن يصلحها ويعيد المحاولة متى أمكنه ذلك.

• 401 — المفتاح مفقود أو غير معروف أو مُبطَل أو منتهي الصلاحية
• 402 — خطة مساحة العمل لا تشمل الواجهة البرمجية
• 403 — المفتاح يفتقر إلى نطاق، أو إنفاق الأرصدة معطَّل
• 429 — تجاوز حدّ المعدّل أو رصيد الأرصدة