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

> وكلاء البرمجة · دع الوكيل الذي تبرمج به أصلًا يقرأ إعداد Pommy الخاص بك ويغيّره.

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

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

> **قاعدة:** اتجاهان لـ MCP يسهل الخلط بينهما: **هذه الصفحة** تتناول Pommy بوصفه خادم MCP، ليستطيع وكيل البرمجة الخاص بك استخدام Pommy — أما [الأدوات الخارجية (MCP)](/docs/ai-assistant/external-tools-mcp) في قسم مساعد الذكاء الاصطناعي فهي الاتجاه المعاكس، حيث يستخدم مساعد الدعم خادم MCP لجهة أخرى.

![صفحة Coding Agents: تبويبات العملاء مع أمر الربط على اليسار، وعنوان النقطة، وملخّص الصلاحيات، وبطاقة Connected على اليمين](/docs/docs-coding-agents.png)

*صفحة Coding Agents — اختر وكيلك، وانسخ أمره، وشاهد على اليمين ما منحته بالفعل.*

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

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

| الأداة | ماذا تفعل | تُغيّر؟ |
| --- | --- | --- |
| `pommy_list_projects` | المشاريع التي يستطيع هذا الاتصال الوصول إليها، وبأي Pommy هو متصل — بيئة التطوير أو البيئة الفعلية، مع العنوان. تحتاج الأدوات الأخرى إلى معرّف مشروع؛ ومن هنا يأتي. | لا |
| `pommy_project_status` | حالة إعداد مشروع واحد — المساعد، وقاعدة المعرفة، والويدجت، والقنوات، والتحقق من النطاق، والرحلات — والخطوة التالية الوحيدة الواجب اتخاذها. | لا |
| `pommy_how_to` | كيف تُنجز مهمة ما في Pommy، مع الإجابة في ضوء الحالة الحالية لمشروعك لا بشكل عام. | لا |
| `pommy_search_docs` | تبحث في هذه الوثائق، ليجيب الوكيل مما يفعله Pommy فعلًا بدلًا من التخمين. | لا |
| `pommy_get_agent` | مساعدو الذكاء الاصطناعي في المشروع وتعليماتهم الكاملة. | لا |
| `pommy_list_agents` | المساعدون بصيغة مختصرة: النشط، والافتراضي، وtemperature، وحد الرموز. | لا |
| `pommy_create_agent` | تنشئ مساعدًا. من دونه لا يجيب أحد زوارك. | **نعم** |
| `pommy_update_agent` | الاسم، والتعليمات، والتحية، وtemperature، وإعدادات التحويل، وحقول الشخصية (اسم العرض، والشركة، والنبرة، وطول الرد). | **نعم** |
| `pommy_update_agent_instructions` | تستبدل تعليمات المساعد بنص جديد. | **نعم** |
| `pommy_list_widgets` | ويدجتات المشروع: الاسم، وأيها يراه الزوار على موقعك، ولون العلامة التجارية، ورسالة الترحيب. | لا |
| `pommy_get_widget` | كل إعدادات ويدجت واحد — الألوان، وزر الفتح، والنصوص، والسلوك. | لا |
| `pommy_get_widget_embed_code` | مقتطف `<script>` الذي يضع ويدجت الدردشة الخاص بالمشروع على موقع. | لا |
| `pommy_update_widget` | تغيّر إعدادات الويدجت: المظهر، وزر الفتح، والسلوك، ونصوص الترحيب والعلامة التجارية، والنصوص لكل لغة. ومع `publish` تجعله الويدجت الذي يعرضه موقعك، أو تُخفيه. | **نعم** |
| `pommy_create_widget` | تنشئ ويدجت دردشة، مع إعداداته الأولى اختياريًا. إذا كان موقعك يعرض ويدجت بالفعل، يبدأ الجديد متوقفًا حتى تنشره. | **نعم** |
| `pommy_delete_widget` | تحذف ويدجت. وترفض حذف الويدجت الذي يعرضه موقعك. | **نعم** |
| `pommy_list_documents` | مستندات قاعدة المعرفة التي يستطيع المساعد البحث فيها، ومصدر كل منها، وهل فُهرست بعد — بالتحقق من فهرس البحث لا بالتخمين. مقسّمة إلى صفحات، مع عدد المستندات القابلة للبحث في البداية. | لا |
| `pommy_add_document` | تضيف مستندًا نصيًا. أعطها عنوان الصفحة، فيحدّث الاستدعاء الثاني بالعنوان نفسه ذلك المستند بدلًا من إضافة نسخة. | **نعم** |
| `pommy_update_document` | تعيد كتابة عنوان المستند ومحتواه. | **نعم** |
| `pommy_delete_document` | تحذف مستندًا. لا يمكن التراجع. | **نعم** |
| `pommy_scrape_url` | تقرأ صفحة ويب أو ملف Markdown وتحفظه مع عنوانه، ليستطيع المساعد الربط إليه. قراءة العنوان نفسه مجددًا تحدّث المستند — دون نسخ. | **نعم** |
| `pommy_import_urls` | تستورد حتى 20 صفحة أو ملف Markdown في استدعاء واحد. آمنة للتكرار بالقائمة نفسها: تُبقي مركز المساعدة أو موقع الوثائق متزامنًا بدلًا من تكراره. | **نعم** |
| `pommy_list_faqs` | أزواج الأسئلة والأجوبة التي يطابق المساعد بها. | لا |
| `pommy_upsert_faq` | تضيف سؤالًا شائعًا أو تعدّل سؤالًا موجودًا. | **نعم** |
| `pommy_delete_faq` | تحذف سؤالًا شائعًا. | **نعم** |
| `pommy_list_products` | منتجات وخدمات واجهة العرض التي تظهر كبطاقات في الدردشة. | لا |
| `pommy_upsert_product` | تضيف بطاقة إلى واجهة العرض أو تعدّلها. | **نعم** |
| `pommy_delete_product` | تحذف بطاقة من واجهة العرض. | **نعم** |
| `pommy_list_conversations` | المحادثات الأخيرة: القناة، والحالة، والتوقيت. للقراءة فقط. | لا |
| `pommy_get_conversation` | رسائل محادثة واحدة، بالترتيب — الطريقة الصادقة الوحيدة لمعرفة سبب خطأ إجابة ما. | لا |
| `pommy_list_journeys` | الرحلات وهل الميزة مفعّلة لهذا المشروع؛ وإن كانت متوقفة، فما الناقص. | لا |
| `pommy_draft_journey` | تكتب **مسودة** رحلة. لا تنشر أبدًا، وترفض لمس رحلة منشورة — فالنشر يبقى قرارًا بشريًا. | **نعم** |
| `pommy_list_integrations` | القنوات المربوطة بالمشروع (WhatsApp، Instagram، Telegram، Shopify، ikas، WooCommerce، Google Calendar) وحالتها. | لا |
| `pommy_usage` | الخطة واستهلاك الحصة — ما تبقّى قبل أن يرفض حدٌّ ما عملية الكتابة التالية. | لا |
| `pommy_domain_status` | هل التحقق من النطاق مفروض، وأي العناوين مُتحقَّق منها. أول مكان تبحث فيه عندما لا يظهر الويدجت. | لا |
| `pommy_add_domain` | تضيف نطاقًا وتعيد بالضبط ما يثبت ملكيتك له: وسم meta، أو ملف، أو سجل DNS. والوكيل الذي يعدّل موقعك يستطيع إكمال طريقة وسم meta بنفسه. | **نعم** |
| `pommy_verify_domain` | تتحقق من الإثبات. ومع `enforce` تقفل الويدجت أيضًا على النطاقات المُتحقَّق منها — فقط عندما تطلب ذلك. | **نعم** |

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

## الربط

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 Code

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

Codex

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

Cursor — ~/.cursor/mcp.json

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

VS Code — .vscode/mcp.json

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

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

> **تنبيه:** انسخ العنوان من صفحة **Coding Agents** لا من هنا. لبيئة التطوير عنوان مختلف، والوكيل الموجّه إلى البيئة الخاطئة يتصل بلا مشكلة لكنه لا يرى مشاريعك الفعلية أبدًا.

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

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

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

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

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

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

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

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

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

![بطاقة Connected تعرض عميلًا مفوَّضًا مع عدد مشاريعه وتاريخ المنح، وبجانبه زر Revoke](/docs/docs-coding-agents-connected.png)

*يمكن سحب كل اتصال من هنا — المكان نفسه الذي يُظهر ما يصل إليه.*

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

> **نصيحة:** الإبطال أيضًا طريقة نظيفة لتغيير قائمة المشاريع — مع أن إعادة الاتصال من العميل تكفي وحدها، لأن شاشة الموافقة تظهر في كل مرة.

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

### يسأل الوكيل عن المشروع الذي يجب أن يستخدمه.

الاتصال مفوَّض لأكثر من مشروع، لذا تحتاج الأداة إلى معرّف مشروع. اطلب من الوكيل أن يعرض مشاريعك أولًا — لديه أداة لذلك تحديدًا. والاتصال المفوَّض لمشروع واحد لا يسأل أبدًا.

### يستطيع الوكيل قراءة كل شيء لكنه لا يستطيع تغيير أي شيء.

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

### يرى الوكيل الأدوات، لكن كل استدعاء يقول إنه لا يصل إلى أي مشروع.

أُبطلت الصلاحية، أو فقدت الوصول إلى المشاريع التي مُنحت له. ابدأ الاتصال مجددًا من عميلك واختر المشاريع في شاشة الموافقة.

### يقول المتصفح إن التطبيق غير معروف.

طلب التفويض هذا لا يخص تطبيقًا يعرفه Pommy، لذا يتوقف هناك عن قصد. لا تحاول المتابعة من تلك الصفحة — ابدأ الاتصال من عميلك مجددًا.

### صفحة تسجيل الدخول تعود إلى نفسها، أو تقول إنه تعذّر إكمال الاتصال.

جلستك غير معروفة على ذلك العنوان. سجّل الدخول إلى لوحة التحكم في المتصفح نفسه أولًا، ثم أعد بدء الاتصال من عميلك.

### تقول شاشة الموافقة إنه لا يوجد مشروع لمنحه.

حسابك لا يصل إلى أي مشروع بعد. أنشئ مشروعًا (أو اطلب إضافتك إلى مشروع) وابدأ الاتصال مجددًا.

### أضاف الوكيل مستندًا لكن المساعد لا يستخدمه بعد.

يستغرق المحتوى الجديد بضع دقائق ليصبح قابلًا للبحث، تمامًا كما عند إضافته من اللوحة. وأداة عرض المستندات تُظهر هل فُهرس بعد.

### أعاد الوكيل كتابة تعليمات المساعد لكن محادثة ما زالت تتصرف بالطريقة القديمة.

التعليمات الجديدة تُطبَّق على المحادثات التي تبدأ بعدها؛ والمحادثة الجارية بالفعل تنتهي بالتعليمات التي بدأت بها.

---

اقرأ هذه الصفحة على الموقع: [ربط وكيل برمجة](/ar/docs/coding-agents/connect-your-agent)
