خادم MCP

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

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

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

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

{
  "mcpServers": {
    "namesight": {
      "command": "node",
      "args": ["/path/to/namesight/apps/mcp/dist/main.js"],
      "env": {
        "NAMESIGHT_API_KEY": "ns_live_...",
        "NAMESIGHT_API_URL": "https://api.namesight.app"
      }
    }
  }
}

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

claude mcp add namesight \
  --env NAMESIGHT_API_KEY=ns_live_... \
  --env NAMESIGHT_API_URL=https://api.namesight.app \
  -- node ./apps/mcp/dist/main.js

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

قوائم المرجع متاحة أيضًا بوصفها موارد — namesight://reference/nice-classes و regions و tlds و adapters — فيرفقها العميل بالمحادثة مرة واحدة بدل إنفاق نداء أداة كل مرة. الموجّه check_brand_name وصف جاهز: افحص الاسم، وأعد محاولة ما لم يُتحقق منه، واشرح النتيجة، واقترح بدائل إن كان مأخوذًا.

كل أداة تعلن مخطط إخراج، و list_scans تتصفّح بـ cursor و status. إعادة المحاولة بعد انقطاع الاتصال آمنة: يعيد الخادم الجواب الأول بدل التحصيل مرتين.

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

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

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

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

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

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

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