# استخدم Gheima مع الذكاء الاصطناعي

> اربط Claude أو Cursor أو VS Code أو أي عميل MCP بحسابك، وقدّم التوثيق بصيغة Markdown لوكلاء البرمجة.

Source: https://gheima.ma/ar/docs/ai-assistants

يعمل Gheima مع مساعدي الذكاء الاصطناعي ووكلاء البرمجة بثلاث طرق: خادم MCP مستضاف يتيح للمساعد الاطلاع على حسابك والتصرف فيه، وكل صفحة من التوثيق بصيغة Markdown، وواجهة أوامر صُممت مخرجاتها ‎--json‎ ورموز خروجها للسكربتات.

### اربط مساعدًا (MCP)

أضف https://gheima.ma/mcp كخادم MCP بعيد. في المرة الأولى يفتح متصفحك صفحة تسجيل دخول Gheima تختار فيها القراءة فقط أو القراءة والكتابة. يحصل المساعد على مفتاح API لهذا الاختيار فقط. يظهر المفتاح في الإعدادات ← مفاتيح API باسم MCP: <اسم التطبيق>، وإلغاؤه هناك يفصل المساعد.

```bash
claude mcp add --transport http gheima https://gheima.ma/mcp
```

Claude Code. في Claude على الويب أو الحاسوب: الإعدادات ← الموصلات ← إضافة موصل مخصص، ثم الصق الرابط.

```json
{ "mcpServers": { "gheima": { "url": "https://gheima.ma/mcp" } } }
```

Cursor: ‎~/.cursor/mcp.json

```json
{ "servers": { "gheima": { "type": "http", "url": "https://gheima.ma/mcp" } } }
```

VS Code: ‎.vscode/mcp.json

> Note: لا يمكن ربط مساعد إلا للمالك أو المسؤول، لأن الربط ينشئ مفتاح API.

### شغّله محليًا

يعمل الخادم نفسه على جهازك عبر stdio، بالمفتاح الذي حفظه gheima login. استخدمه إذا أردت أن يقرأ المساعد بيانات الاعتماد، وهو ما لا يفعله الخادم المستضاف أبدًا.

```json
{ "mcpServers": { "gheima": { "command": "npx", "args": ["-y", "@gheima/mcp"] } } }
```

> Note: محليًا، تُرفض الأدوات التي تغيّر أي شيء ما لم تشغّل الخادم مع GHEIMA_MCP_ALLOW_WRITES=1. وتتطلب قراءة بيانات الاعتماد (كشف كلمة مرور قاعدة بيانات أو تنفيذ SQL) أيضًا GHEIMA_MCP_ALLOW_SECRETS=1 وتأكيدًا في كل استدعاء.

### ما يستطيع المساعد فعله

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

يقدم الخادم أيضًا مطالبات جاهزة (لماذا فشل النشر؟، كيف حال خدمتي؟، كم سيكلف هذا الشهر؟) ويقدّم هذا التوثيق للمساعد، ليتحقق من طريقة عمل الشيء قبل أن يتصرف.

> Note: كل ما يفعله المساعد يُسجَّل في سجل التدقيق تحت واجهة MCP، لتميّز أفعاله عن أفعالك.

### التوثيق للنماذج

- `/llms.txt`: فهرس بكل صفحات التوثيق مع ملخص من سطر واحد.
- `/llms-full.txt`: كل صفحات التوثيق في ملف نصي واحد.
- `/docs/<page>.md`: أي صفحة توثيق بصيغة Markdown. أضف ‎/fr‎ أو ‎/ar‎ قبل ‎/docs‎ للفرنسية أو العربية.
- `Accept: text/markdown`: اطلب صفحة بهذا الترويس لتحصل على Markdown نفسه من رابطها المعتاد.
- `/api/v1/openapi.json`: مواصفة OpenAPI 3.1 لواجهة REST.

### أخبر وكيل البرمجة كيف تنشر

يقرأ وكلاء البرمجة الملف AGENTS.md في جذر المستودع. يطبع الأمر gheima agents قسمًا قصيرًا عن Gheima لهذا الملف: الخدمة التي ينشر إليها هذا المجلد، وطريقة النشر وقراءة السجلات، ورموز الخروج. أضف ‎--write‎ لإلحاقه بالملف AGENTS.md. يُضاف مرة واحدة بين علامتين، فإعادة تشغيل الأمر تحدّث القسم فقط.

```bash
gheima link my-app
gheima agents --write
```

شغّله في المجلد المرتبط. يقرأ Claude Code الملف CLAUDE.md، فأضف إليه السطر ‎@AGENTS.md‎ لمشاركة الملف نفسه.

### الاكتشاف للوكلاء

- `/.well-known/mcp/server-card.json`: كيفية الوصول إلى خادم MCP المستضاف.
- `/.well-known/oauth-protected-resource`: أين يسجّل عميل MCP الدخول (RFC 9728).
- `/.well-known/api-catalog`: روابط إلى مواصفة API وتوثيقها (RFC 9727).
- `/.well-known/agent-skills/index.json`: مهارة تعلّم وكيل البرمجة النشر على Gheima.

---

All docs: https://gheima.ma/ar/docs.md