# إعداد بسيط. وإمكانات بلا حدود.

اربط وكيلك باستوديو AnimaGuru لإنشاء السبرايت والصور والفيديو والموسيقى والتعليق الصوتي والمؤثرات الصوتية. استخدم CLI في مساحة عملك، أو خادم MCP من محادثتك.

## دع وكيلك يتولى الإعداد

الصق هذا النص في محادثة وكيلك. سيتحقق من بيئتك، ويختار طريقة الاتصال المناسبة، ويساعدك في تسجيل الدخول.

نسخ موجّه الإعداد:

```
ساعدني في إعداد AnimaGuru لمساحة العمل هذه. اقرأ أولًا https://animaguru.com/docs.md ثم https://animaguru.com/agent-setup.md لتعرف الإمكانات الحالية وتعليمات الإعداد.

إذا كان بإمكانك تشغيل أوامر محلية، فتحقق مما إذا كان animaguru مثبّتًا، ومما إذا كان Node.js 24+ متاحًا. استخدم التثبيت الموجود إن أمكن؛ وإلا فثبّت @docyrus/animaguru من npm، أو استخدم أداة التثبيت لنظام macOS على https://animaguru.com/install.sh. شغّل animaguru auth status؛ وإذا لزم تسجيل الدخول، فشغّل animaguru auth login واتركني أوافق عليه في متصفحي. لا تطلب مني أبدًا لصق بيانات الاعتماد في المحادثة.

اسألني أين أريد العناصر: في مشروع قائم، أم في فيلم مستقل، أم في مساحة عمل مشتركة لعلامة تجارية. في المشاريع القائمة، شغّل animaguru init في المجلد المقصود لتثبيت مهارة الوكيل. ولفيلم جديد، استخدم animaguru create NEW_FOLDER. ولعلامة تجارية لها عدة أفلام، استخدم animaguru create workspace NEW_FOLDER، ثم animaguru create animation ANIMATION_NAME داخلها. حافظ على الملفات الموجودة. اقرأ المهارات المثبّتة وملف AGENTS.md أو CLAUDE.md قبل بدء الإنتاج. واستخدم الأمر animaguru schema والأمر animaguru catalog لاكتشاف الأوامر والخيارات الحالية.

إذا لم تتوفر الأوامر المحلية، فساعدني في إضافة https://animaguru.com/mcp بوصفه خادم MCP بعيدًا من نوع Streamable HTTP، وفي إكمال OAuth في تطبيقي. اكتشف المشاريع باستخدام list_projects، والنماذج المهيّأة باستخدام list_assets. ويمكن للتطبيقات التي تدعم MCP Apps استخدام open_studio للمعاينات التفاعلية. وفي Claude، اقترح إضافة AnimaGuru من السوق Docyrus/animaguru-claude-plugin على GitHub: فهي تضيف هذا الخادم مع تطبيق الاستوديو وكل مهارات الأفلام. إضافة AnimaGuru في دليل ChatGPT قادمة قريبًا وهي قيد المراجعة حاليًا؛ فلا تقل إن تثبيتها متاح الآن.

اختم بالتحقق من الحساب المتصل وعرض قائمة المشاريع، دون إنشاء أي شيء. واشرح طرق العمل المتاحة. وقبل أي إنشاء مدفوع لاحقًا، تحقق من صحة الطلب واعرض تقدير تكلفته؛ فتقديرات --dry-run في CLI تعتمد على أسعار مضمّنة، بينما تتحقق الأداة estimate_generation في MCP من الطلب على الخادم. التزم بطلب الإنشاء وبالميزانية التي أحددها، وتابع معرّفات المهام التي تعود إليك بدلًا من إعادة إرسال المهام المدفوعة.
```

## استوديو واحد. طريقتان للاتصال.

تستخدم الطريقتان حسابك في AnimaGuru ومشاريعك ونقاطك نفسها، وتحتاجان إلى خطة: Individual Starter أو Individual Pro أو Team، أو العضوية في فريق مشترك في خطة Team. ويبدأ كل حساب بفترة تجريبية لخطة Individual Pro مدتها 7 أيام.

### رسم وتعديل وتحريك

أنشئ الشخصيات والأغراض، وأعد رسم الأعمال الفنية، وأضف حركات جاهزة أو صِف حركة مخصصة. افحص الإطارات وصدّر أوراق السبرايت مع بيانات الحركة.

### أكمل بقية المشهد

أنشئ الصور والرسوم المتجهية وصور GIF والموسيقى والتعليق الصوتي والمؤثرات الصوتية. حوّل النص أو الصور إلى فيديو، أو مدّد مقطعًا محفوظًا باستخدام نموذج يدعم ذلك، أو اجعل مقدّمًا افتراضيًا يقدّم نصك.

### البناء والتسليم عبر CLI

اعمل في مشروع قائم أو اصنع أفلامًا وعروضًا تقديمية بالمهارات الإبداعية. صدّر بصيغة MP4 أو PowerPoint، وشارك الفيديوهات المكتملة، وارفعها مباشرة إلى YouTube، وزامن الإصدارات في أي خطة.

## إعداد Codex أو Claude Code

استخدم CLI لإنشاء العناصر في مجلد قائم، أو لصنع فيلم مستقل، أو لعدة رسوم متحركة تتشارك علامة تجارية واحدة. تعيد الأوامر الناجحة نتائجها بصيغة JSON.

### 1. تثبيت AnimaGuru

اختر أداة التثبيت لنظام macOS، أو ثبّت الحزمة من npm مع Node.js 24 أو أحدث.

macOS:

```
curl -fsSL https://animaguru.com/install.sh | bash
```

npm · Node.js 24+:

```
npm install -g @docyrus/animaguru
```

### 2. ربط حسابك

شغّل أمر تسجيل الدخول ووافق على الاتصال في متصفحك، ثم تحقق من حالة تسجيل الدخول.

ربط حسابك:

```
animaguru auth login
animaguru auth status
```

### 3. اختيار طريقة العمل

ثبّت المهارات في مشروع قائم أو أنشئ مساحة عمل جديدة. تأتي مساحات العمل الجديدة مع إرشادات لكل من Codex وClaude، ومهارات إبداعية، وأدلة تغطي 60 نمطًا بصريًا.

شغّل هذه الأوامر في مجلد لعبتك أو تطبيقك. يثبّت الأمر init مهارة AnimaGuru أو يحدّثها، ويعرض catalog الخيارات المتاحة، ويتحقق projects list من الوصول.

مشروع قائم:

```
animaguru init
animaguru catalog
animaguru projects list
```

جرّب هذا الموجّه:

```
اقرأ مهارة AnimaGuru في هذا المجلد. اعرض مشاريعي وساعدني في اختيار العناصر لهذا التطبيق. واعرض التقديرات قبل إنشاء أي شيء.
```

شغّل هذا الأمر من المجلد الذي يضم مشاريعك، مع اسم مجلد جديد. يثبّت الأمر التبعيات والمهارات نيابة عنك.

فيلم واحد:

```
animaguru create my-video
cd my-video
```

جرّب هذا الموجّه:

```
لنصنع فيلم رسوم متحركة قصيرًا. ساعدني في اختيار الفئة والنمط والموجز الإبداعي قبل بدء الإنتاج.
```

أنشئ مساحة عمل جديدة، ثم أضف الأفلام داخلها. تتشارك رسومك المتحركة هوية العلامة والتبعيات والمشغّل وأدوات التصدير.

علامة تجارية مشتركة:

```
animaguru create workspace my-brand
cd my-brand
animaguru create animation first-film
```

جرّب هذا الموجّه:

```
اقرأ تعليمات مساحة العمل وساعدني في بناء هوية العلامة من موقعي الرسمي أو دليل علامتي التجارية. ثم خطّط لفيلمنا الأول.
```

### 4. بدء العمل مع وكيلك

افتح مجلد المشروع واطلب من وكيلك قراءة التعليمات والمهارات المثبّتة. ابدأ بموجز لفكرتك، وراجع التكاليف قبل إنشاء العناصر.

جرّب هذا الموجّه:

```
لنصنع فيلم رسوم متحركة قصيرًا. ساعدني في اختيار النمط وصياغة القصة قبل أن نبدأ.
```

لا يستهلك الإعداد وإنشاء المشاريع أي نقاط. تعتمد تقديرات --dry-run في CLI على أسعار مضمّنة في الأداة، ويتحقق الخادم من النماذج والمراجع والنقاط عند إرسال الطلب. يتطلب الإنشاء المدفوع الخيار --yes وموافقتك.

## إعداد تطبيقات MCP الأخرى

اتصل عن بعد عبر Streamable HTTP وسجّل الدخول عبر OAuth. تصفّح مشاريعك الشخصية ومشاريع فريقك، واحصل على تقدير لتكلفة الإنشاء، وارسم السبرايت وعدّله، وولّد الوسائط وتابع المهام. ويمكن للتطبيقات التي تدعم MCP Apps أن تعرض أيضًا معاينات تفاعلية للاستوديو.

### 1. إضافة خادم MCP بعيد

في إعدادات MCP في تطبيقك، أضف خادمًا باسم AnimaGuru بهذا العنوان. واختر Streamable HTTP إذا طلب تطبيقك تحديد طريقة النقل.

MCP URL:

```
https://animaguru.com/mcp
```

### 2. تسجيل الدخول إلى AnimaGuru

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

### 3. التحقق من الاتصال

اطلب من وكيلك عرض قائمة مشاريعك. يتحقق ذلك من الوصول دون بدء أي مهمة إنشاء.

جرّب هذا الموجّه:

```
اعرض مشاريعي في AnimaGuru وساعدني في اختيار مشروع للعمل عليه. لا تُنشئ أي شيء الآن.
```

تعتمد الأدوات المتاحة على النطاقات التي توافق عليها: النطاق projects.read للتصفح والتقدير، والنطاق projects.write لإنشاء المشاريع وتوليد المحتوى. استخدم الأداة estimate_generation لمعرفة التكاليف الحالية، والأداة get_job لمتابعة الحالة. لا يتيح MCP حذف المشاريع ولا تصدير الأفلام محليًا.

## إعداد Claude

تتصل إضافة AnimaGuru بخادم MCP من AnimaGuru عبر OAuth، وتضيف تطبيق الاستوديو وكل مهارات الأفلام من AnimaGuru. ثبّتها من سوقها على GitHub.

### 1. تثبيت الإضافة

في Claude، افتح Customize ثم Plugins، واختر Add ثم Add marketplace، وأدخل هذا المستودع، ثم أضف AnimaGuru. وفي Claude Code، شغّل الأمرين أدناه.

السوق على GitHub:

```
Docyrus/animaguru-claude-plugin
```

Claude Code:

```
/plugin marketplace add Docyrus/animaguru-claude-plugin
/plugin install animaguru@animaguru
```

### 2. ربط حسابك

في تبويب Connectors الخاص بالإضافة، اربط animaguru، وسجّل الدخول إلى AnimaGuru، واسمح بالوصول. وفي Claude Code، شغّل الأمر ‎/mcp واختر plugin:animaguru:animaguru. لا تحتاج أبدًا إلى لصق كلمة مرور أو مفتاح API.

### 3. التحقق من الاتصال

اطلب من Claude فتح الاستوديو. يعرض أفلامك في المحادثة دون بدء أي مهمة إنشاء.

جرّب هذا الموجّه:

```
افتح استوديو AnimaGuru واعرض أفلامي. لا تُنشئ أي شيء.
```

يظهر الاستوديو في Claude على الويب وتطبيقَي سطح المكتب والجوال. ويحصل Claude Code على الأدوات والمهارات نفسها، لكن دون الاستوديو. ويعرض كل إنشاء تقديرًا للأرصدة قبل أن يستهلك أي رصيد.

## ChatGPT · قريبًا

استوديوك الإبداعي داخل ChatGPT.

تصفّح المشاريع، وشغّل الفيديو والصوت، وافحص إطارات الرسوم المتحركة، وراجع تقديرات الإنشاء في استوديو تفاعلي دون أن تغادر محادثتك.

إضافة AnimaGuru قيد المراجعة حاليًا للإدراج في دليل ChatGPT، وسيتاح تثبيتها بعد الموافقة عليها.

- تصفّح مشاريعك الشخصية ومشاريع فريقك والعناصر المحفوظة.
- عاين الأعمال الفنية، وشغّل الرسوم المتحركة، وافحص الإطارات وملاحظات الجودة.
- راجع تقديرات النقاط قبل إنشاء السبرايت والوسائط، ثم تابع المهام.
- استعن بالإرشادات المضمّنة لاستخدام AnimaGuru وأداة CLI في عملك الإبداعي.

لمزيد من التفاصيل: [وثائق المطورين](https://animaguru.com/ar/docs.md).