انتقل إلى المحتوى
NanoFlags
ابدأ مجانًا

الأدوات

وكلاء الذكاء الاصطناعي (MCP)

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

الوكيل يقترح والإنسان يعتمد

يعمل الوكيل برمز وكيل ذكاء اصطناعي: رمز لواجهة الإدارة بصلاحيات ثابتة وضيقة واسم تختاره، مثل Claude Code on laptop-x. وككل رموز API يعمل باسم من أنشأه وبدوره الحالي. وفوق ذلك ترفض NanoFlags كل ما عدا الاقتراح، وتفعل ذلك في قاعدة بياناتها تحت مستوى الواجهة: لا توجد نقطة نهاية، قديمة أو جديدة، تستطيع النشر أو الاعتماد أو تغيير الإعدادات لصالح وكيل.

ما يستطيعه الوكيل وما لا يستطيعه

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

يُجاب الطلب المرفوض بالرمز 403 ورمز الخطأ AGENT_FORBIDDEN ورسالة تطلب من الوكيل فتح طلب تغيير بدلًا من ذلك.

قاعدة الاعتماد

  • أي عمل يقترحه وكيل يحتاج دائمًا إلى اعتماد مستقل من شخص قبل نشره، حتى في البيئات التي لا تشترط الاعتماد. يشمل ذلك التغيير الذي فتحه وكيل، وأي مسودة فيها تعديلات أجراها وكيل منذ آخر نشر للبيئة.
  • إن كانت البيئة تشترط عددًا أكبر من المعتمِدين فهو المطبَّق؛ وإلا يكفي اعتماد واحد.
  • تنطبق قواعد الاستقلال المعتادة: لا يعتمد التغييرَ كاتبُه ولا من عدّل مسودته. والوكيل يعمل باسم مالك الرمز، لذا لا يستطيع مالك رمز الوكيل أبدًا اعتماد عمل ذلك الوكيل. يجب أن يعتمده مالك أو مسؤول آخر.
  • يبقى النشر فعلًا يقوم به شخص، من لوحة التحكم أو برمز API عادي.
مثال
يفعّل وكيلٌ العلم checkout-v2 لعملاء الباقة الاحترافية في مسودة Staging ويفتح تغييرًا. لا تشترط Staging الاعتماد، لكن النشر الآن يحتاج إلى تغيير يعتمده شخص غير مالك الرمز. تعتمده مايا، وينشره عمر.

إنشاء رمز وكيل

  1. بصفتك مالكًا أو مسؤولًا، افتح الإعدادات ← رموز API. قسم وكلاء الذكاء الاصطناعي في الأعلى.
  2. سمِّ الوكيل. يظهر الاسم على كل تغيير وكل سطر تدقيق يصنعه.
  3. احصره في المشروع الذي يعمل عليه (موصى به) واختر مدة صلاحية 7 أو 30 أو 90 يومًا.
  4. انسخ الرمز. يُعرض مرة واحدة ولا تخزّن NanoFlags إلا بصمته. يمكنك إلغاؤه من المكان نفسه في أي وقت.

ربط الوكيل

يعمل خادم MCP على جهاز المطوّر (Node 20 أو أحدث) ويقرأ NANOFLAGS_API_TOKEN، واختياريًا NANOFLAGS_PROJECT (مفتاح المشروع الافتراضي) وNANOFLAGS_BASE_URL.

Claude Code:

sh
claude mcp add nanoflags --env NANOFLAGS_API_TOKEN=nf_api_… --env NANOFLAGS_PROJECT=commerce -- npx -y @nanoflags/mcp

Cursor: أضف الخادم إلى ~/.cursor/mcp.json أو إلى .cursor/mcp.json في المشروع. وتقبل عملاء MCP الأخرى الكتلة نفسها.

json
{
  "mcpServers": {
    "nanoflags": {
      "command": "npx",
      "args": ["-y", "@nanoflags/mcp"],
      "env": { "NANOFLAGS_API_TOKEN": "nf_api_…", "NANOFLAGS_PROJECT": "commerce" }
    }
  }
}

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

الأدوات

الأداةما تفعله
list_environmentsبيئات المشروع وسياسة النشر في كل منها.
list_flagsأعلام المشروع، على صفحات.
get_flagتعريف العلم ومسودته في كل بيئة.
explain_flagما هو العلم، وحالته المنشورة والمسودة في كل مكان، وأين يُقيَّم: الخدمات وحزم SDK والقيم المقدَّمة من رؤى الاستخدام.
create_flagإنشاء علم. يبدأ متوقفًا في كل المسودات.
update_draftتعديل مسودة بيئة واحدة: التشغيل والإيقاف وقواعد الاستهداف والقيمة الافتراضية وقيمة الإيقاف.
open_change_requestفتح تغيير للأعلام المعدّلة وإرساله للمراجعة.
get_change_statusحالة التغيير واعتماداته.

لا توجد أداة للنشر أو الاعتماد أو الإيقاف، وذلك عن قصد.

التدقيق والهوية

  • كل سطر تدقيق يُكتب برمز وكيل يحمل detail.actor_type = "agent" وdetail.agent_label، إلى جانب detail.via = "api_token" ومعرّف الرمز. ويبقى الفاعل هو مالك الرمز: هناك دائمًا شخص مسؤول.
  • يعرض سجل النشاط وقائمة التغييرات وصفحة كل تغيير عبارة عبر الوكيل <الاسم>.
  • يحتفظ التغيير الذي فتحه وكيل بهذه الحقيقة دائمًا، حتى بعد إلغاء الرمز.

الباقات

رموز الوكلاء متاحة في كل الباقات، ولا يستطيع الوكيل النشر أو الاعتماد أو تغيير السياسات في أي باقة. أما الاعتماد المستقل الإلزامي لعمل الوكلاء فهو جزء من الاعتمادات المطلوبة، وهي من مزايا Team (وScale وEnterprise). في Explore وSolo يراجع شخصٌ مسودة الوكيل أو تغييره وينشره، وتوضّح لوحة التحكم ذلك بجانب التغيير. راجع الخطط والحدود.

واجهة الإدارة

خادم MCP غلاف رقيق فوق واجهة الإدارة؛ ويمكن للوكلاء والسكربتات استخدام الواجهة مباشرة بالرمز نفسه. يجيب GET /api/v1/token بـ kind: "agent" وagentLabel، وتحمل التغييرات التي فتحها وكيل الحقل openedByAgent.