ربط وكيل برمجة

Pommy خادم MCP. الوكيل الذي تبرمج به أصلًا — Claude Code أو Codex أو Cursor أو VS Code، أو أي عميل يدعم streamable HTTP وOAuth — يستطيع الاتصال به، ومن ثم يستطيع قراءة إعداد Pommy الخاص بك وتغييره نيابة عنك: التحقق مما ينقص المشروع، وجلب كود تثبيت الويدجت ولصقه في الموقع الذي يعمل عليه بالفعل، وإضافة مستند إلى قاعدة المعرفة، وإعادة كتابة تعليمات المساعد.

تُعدّ هذا من صفحة Coding Agents (وكلاء البرمجة) في القائمة اليسرى. إنها صفحة للمطورين، ولا يعتمد عليها أي شيء آخر في Pommy — إذا لم تكن تفتح الطرفية أبدًا، فتجاوز هذا القسم كليًا.

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

يقدّم الاتصال مجموعة ثابتة من الأدوات. لا يمكن استدعاء أي شيء خارج هذه القائمة، أيًا كان ما يطلبه الوكيل. الأدوات المعلّمة بـ نعم تغيّر إعدادك؛ ولا تُعرض إلا إذا منحت صلاحية إجراء التغييرات، ومن دونها لا يراها الوكيل أصلًا.

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

الربط#

1. افتح Coding Agents واختر وكيلك

   التبويبات أعلى بطاقة Connect — Claude Code وCodex وCursor وVS Code وOther — يعرض كل منها الأمر أو الملف الدقيق لذلك العميل. انسخه من الصفحة؛ فالعنوان معبّأ مسبقًا.

2. شغّل الأمر، أو احفظ الملف

   يستخدم Claude Code وCodex أمرًا من سطر واحد في الطرفية. أما Cursor وVS Code فيقرآن ملف JSON صغيرًا — تُظهر الصفحة أي ملف ومساره.

3. سجّل الدخول

   يفتح وكيلك المتصفح وتسجّل الدخول إلى Pommy بحسابك. في Claude Code يبدأ تسجيل الدخول بالأمر /mcp؛ وفي Codex بـ codex mcp login pommy؛ أما Cursor وVS Code فيفتحان المتصفح من تلقاء نفسيهما.

4. اختر المشاريع التي يستطيع الوصول إليها

   يعرض المتصفح شاشة موافقة Pommy. اختر المشاريع، ووافق، فيصبح الوكيل متصلًا.

claude mcp add --transport http pommy https://api.pommy.ai/mcp

codex mcp add pommy --url https://api.pommy.ai/mcp

{
  "mcpServers": {
    "pommy": {
      "url": "https://api.pommy.ai/mcp"
    }
  }
}

{
  "servers": {
    "pommy": {
      "type": "http",
      "url": "https://api.pommy.ai/mcp"
    }
  }
}

أي عميل آخر يعمل أيضًا: وجّهه إلى العنوان نفسه، https://api.pommy.ai/mcp. إنها نقطة streamable HTTP محمية بـ OAuth، ويكتشف العميل كل شيء آخر — أي خادم تفويض يستخدم، وأي صلاحيات موجودة — بنفسه.

شاشة الموافقة#

خطوة المتصفح هي حيث تُمنح الصلاحية فعلًا، لذا تسأل عن أمرين معًا: ما الذي سيُسمح لهذا التطبيق بفعله، وأين.

• أي تطبيق يطلب — الاسم الذي سُجّل به، ويظهر في الأعلى. التطبيق الذي لا يتعرف عليه Pommy لا تظهر له هذه الشاشة أبدًا.
• ما الذي سيُسمح له بفعله — سطر واحد لكل صلاحية طلبها: قراءة مشاريعك، وإجراء تغييرات فيها، ومعرفة هويتك. اقرأ سطر التغييرات بعناية؛ فهو الأهم.
• أي المشاريع — كل مشروع تستطيع الوصول إليه، مجمّعًا حسب المؤسسة. إذا تجاوزت المشاريع ستة، تظهر خانة بحث. ولا يمكن الموافقة دون تحديد مشروع واحد على الأقل.

تحديد مشروع لا يمنح شيئًا؛ بل يضيّق ما يستطيع الوكيل لمسه. أنت لا توزّع صلاحيات هنا، بل تختار أي جزء من صلاحياتك تُعيره.

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

الصلاحيات والأمان#

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

عرض الاتصالات وإبطالها#

بطاقة Connected على يمين صفحة Coding Agents تعرض كل وكيل فوّضته: الاسم الذي سجّله العميل، وعدد المشاريع التي يصل إليها، وتاريخ منحك الصلاحية.

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

عندما لا يعمل شيء ما#