---
title: "أنشئ باستخدام Claude Code أو Codex أو Cursor"
description: "ثبّت مهارات وكيل ThunderPhone، وصِل بخادم ThunderPhone MCP، وزوّد وكيل البرمجة بوثائق المنتج الحالية."
---

يوفر ThunderPhone ثلاث طبقات للوكلاء البرمجيين:

| الطبقة | ما تمنحه للوكيل |
| --- | --- |
| [مهارات الوكلاء](https://github.com/thunderphone/skills) | إجراءات مركّزة للوكلاء، والموجّهات، والأرقام، والمكالمات، والأدوات، وخطافات الويب، والمعرفة، والاختبار، والحملات، والأدوات المصغّرة، وأطر العمل الفوري، وعمليات الترحيل. |
| MCP | تغطي الأدوات المُوثَّقة الوكلاء، والأرقام، والمكالمات، والاختبار، والمعرفة، والأدوات/خطافات الويب، والحملات، والأصوات، وعمليات الاستيراد، والوثائق عند طرحها؛ استدعِ `tools/list` للاطلاع على الكتالوج المباشر. |
| [الوثائق الخام](https://thunderphone.com/docs/llms.txt) | مصادر Markdown الحالية لسلوك المنتج وتفاصيل واجهة برمجة التطبيقات. |

تشرح المهارات كيفية تنفيذ العمل. يتيح MCP للوكيل البرمجي فحص مؤسستك واتخاذ إجراءات فيها. توفر الوثائق الخام المادة المصدرية للأسئلة التي تقع خارج نطاق مهارة محمّلة.

## التثبيت في مشروع

تثبّت هذه الكتلة المهارات، وتتيح المفتاح لصدفة الأوامر الحالية،
وتضيف خادم MCP الخاص بالمشروع إلى Claude Code. استبدل العنصر النائب
بقراءة القيمة الفعلية من مدير الأسرار لديك؛ لا تلصق مفتاحًا في مستودع أو محادثة.

```bash
npx skills add thunderphone/skills
export THUNDERPHONE_API_KEY='replace-with-value-from-your-secret-manager'
claude mcp add --transport http --scope project \
  --header 'Authorization: Bearer ${THUNDERPHONE_API_KEY}' \
  thunderphone https://api.thunderphone.com/v1/mcp
```

بالنسبة إلى Codex، استبدل الأمر الأخير بما يلي:

```bash
codex mcp add thunderphone \
  --url https://api.thunderphone.com/v1/mcp \
  --bearer-token-env-var THUNDERPHONE_API_KEY
```

يقرأ Cursor إعدادات المشروع من `.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "thunderphone": {
      "type": "http",
      "url": "https://api.thunderphone.com/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${env:THUNDERPHONE_API_KEY}"
      }
    }
  }
}
```

يستخدم VS Code الخادم نفسه تحت مفتاح `servers` في `.vscode/mcp.json`:

```json
{
  "servers": {
    "thunderphone": {
      "type": "http",
      "url": "https://api.thunderphone.com/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${env:THUNDERPHONE_API_KEY}"
      }
    }
  }
}
```

<Warning>
  يمكن لمفتاح واجهة برمجة التطبيقات الخاص بالمؤسسة قراءة بيانات المؤسسة وتنفيذ
  الإجراءات المفعّلة. احتفظ به في مدير أسرار، وحدد نطاق الوصول إلى المشروع المقصود،
  وراجع استدعاءات الأدوات التي تُجري تغييرات قبل الموافقة عليها.
</Warning>

## مثال على جلسة: موظف استقبال أسنان ثنائي اللغة

1. اطلب من وكيل البرمجة تحميل `create-agent`،
   `thunderphone-prompt-builder`، و`build-tool-integration`، و`add-knowledge`، و
   `test-agent`. أخبره بأن يخطط أولًا وألا ينشئ موارد بعد.
2. زوّده بحقائق موثقة عن العيادة، والمهام المدعومة، وقواعد التصعيد، واللغتين
   المطلوبتين. اطلب منه التحقق من كتالوج الأصوات المباشر واللغات المدعومة بدلًا من ابتكار صوت أو لغة.
3. اطلب موجّه إنتاج واحدًا مبنيًا على المبادئ العامة والحقائق. ينبغي أن
   ينتقل الوكيل إلى لغة المتصل المدعومة، ويحافظ على الإيجاز في الحديث،
   ويطرح سؤالًا واحدًا في كل مرة، ويتجنب نصوص ردود المتصلين.
4. اطلب منه تعريف أداة جدولة محددة وإرفاق المعرفة التي يحتاجها موظف
   الاستقبال فقط. اختبر نجاح الأداة، وعدم توفر المواعيد، والإدخال غير الصحيح،
   وانتهاء المهلة، والتحويل إلى موظف بشري قبل النشر.
5. أنشئ سيناريوهات للغتين، والمقاطعات، والتصحيحات، والمعلومات الناقصة،
   وأسئلة المعرفة، وإخفاقات الجدولة، والتصعيد. شغّلها، وافحص النصوص المفرغة وأدلة الأدوات، وأصلح أصغر قاعدة عامة،
   ثم أعد تشغيل المجموعة نفسها.
6. راجع المسودة الدقيقة وأدلة الاختبار، ثم فوّض صراحة النشر
   وإرفاق الرقم. أجرِ مكالمة صوتية مضبوطة بكل لغة قبل نقل حركة الاتصالات الفعلية.

استخدم [حزمة تطوير Python أو TypeScript](/api-reference/sdks) لطلبات REST المكتوبة الأنواع.

استخدم REST بدلًا من MCP عندما يتطلب البناء حمولات حتمية، أو
تجهيزات بإصدارات محددة، أو تنسيقًا جماعيًا، أو عملية غير موجودة في قائمة أدوات MCP الحالية. تبدأ واجهة API من `https://api.thunderphone.com/v1`؛ راجع
[مقدمة API](/api-reference/introduction) و
[دليل MCP](/ar/guides/thunderphone-mcp-server).