استخدام عنواني مع الوكلاء

الوكلاء

عنواني منصة للعناوين الرقمية تمنح المواقع الفعلية أكواد عناوين دائمة من 9 أرقام. يمكن للوكلاء الذكيين إنشاء هذه العناوين وإدارتها عبر تكاملات مصرّح بها.

عنواني ليس وكيلاً ذكياً بحد ذاته؛ إنه طبقة عناوين يستطيع الوكلاء استخدامها.

استخدم عنواني من الوكلاء المدعومين — بدون تطبيق. نفس الحساب، ونفس العناوين، ونفس الحصة.

عنواني طبقة عناوين واحدة، تصل إليها من التطبيق والموقع وتيليغرام والوكلاء الذكيين.

يمكن للمطوّرين ربط وكلاء آخرين عبر بوابة عنواني.

وكلاء يدعمون عنواني

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

كيف يعمل

الوكيل قناة فوق عنواني — ليس بديلاً عن خدمة العناوين.

  1. طلب من الوكيل تطلب إنشاء عنوان أو تعديله داخل الوكيل المعتمد.
  2. موافقة في المتصفح يفتح رابط الموافقة. تسجّل بغوغل، تظهر لك الصلاحيات المطلوبة، ثم تضغط سماح أو رفض.
  3. توكن محدود يحصل الوكيل على توكن وصول مربوط بتفويضك — بلا وصول مباشر لقاعدة البيانات.
  4. تنفيذ عبر خدمة العناوين نفس خدمة العناوين وقواعد الملكية والحصة والأمان المستخدمة في جميع القنوات.

ماذا يعني ذلك لك

ما يمكن للوكيل فعله

  • إنشاء عنوان ضمن حصتك
  • عرض عناوينك فقط
  • تعديل حقول مثل التعليمات والاسم
  • مشاركة رابط الكود
  • حذف عنوان تملكه — إن ظهرت صلاحية الحذف ووافقت عليها

ما لا يمكنه فعله

  • استكشاف عناوين مستخدمين آخرين
  • تجاوز حد العناوين العشرة
  • تغيير إحداثيات عنوان بعد إنشائه عبر الترقيع
  • العمل بلا موافقتك أو بعد إلغاء التفويض
  • صلاحيات أوسع من باقي قنوات عنواني

العناوين التي ينشئها الوكيل تظهر فوراً في التطبيق وتيليغرام — والعكس صحيح.

طريقة الاتصال

خلفية واحدة لكل العملاء. تختلف فقط خطوات الإعداد القصيرة لكل وكيل.

كيرسر متاح الآن

الجسر عميل اتصال فقط، وليس جزءاً من منطق عنواني، ولا يحتاج فتح مستودع عنواني داخل المحادثة.

  1. ثبّت جسر الأدوات بأمر واحد، ثم سجّل الدخول.
  2. شغّل تسجيل الدخول من الطرفية — يفتح المتصفح تلقائياً.
  3. أكمل غوغل واضغط سماح؛ يعود المتصفح للجهاز ويُحفظ الاتصال بلا لصق.
  4. أضف خادم الأدوات في إعدادات كرسر بمسار مطلق على جهازك.
  5. في محادثة جديدة بلا مستودع عنواني: اطلب إنشاء عنوان عبر أدوات عنواني فقط.
Clone
npm install -g anwani-mcp
anwani-mcp-login
مثال إعداد خادم الأدوات
{
  "mcpServers": {
    "anwani": {
      "command": "npx",
      "args": ["-y", "anwani-mcp"]
    }
  }
}

لا تلصق رموز التفويض أو التوكن في المحادثة — مسار الاتصال الافتراضي لا يحتاج لصقاً.

شات جي بي تي قريباً

غير متاح للجميع بعد. هذه خطوات تحضيرية للموصّل البعيد عندما يُفتح المسار العام — ليس تكاملاً جاهزاً لكل مستخدمي شات جي بي تي الآن.

  1. أضف موصّلاً مخصصاً بعنوان المحوّل البعيد أدناه.
  2. في أوث المتقدم: معرّف العميل
المحوّل البعيد
https://us-central1-nine-code-anwani.cloudfunctions.net/mcpRemote
معرّف العميل
chatgpt

اترك السر فارغاً — العميل عام ويعتمد تحدّي التحقّق فقط.

كلود قريباً

غير متاح للجميع بعد. خطوات تحضيرية للموصّل البعيد عند الإطلاق العام — ليس تكاملاً جاهزاً لكل مستخدمي كلود الآن.

  1. أضف موصّلاً مخصصاً بعنوان المحوّل البعيد.
  2. اختر عميلاً أوث خاصاً بك، والمعرّف:
معرّف العميل
claude

اترك السر فارغاً. بعد السماح في المتصفح يعود كلود بالموصّل متصلاً.

للمطورين محوّل / أوث

وثّق عميلك، اطلب صلاحيات من الكتالوج، نفّذ تحدي التحقّق، ثم استدعِ المحوّل. التفاصيل في القسم التالي.

انتقل لتوثيق المطوّر

الصلاحيات

تظهر لك الصلاحيات المطلوبة عند الموافقة. المدة الافتراضية ٣٠ يوماً، ويمكن إبطالها.

المعرّف المعنى
address:read عرض عناوينك
address:create إنشاء عنوان جديد
address:update تعديل عناوينك
address:share مشاركة كود العنوان
address:delete حذف عنوان

حل الكود العام لعناوين الغير غير متاح عبر الوكيل عمداً.

للمطوّرين

خلفية واحدة: موافقة + رمز + توكن وصول فوق التفويض + محوّل فوق خدمة العناوين.

تدفق الموافقة

  1. افتح صفحة الموافقة مع رمز تحدّي والتحقّق من الطرفين.
  2. المستخدم يراجع الصلاحيات المعروضة ثم يوافق أو يرفض بعد تسجيل غوغل.
  3. بدّل الكود بتوكن عبر نقطة التوكن مع المتحقّق.
  4. استدعِ المحوّل بترويسة الحامل.
الموافقة https://9code.app/authorize?… (معاملات كاملة من الجسر)
الرجوع https://9code.app/oauth/callback
التوكن https://us-central1-nine-code-anwani.cloudfunctions.net/oauthToken
المحوّل https://us-central1-nine-code-anwani.cloudfunctions.net/mcpApi
المحوّل البعيد https://us-central1-nine-code-anwani.cloudfunctions.net/mcpRemote
ميتاداتا خادم التفويض https://9code.app/.well-known/oauth-authorization-server
ميتاداتا المورد المحمي https://9code.app/.well-known/oauth-protected-resource

المحوّل للجسر المحلي؛ المحوّل البعيد لبروتوكول الأدوات عبر الشبكة للوكلاء المستضافين.

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

قواعد ثابتة

مثال جلسة
{ "action": "session" }
مثال إنشاء
{
  "action": "tools/call",
  "name": "create_address",
  "arguments": {
    "idempotency_key": "job-42",
    "latitude": 33.5138,
    "longitude": 36.2765,
    "ownerName": "أحمد",
    "instructions": "الجرس الثاني",
    "city": "دمشق",
    "country": "سوريا"
  }
}

الأمان والحدود

الحصة المشتركة

حتى ١٠ عناوين للحساب العادي — مشتركة بين كل القنوات. لا حصة منفصلة لكل وكيل.

عدم التكرار

إعادة المحاولة بنفس المفتاح تستأنف نفس الكود ولا تنشئ عنواناً ثانياً.

حد المعدّل

حد على التحقق ومسارات الموافقة والتوكن قبل قراءة قاعدة البيانات.

الإبطال

إعادة السماح لنفس العميل تُبطِل التوكنات السابقة. التفويض الملغى يُرفض فوراً.

أسئلة شائعة

هل أحتاج تطبيق عنواني؟

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

هل يرى الوكيل بريدي أو كلمة المرور؟

لا. غوغل يثبت هويتك أثناء الموافقة، والوكيل يحصل على توكن محدود الصلاحيات؛ لا يحصل على كلمة مرور غوغل أو وصول إلى بريدك.

ماذا لو وصلت لحد العناوين؟

يُرفض الإنشاء بنفس سياسة خدمة العناوين. احذف عنواناً قديماً ثم أعد المحاولة.

كيف أتأكد أن الاتصال آمن؟

افتح رابط الموافقة من عنواني فقط، راجع قائمة الصلاحيات المعروضة، ولا تلصق رموز التفويض أو التوكنات داخل المحادثة.

كيف ألغي الإذن؟

أعد تدفق الموافقة لإبطال التوكنات السابقة، أو راسل الدعم لإلغاء التفويض.

جاهز للتجربة؟

ابدأ بكيرسر كأول عميل، أو حمّل التطبيق لإدارة عناوينك يدوياً.

الدعم: support@9code.app