وكلاء عنواني

كيف يعمل التفويض

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

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

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

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

الصلاحيات

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

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

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

ما يعرضه الوكيل بعد الاتصال الناجح.

• session حالة الاتصال والصلاحيات — بلا معرّفات داخلية.
• list_addresses قائمة عناوينك فقط.
• create_address إنشاء عنوان — يتطلب مفتاح عدم تكرار.
• patch_address تعديل حقول محددة دون مسح الباقي.
• share_address رابط المشاركة العام للكود.
• delete_address حذف عنوان تملكه.

البدء مع كيرسر

كيرسر هو العميل الأول المعتمد. اتبع الخطوات مرة واحدة.

1. ثبّت جسر الأدوات من مستودع عنواني (مجلد أدوات كرسر).
2. شغّل تسجيل الدخول من الطرفية ليُفتح رابط الموافقة.
3. أكمل غوغل واضغط سماح، ثم الصق JSON من صفحة الرجوع.
4. أضف خادم الأدوات في إعدادات كرسر من ملف المثال.
5. في محادثة جديدة: اطلب إنشاء عنوان عبر أدوات عنواني فقط.

node tools/anwani-cursor-mcp/login.mjs

{
  "mcpServers": {
    "anwani": {
      "command": "node",
      "args": [
        "/absolute/path/to/anwani-cursor-mcp/server.mjs"
      ]
    }
  }
}

اختبر في محادثة بلا فتح مستودع عنواني كسياق — حتى يعتمد الوكيل على الأدوات فقط.

للمطوّرين وتكامل الوكلاء

المسار العام: موافقة + رمز + توكن وصول فوق التفويض.

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

1. افتح صفحة الموافقة مع رمز تحدّي والتحقّق من الطرفين.
2. المستخدم يوافق بعد تسجيل غوغل.
3. بدّل الكود بتوكن عبر نقطة التوكن مع المتحقّق.
4. استدعِ المحوّل بترويسة الحامل.

قواعد ثابتة

• العميل مسجّل مسبقاً — لا معرّف حر.
• تحدّي التحقّق إلزامي بطريقة التجزئة الآمنة فقط.
• الإنشاء بلا مفتاح عدم تكرار مرفوض.
• إعادة استخدام تفويض صالح لنفس المستخدم والعميل والصلاحيات.
• عند إعادة الإصدار تُبطَل توكنات نفس المستخدم والعميل السابقة.
• التوكن القديم الداخلي للتطوير مرفوض على المحوّل العام.

{ "action": "session" }

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

شات جي بي تي وعملاء إضافيون لاحقاً — بعد استقرار كيرسر والمراجعة الأمنية.

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

أسئلة شائعة عن الوكلاء