Namefi

إزاي تسجّل دومين باستخدام وكيل الذكاء الاصطناعي على Namefi

الدليل المرجعي لتسجيل دومين على Namefi باستخدام أي وكيل ذكاء اصطناعي — Claude وCodex وCursor وغيرهم — عبر MCP أو REST أو الدفع من المحفظة.

Fenwei BianFenwei Bianالكاتب/الكاتبةVictor ZhouVictor Zhouالمحرّر/المحرّرةZakia al-Sina'iZakia al-Sina'iالمترجم/المترجمة١٠ يوليو ٢٠٢٦≈ 15 دقيقة قراءة
  • ai-agents
  • guide
شارك على X

دي الصفحة اللي تحفظها عندك لو عايز وكيل ذكاء اصطناعي — أي وكيل ذكاء اصطناعي، مش وكيل تابع لمزوّد بعينه — يسجّلك دومين حقيقي على Namefi، وهي مُسجِّل معتمد من ICANN. الدليل بيشرح الآليات اللي ما بتتغيّرش مهما كان العميل اللي بتكتب فيه، وبعدها بيدي خطوات إعداد دقيقة ومُتحقَّق منها لكل واحد من الوكلاء الستة اللي الناس بتستخدمهم فعلاً دلوقتي: Claude Desktop وClaude Code وOpenAI Codex وCursor وWindsurf وGemini CLI. ولو وكيلك مش موجود في القائمة، فالدليل بيختم بمسار REST مباشر يشتغل مع أي حاجة تقدر تبعت طلب HTTP، لأن Namefi بتنشر واجهة API كاملة كنص عادي مخصوص للغرض ده.

الفريق بتاع Namefi هو اللي كاتب وبيحدّث الدليل ده، فجزء Namefi في كل خطوة مصدره رسمي: بيشرح بشكل مفهوم للبشر نفس الـ API اللي بننشرها للوكلاء في namefi.io/llms.txt وdocs.namefi.io. إعداد كل مزوّد وكيل اتراجع مقابل وثائقه الحالية وقت نشر الدليل؛ ولما وثائق مزوّد ما بتديش إجابة واضحة، بنوضّح ده صراحةً بدل ما نملا الفراغ بتخمين.

لو عارف إنك هتستخدم Claude وعايز الشرح الكامل المعلَّق عليه مع سجل حقيقي، فمقال اشتري دومين باستخدام Claude: دليل Namefi MCP خطوة بخطوة أعمق من الأقسام المختصرة الخاصة بـ Claude هنا. الصفحة دي هي المحور؛ أما المقال ده، وباقي الروابط الموزعة فيها، فهي الفروع.

المقصود فعلاً من «تسجيل دومين باستخدام وكيل ذكاء اصطناعي»

لازم حاجتين يتحققوا عشان الوكيل يسجّل دومين بالنيابة عنك من غير ما تملا نموذج بنفسك. أولاً، الوكيل محتاج طريقة يكتشف ويستدعي بيها API بتاعة Namefi — وده هو بروتوكول سياق النموذج (MCP)، معيار مفتوح بيوصل عميل ذكاء اصطناعي بخادم أدوات خارجي وبيخلّيه يشوف قائمة محددة بالعمليات اللي يقدر يستدعيها؛ أو طلب HTTP عادي لو الوكيل مكتوب كسكربت بدل ما يكون حواري. ثانياً، الوكيل محتاج تفويض للصرف — مفتاح API مربوط برصيد ممول، أو محفظة تشفير تقدر توقّع دفعة في اللحظة نفسها. كل حاجة في الدليل ده واحدة من القطعتين دول.

Namefi بتشغّل خادم MCP واحد لكل الـ API عندها، على https://api.namefi.io/mcp وبنقل Streamable HTTP. وكيل — أو الشخص اللي بيضبطه — يقدر يكتشفه من غير ما يقرأ الصفحة دي: بننشر واصفاً مقروءاً آلياً في namefi.io/.well-known/mcp/servers.json بيسمّي الخادم namefi-api وبيسجّل نقله باسم streamable-http. كل العملاء اللي تحت بيتصلوا بنفس الرابط؛ الاختلاف الوحيد هو إزاي ملف إعدادات كل عميل أو سطر أوامره بيطلب منك تشير له.

المسار العام من خمس خطوات

ده التسلسل الموجود تحت كل قسم خاص بوكيل فيما بعد. لما تفهمه هنا، تعليمات كل وكيل بتبقى مجرد «إزاي أنفّذ الخطوة 2 في الأداة دي تحديداً؟».

  1. هات بيانات الاعتماد. أنشئ مفتاح API — سلسلة تبدأ بـ nfk_ وتشتغل مع كل العمليات: التسجيل، وإنشاء سجلات DNS، والتحديثات، والحذف. المفتاح بيرث صلاحيات المحفظة اللي أنشأته، فأنشئه من المحفظة اللي المفروض تملك الدومين. ولو مش حابب تحتفظ بمفتاح API لـ Namefi أصلاً، انطّ لمسار الدفع بالمحفظة تحت — مش محتاج حساب.
  2. وصّل وكيلك بخادم MCP. وجّه عميلك إلى https://api.namefi.io/mcp مع هيدر x-api-key اللي يحمل مفتاحك. الصياغة الدقيقة بتختلف حسب العميل — راجع قسم وكيلك تحت.
  3. ابحث وسعّر. اسأل بلغة عادية إذا كان الاسم متاحاً. ده بيستدعي عملية checkAvailability (GET /v-next/search/availability?domain=…) اللي مش بتحتاج أي مصادقة، أو نسختها الجماعية عشان تفحص كذا اختيار في مرة واحدة.
  4. سجّل ثم استطلع الحالة. بعد التأكيد، الوكيل بيبعت registerDomain (POST /v-next/orders/register-domain)، أو النسخة المجمعة register-domain/records لو عايز تضبط DNS في نفس الاستدعاء. التسجيل غير متزامن — جسم الطلب بياخد normalizedDomainName وdurationInYears، ونقطة register-domain/records بتقبل كمان مصفوفة records (name وtype وrdata وttl لكل سجل) عشان DNS يتكتب لحظة ما الطلب يكتمل. الوكيل (أو أنت) بيستطلع getOrder (GET /v-next/orders/{orderId}) لحد ما يوصل لحالة نهائية: SUCCEEDED أو FAILED أو CANCELLED أو PARTIALLY_COMPLETED.
  5. اضبط DNS وتحقق. أضف أو عدّل أنواع سجلات DNS (A، AAAA، CNAME، MX، TXT) عن طريق createDnsRecord (POST /v-next/dns/records)، واضبط التفويض على مستوى خادم الأسماء (سجل NS) لو لزم، وادّي انتشار DNS دقايق قليلة قبل ما تتأكد إن الدومين بيتحل بشكل صحيح.

طلب التسجيل كمان بيقبل كائن domainSetupOptions فيه إعدادات لكل دومين — autoPark وautoEns وautoRenew وdnssec وkeepExistingNameservers (الأخير بيقول لـ Namefi تسيب تفويض خادم الأسماء الحالي للدومين زي ما هو بدل ما تعيد توجيهه، وده مفيد لو بتسجّل دومين المفروض يفضل شغال في مكان تاني فوراً). الحقل الاختياري nftReceivingWallet بيتحكم في المحفظة اللي بيروح لها توكن ملكية الدومين — لو ما بعتّوش، الدومين هيتسجل كـ NFT على Base للمحفظة المرتبطة بمفتاح الـ API بتاعك.

جدول إعداد كل وكيل

الوكيلطريقة الاتصالمكان الإعدادهل هيدر مصادقة مخصص مدعوم؟التحقق تم مقابل
Claude CodeMCP، ‏Streamable HTTPأمر CLI اسمه claude mcp add (بيكتب في ~/.claude.json أو .mcp.json)أيوه — علامة --headercode.claude.com/docs/en/mcp، تم التحقق في 2026-07-10
Claude Desktop / claude.aiMCP، ‏Streamable HTTP عبر Custom ConnectorSettings → Connectors → Add custom connectorمطالبة مصادقة بيشغّلها الخادم (OAuth أو مفتاح API أو بيانات اعتماد، حسب اللي الخادم بيطلبه)modelcontextprotocol.io، تم التحقق في 2026-07-10
OpenAI Codex CLIMCP، ‏Streamable HTTP~/.codex/config.toml، جدول [mcp_servers.<name>]أيوه — http_headers (ثابتة) أو env_http_headers (من متغيرات البيئة)learn.chatgpt.com/docs/extend/mcp (هدف إعادة التوجيه الحالي لـ developers.openai.com/codex/mcp)، تم التحقق في 2026-07-10
CursorMCP، ‏Streamable HTTP.cursor/mcp.json (للمشروع) أو ~/.cursor/mcp.json (عام)أيوه — كائن headers، مع استبدال ${env:VAR}cursor.com/docs/mcp، تم التحقق في 2026-07-10
Windsurf (Cascade)MCP، ‏Streamable HTTP~/.codeium/windsurf/mcp_config.jsonأيوه — كائن headers في مدخل serverUrl، مع استبدال ${env:VAR}docs.windsurf.com/windsurf/cascade/mcp (وقت نشر الدليل، الرابط بيحوّل إلى docs.devin.ai/desktop/cascade/mcp — راجع قسم Windsurf تحت)، تم التحقق في 2026-07-10
Gemini CLIMCP، ‏Streamable HTTP~/.gemini/settings.json (للمستخدم) أو .gemini/settings.json (للمشروع)أيوه — كائن headers في مدخل httpUrlgeminicli.com/docs/tools/mcp-server، تم التحقق في 2026-07-10
أي عميل MCP آخرMCP، ‏Streamable HTTPأي صيغة إعدادات يوثقها العميلحسب العميل — جانب خادم Namefi ما بيتغيرشnamefi.io/.well-known/mcp/servers.json
أي سكربت أو وكيل من غير MCPREST مباشرغير منطبقأيوه — هيدر x-api-key في كل استدعاء كتابةnamefi.io/llms.txt، docs.namefi.io

كل صف فوق بيتصل بنفس الخادم وبنفس مجموعة العمليات بالضبط. الحاجة الوحيدة اللي بتتغيّر من وكيل للتاني هي صيغة إخبار العميل المحدد: «ده خادم MCP بعيد، وده الهيدر اللي تبعته معاه».

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

"تحقق مما إذا كان example.com متاحاً للتسجيل على Namefi، وأخبرني بأي أداة أو عملية استدعيتها لمعرفة ذلك. لا تسجّل أي شيء حتى الآن."

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

Claude Desktop وclaude.ai

Claude Desktop وclaude.ai بيتصلوا بخوادم MCP البعيدة من خلال Custom Connectors. افتح Settings، وروح لـ Connectors، واختار "Add custom connector"، واكتب https://api.namefi.io/mcp كرابط للخادم. بعد ما تدوس Add، Claude هيطلب منك تكمل المصادقة — وثائق Anthropic بتوصف الخطوة دي إنها غالباً بتشمل "OAuth أو مفاتيح API أو تركيبات اسم مستخدم/كلمة مرور"، والمطالبة الدقيقة بيحددها اللي الخادم المتصل بيحتاجه.

Claude Code

وثائق Claude Code نفسها بتدي صياغة عامة دقيقة لإضافة خادم MCP بعيد عبر HTTP بهيدر مخصص:

claude mcp add --transport http namefi https://api.namefi.io/mcp --header "x-api-key: YOUR_KEY"

شغّل الأمر ده مرة واحدة من الطرفية بعد ما تستبدل مفتاحك الحقيقي. افتراضياً، ده بيكتب الخادم على نطاق local — متاح لك أنت بس، في مشروعك الحالي (إصدارات Claude Code الأقدم كانت بتسمّي النطاق ده "project"). أضف --scope user لو عايز الاتصال يبقى متاح في كل مشروع على جهازك، أو --scope project عشان تشاركه مع كل الناس في المشروع عبر ملف .mcp.json متسجل في Git. أكّد الاتصال باستخدام claude mcp list، وتحقق من عدد الأدوات الحي داخل جلسة بـ /mcp.

OpenAI Codex CLI

Codex CLI بيحفظ إعدادات MCP في ملف TOML، افتراضياً ~/.codex/config.toml (أو .codex/config.toml على نطاق المشروع للمشاريع الموثوقة). كل خادم له جدوله الخاص، والنقل بيتحدد من المفاتيح الموجودة: مفتاح command معناه خادم stdio محلي، ومفتاح url معناه Streamable HTTP. وثائق Codex واضحة إن اسم الجدول لازم يكون mcp_servers بشرطة سفلية — الصيغ زي mcp-servers بتتجاهل بصمت.

# ~/.codex/config.toml
[mcp_servers.namefi]
url = "https://api.namefi.io/mcp"
env_http_headers = { "x-api-key" = "NAMEFI_API_KEY" }

الصيغة دي بتسحب المفتاح من متغير بيئة اسمه NAMEFI_API_KEY بدل ما تكتبه في الملف — اضبطه في الـ shell قبل ما تشغل Codex. ولو تفضّل تكتبه صراحةً (مش مستحسن لملف ممكن تعمله commit)، فالصيغة الثابتة المكافئة هي http_headers = { "x-api-key" = "YOUR_KEY" }. Codex كمان بيوثق حقل bearer_token_env_var مخصص لمصادقة على نمط Authorization: Bearer …، لكن هيدر Namefi x-api-key محتاج حقول http_headers / env_http_headers العامة، مش الحقل الخاص بالـ bearer.

Cursor

Cursor بيقرأ تعريفات خادم MCP من mcp.json — نسخة خاصة بالمشروع في .cursor/mcp.json عند جذر المستودع، أو نسخة عامة في ~/.cursor/mcp.json بتتطبق في كل مكان. وثائق Cursor بتدي شكل الخادم البعيد مباشرةً، بما فيه المصادقة بالهيدر واستبدال متغيرات البيئة، عشان المفتاح نفسه ما يحتاجش يعيش في الملف:

{
  "mcpServers": {
    "namefi": {
      "url": "https://api.namefi.io/mcp",
      "headers": {
        "x-api-key": "${env:NAMEFI_API_KEY}"
      }
    }
  }
}

${env:NAMEFI_API_KEY} بيتحل إلى القيمة اللي متغير البيئة ده بيحملها وقت الاتصال. راجع Namefi MCP Quickstart: Claude Code وCursor وWindsurf للنسخة المختصرة من نفس الإعداد.

Windsurf (Cascade)

تكامل MCP في Windsurf — واسمه Cascade داخل المنتج — بيقرأ قائمة خوادمه من ~/.codeium/windsurf/mcp_config.json. خوادم HTTP البعيدة بتستخدم حقل serverUrl (مش command)، جنب نفس نوع كائن headers واستبدال ${env:VAR} اللي بيستخدمه Cursor:

{
  "mcpServers": {
    "namefi": {
      "serverUrl": "https://api.namefi.io/mcp",
      "headers": {
        "x-api-key": "${env:NAMEFI_API_KEY}"
      }
    }
  }
}

حاجة مهم تتقال بوضوح: وقت نشر الدليل ده، docs.windsurf.com/windsurf/cascade/mcp بيحوّل إلى docs.devin.ai/desktop/cascade/mcp. وثائق Windsurf بقت دلوقتي تحت نطاق وثائق منتج Devin بتاع Cognition، والصفحة نفسها بتشير إلى "Windsurf" و"Cascade" بجانب "Devin Desktop". صيغة الإعداد اللي فوق هي اللي الصفحة الحالية بتوثقها؛ لو عندك إصدار Windsurf أقدم، أسماء الحقول المفروض تطابق، لكن راجع رابط الوثائق اللي مساعدة التطبيق في إصدارك بتشير له.

Gemini CLI

Gemini CLI بيقرأ خوادم MCP من settings.json — نسخة على مستوى المستخدم في ~/.gemini/settings.json، أو نسخة على مستوى المشروع في .gemini/settings.json بتتطبق داخل المشروع ده بس. شكل الخادم البعيد بيستخدم httpUrl بدل url:

{
  "mcpServers": {
    "namefi": {
      "httpUrl": "https://api.namefi.io/mcp",
      "headers": {
        "x-api-key": "YOUR_KEY"
      }
    }
  }
}

وثائق Gemini CLI كمان بتوثق حقل timeout (بالمللي ثانية، والقيمة الافتراضية 600,000) لو استدعاء أداة معيّن محتاج وقت أطول من المعتاد — الاستطلاع بعد التسجيل مش المفروض يحتاجه، لأن العميل بينتظر كل استدعاء منفرد، مش دورة الاستطلاع كلها.

أي وكيل آخر بيدعم MCP

لو وكيلك بيدعم MCP لكنه مش واحد من الستة اللي فوق، فجانب الخادم واحد مهما كان العميل المتصل: وجّهه إلى https://api.namefi.io/mcp عبر Streamable HTTP، مع x-api-key: YOUR_KEY كهيدر مخصص. راجع وثائق عميلك نفسه لصيغة ملف الإعداد أو الأمر الخاص به — واصف الاكتشاف في namefi.io/.well-known/mcp/servers.json موجود تحديداً عشان وكيل (أو الشخص اللي بيضبطه) يقدر يعرف رابط الخادم والنقل ومتطلبات المصادقة من غير إنسان ينسخها له يدوياً.

نمط واحد يستحق تعرفه لو عميلك بيدعم بس خوادم MCP محلية (stdio)، ومش بيدعم HTTP أو SSE البعيدين مباشرةً: حزمة المجتمع mcp-remote بتعمل جسر من Streamable HTTP بعيد لعملية محلية يقدر عميلك يشغّلها بشكل عادي، وبتعيد تمرير أي هيدرات تضبطها. الدليل ده ما يقدرش يتحقق منها مقابل وثائق Namefi نفسها لأنها جسر خارجي مش مسار منشور من Namefi — اعتبرها بديل احتياطي لو عميلك المحدد فعلاً مفيهوش دعم أصلي لـ HTTP البعيد، مش الاختيار الافتراضي.

من غير MCP خالص: مسار REST المباشر

كل عملية اتوصفت فوق هي كمان نقطة HTTPS عادية، موثقة نقطة بنقطة في namefi.io/llms.txt وبالكامل في docs.namefi.io. إطار عمل وكيل يقدر يبعت طلبات HTTP لكنه ما بيتكلمش MCP — سكربت مخصص أو runtime وكيل مختلف أو مهمة CI — يقدر يشغّل نفس المسار مباشرةً:

# 1. Check availability (no auth required)
curl "https://api.namefi.io/v-next/search/availability?domain=example.com"

# 2. Register (requires x-api-key)
curl -X POST "https://api.namefi.io/v-next/orders/register-domain" \
  -H "x-api-key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"normalizedDomainName": "example.com", "durationInYears": 1}'

# 3. Poll the order until it reaches a terminal status
curl "https://api.namefi.io/v-next/orders/{orderId}" \
  -H "x-api-key: YOUR_KEY"

llms.txt هو اصطلاح نص عادي — فهرس مقروء آلياً الموقع بينشره عند الجذر تحديداً عشان وكيل ذكاء اصطناعي يقدر يكتشف الـ API بتعمل إيه من غير ما يزحف في صفحات وثائق معروضة في المتصفح. ملف Namefi قصير كفاية تقرأه مباشرةً في namefi.io/llms.txt لو عايز النسخة الكاملة بدل الملخص المضغوط. راجع llms.txt للدومينات: API يقدر أي وكيل ذكاء اصطناعي يقراها عشان تعرف أكتر عن الاصطلاح نفسه.

الدفع: مفتاح API أم الدفع من المحفظة

كل شيء في الأقسام فوق بيفترض مفتاح API بيتحاسب على رصيد NFSC (Namefi Service Credit) ممول — تقدر تراجعه في أي وقت من GET /v-next/balance (محتاج x-api-key)، وتموله عبر نقطة faucet في بيئات التطوير، أو من لوحة تحكم Namefi في الإنتاج.

Namefi كمان بتدعم تسجيل دومين بمحفظة تشفير من غير أي حساب Namefi إطلاقاً، عبر بروتوكول x402: محفظة الوكيل بتوقّع تفويض EIP-3009، والـ API بترد بـ HTTP 402 فيه السعر لو مفيش دفع مرفق لسه، والتسجيل بيتسوّى أول ما توصل دفعة موقعة صالحة — غالباً بعملة زي العملة المستقرة USDC. فيه كمان نسخة challenge-response مرتبطة بـ MPP (Machine Payable Protocol)، ومسار توقيع EIP-712 يدوي للمحافظ اللي مش بتستخدم أي اختصار من الاتنين. مسار المحفظة أولاً ده مهم بالذات للوكلاء اللي الدليل بيتكلم عنهم: بيشيل خطوة إنشاء الحساب بالكامل، عشان العملية الذاتية ما تضطرش تمسك — أو تسرّب — مفتاح API. راجع ادفع مقابل الدومينات بمحفظة تشفير: من غير حساب للمسار ده وحده.

احتياطات قبل ما تدي الوكيل صلاحية شراء

الوكيل اللي يقدر يسجّل دومين يقدر كمان يصرف فلوس ويعيد كتابة DNS لخاصية شغالة، فكام قرار يستاهل يتاخد بقصد بدل ما يكون افتراضي:

  • قيّد مفتاح API لأصغر محفظة ممكنة. المفتاح بيرث صلاحيات المحفظة اللي أنشأته — أنشئه من المحفظة المقصود تملك التسجيلات الجديدة، مش محفظة فيها أصول مش عايز مفتاح الوكيل يتعرّض لها.
  • حط سقف لصرف الوكيل. رصيد NFSC هو في حد ذاته سقف للصرف: موّله بقدر بس أنت مرتاح إن وكيل يستخدمه من غير متابعة، بدل رصيد كبير دائم.
  • قرّر فين الإنسان يفضل موجود في الحلقة. عمليات القراءة فقط زي البحث عن الإتاحة مش محتاجة مصادقة وما فيهاش مخاطرة؛ أول ما استدعاء يرسل registerDomain، أو يفعّل التجديد التلقائي، أو يكتب سجل DNS على دومين عليه حركة مرور، هنا لازم تطلب تأكيد صريح بدل ما تسيب الوكيل يكمل لوحده.
  • راجع كتابات DNS قبل ما تأكدها، زي ما بتراجع أي تغيير في البنية التحتية. تحقق Namefi بيرفض السجلات المشوّهة بدل ما يقبلها في صمت (شوف جدول استكشاف الأخطاء تحت)، لكن التحقق بيلحق أخطاء الصيغة مش قيمة شكلها صحيح لكنها غلط.

ما هو مُسجِّل الدومينات المصمم للوكلاء؟ بيعرض قائمة تحقق أكمل — قابلية الاكتشاف، وأخطاء مقروءة آلياً، ومسارات دفع ما بتفترضش إن إنسان ماسك بطاقة ائتمان — لتقييم السطح الموجّه للوكلاء لأي مُسجِّل، بما فيها Namefi.

استكشاف الأخطاء وإصلاحها

العَرَضالسبب المحتملالحل
401 UNAUTHORIZED في أي استدعاء كتابةمفتاح API غير صالح أو منتهي أو تم إنشاؤه من محفظة لا تملك الدومين المستهدفأنشئ مفتاحاً جديداً في namefi.io/api-key من المحفظة التي تملك (أو ستملك) الدومين
403 FORBIDDENالمفتاح صالح، لكن محفظته لا تملك هذا الدومين المحددتحقق من الملكية قبل إعادة المحاولة
Codex يتجاهل مدخل [mcp_servers.namefi]خطأ مطبعي في اسم الجدول — Codex يحتاج صيغة الشرطة السفلية mcp_servers، مش mcp-serversأصلح رأس الجدول في config.toml
Cursor أو Windsurf بيعرض الخادم كغير متصلكائن headers مشوّه، أو ${env:VAR} بيشير لمتغير غير مضبوطتحقق إن JSON صالح وإن متغير البيئة المشار له معمول له export فعلاً في الـ shell اللي شغّلت منها المحرر
Gemini CLI مش لاقي الإعدادعدّلت ملف settings.json الغلط — ملفات مستوى المستخدم ومستوى المشروع منفصلةأكّد إذا كنت تقصد ~/.gemini/settings.json أو .gemini/settings.json في المشروع الحالي
طلب التسجيل عالق في حالة غير نهائيةطبيعي — التسجيل غير متزامناستمر في استطلاع getOrder؛ اعتبره عالقاً فقط لو لم يصل أبداً إلى SUCCEEDED أو FAILED أو CANCELLED أو PARTIALLY_COMPLETED
إنشاء/تحديث سجل DNS بيرفضه خطأ تحققzoneName فيه نقطة في آخره، أو قيمة rdata لـ CNAME/MX/NS ناقصها النقطة الختامية المطلوبةzoneName = من غير نقطة أخيرة؛ وrdata من نوع FQDN = بنقطة أخيرة مطلوبة
التسجيل يفشل تماماًرصيد NFSC غير كافٍ في المحفظة اللي بتدفعراجع GET /v-next/balance، وموّل عبر faucet (تطوير) أو لوحة التحكم (إنتاج)
الوكيل بيقول إنه مفيش أدوات دومين متاحةخادم MCP غير متصل، أو متصل من غير الهيدر المطلوب لعمليات الكتابةراجع ملف إعدادات عميلك أو أعد تشغيل أمر «إضافة الخادم» بالهيدر المضمن

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

هل لازم أختار وكيل واحد وألتزم به؟

لا. خادم MCP وكل نقاط REST متطابقة مهما كان العميل المتصل — تقدر تعمل الإعداد لـ Claude Code النهارده وCursor بكرة باستخدام نفس مفتاح API ونفس رصيد NFSC، من غير خطوة ترحيل.

أي من الوكلاء دول هو «الأفضل» لتسجيل دومين؟

مفيش فرق قدرات له معنى في المهمة دي، لأن كل عميل بيستدعي نفس العمليات على جانب الخادم. الفروق كلها في صيغة إعداد MCP الخاصة بكل عميل، وده بالضبط سبب إن الدليل بيدي كل واحد قسم خاص ونفس طلب الاختبار — شغّله مرة لكل عميل وقارن السجلات بنفسك.

ماذا لو كان وكيلي لا يدعم MCP إطلاقاً؟

استخدم مسار REST المباشر فوق. كل عملية بيوصل لها استدعاء أداة MCP هي كمان نقطة HTTPS موثقة، وnamefi.io/llms.txt مصمم تحديداً كنقطة دخول نصية عادية يقدر يقرأها وكيل (أو الشخص اللي بيضبطه) من غير متصفح.

هل الدومين بتاعي بيتحوّل لتوكن تلقائياً لما أسجله بالطريقة دي؟

أيوه، افتراضياً. لو ما حددتش nftReceivingWallet في طلب التسجيل، الدومين بيتسجل كـ NFT للمحفظة المرتبطة بمفتاح API بتاعك، على Base. تقدر توجهه لمحفظة مختلفة وقت التسجيل.

هل وكيل يقدر يسجل دومين من غير ما أحتفظ بمفتاح API أصلاً؟

أيوه — مسار الدفع x402 الموقّع بالمحفظة مش محتاج حساب Namefi ولا مفتاح API، بس محتاج محفظة ممولة. قسم الدفع فوق بيغطي أساسيات المسار؛ راجع ادفع مقابل الدومينات بمحفظة تشفير: من غير حساب للشرح الكامل.

هل التسجيل من خلال وكيل أغلى من التسجيل من موقع Namefi؟

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

ابدأ بالوكيل اللي فاتحه بالفعل

مش محتاج تثبّت ستة عملاء عشان تستخدم الدليل ده — محتاج واحد بس، بالإضافة لمفتاح API لـ Namefi أو محفظة ممولة. اختار القسم فوق اللي يطابق الوكيل اللي بتتكلم معاه بالفعل، نفّذ الإعداد، وجرّب طلب الاختبار. من هنا، باقي مسار الصفحة — البحث والتسجيل وضبط DNS — بيحصل في نفس المحادثة.

أنشئ مفتاح API لـ Namefi أو اتعمق أكثر مع شرح Claude بسجل كامل والمقارنة المباشرة بين مُسجِّلات الدومينات المصممة للوكلاء. وللمكوّنات اللي تحت الدليل ده، راجع خادم Namefi MCP: أدوات دومين لوكلاء الذكاء الاصطناعي، وNamefi MCP Quickstart: Claude Code وCursor وWindsurf، وادفع مقابل الدومينات بمحفظة تشفير: من غير حساب، وllms.txt للدومينات: API يقدر أي وكيل ذكاء اصطناعي يقراها.

المصادر وقراءات إضافية

المساهمون

Fenwei Bian
Fenwei Bianالكاتب/الكاتبة
مطورة برمجيات وكاتبة • Namefi

Fenwei Bian مطورة برمجيات في الثلاثينات، بتقضي ساعات شغلها وسط طلبات السحب، وفي نهاية الأسبوع بتكون إيديها في التراب أو نشارة الخشب. سنين من الشغل في مشروعات المصدر المفتوح على GitHub علمتها إن الأسماء هي واجهات: الاسم الكويس واضح، وصريح بخصوص وظيفته، ومراعي للشخص اللي هيستخدمه بعد كده.

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

في Namefi، بتكتب عن إزاي أسواق الدومينات بتتحرك على أرض الواقع، والمفاضلات العملية في تحويل الأسماء لتوكنات وإعادة بيعها، واختيار دومين تفضل مبسوط إنك مالكه بعد عشرين سنة.

Victor Zhou
Victor Zhouالمحرّر/المحرّرة
مؤسس ومحرر معايير • Namefi

Victor Zhou مؤسس في مجال التكنولوجيا ومحرر معايير، وبيركز على الهوية الرقمية والثقة. أسس Namefi، وبيحرر مقترحات تحسين Ethereum، وقبل كده قاد شغل هندسة معمارية للعقود الذكية في Google Labs.

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

في Namefi، Victor بيحرر وبيكتب عن الدومينات كهوية رقمية طويلة الأمد: إزاي الأسماء تتحول لأصول onchain قابلة للتملك، وإزاي تحويلها لتوكنات بيغير طريقة حيازة الأصول والثقة، وإيه اللي مجال التسمية ممكن يتعلمه من الأنظمة اللي الناس بتستخدمها علشان تثبت هويتها على الإنترنت.

Zakia al-Sina'i
Zakia al-Sina'iالمترجم/المترجمة
مترجمة ومختصة بتوطين المحتوى للعربية • Namefi

Zakia al-Sina'i (زكية الصناعي) مترجمة ومتخصصة في التوطين في أواخر العشرينات ومقيمة في القاهرة. درست هندسة كهربائية في جامعة عين شمس، وبعدها لقيت إن كتابة ترجمة مصاحبة لمحاضرات تقنية لصحابها اتحولت من غير ما تحس لمسار مهني بتنقل فيه النصوص التقنية بين الإنجليزية والعربية.

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

في Namefi، بتوطن للعربية مقالات عن أسماء الدومينات والهوية الرقمية، وبتنقل فيها مش بس الكلمات، لكن كمان السمعة والتلاعبات اللفظية والثقل الثقافي اللي الأسماء بتكتسبه في الطريق.

أدلة ذات صلة

ناقش هذا المقال

عرض النقاش على Namefi Discuss