# اربط الذكاء الاصطناعي بحسابك

> امنح Claude أو ChatGPT أو Codex أو Cursor صلاحية الوصول إلى حسابك في تاروت بلصق رابط واحد

# اربط الذكاء الاصطناعي بحسابك

يشغّل تاروت خادم MCP مستضافًا. الصق رابطًا واحدًا في أداة الذكاء الاصطناعي التي
تستخدمها، ووافق مرة واحدة في المتصفح، لتتمكن تلك الأداة من نشر تطبيقاتك وقراءة
السجلات وتشغيل استعلامات SQL وربط النطاقات نيابة عنك.

لا شيء لتثبيته ولا مفتاح لنسخه.

```
https://tarout.sa/api/mcp
```

## أهم ما يجب معرفته أولًا

لا يحصل الذكاء الاصطناعي على صلاحية مطلقة. يُمنح الاتصال مستوى **المشغّل**:

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

لذا الربط آمن حتى قبل أن تحسم مقدار ثقتك بالأداة.

## طريقة الإعداد

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

### Claude (‏claude.ai و Claude Desktop)

الإعدادات ← الموصّلات ← **إضافة موصّل مخصص**، ثم الصق:

```
https://tarout.sa/api/mcp
```

اترك حقلي معرّف العميل والسر فارغين. سيحوّلك Claude إلى تاروت لتسجيل الدخول
والموافقة.

### ChatGPT

الإعدادات ← الموصّلات ← **إنشاء**. الصق الرابط نفسه كعنوان الخادم واختر
**OAuth**، واترك معرّف العميل والسر فارغين.

### Claude Code

```sh
claude mcp add --transport http tarout https://tarout.sa/api/mcp
```

تحقّق بالأمر `/mcp`. أول استدعاء لأداة سيفتح المتصفح لتسجيل الدخول.

### Codex

```sh
codex mcp add tarout --url https://tarout.sa/api/mcp
codex mcp login tarout
```

### Cursor

أضف هذا إلى `~/.cursor/mcp.json` ثم أعد تحميل Cursor:

```json
{
  "mcpServers": {
    "tarout": { "url": "https://tarout.sa/api/mcp" }
  }
}
```

الإدخال البعيد يأخذ `url` دون مفتاح `type`. انتبه إلى أن Cursor يبقي **٤٠ أداة
فعّالة فقط عبر جميع خوادم MCP لديك** ويتجاهل الباقي بصمت، فإن لم تظهر أدوات
تاروت فعطّل خادمًا لا تستخدمه.

### VS Code (‏GitHub Copilot)

أضف هذا إلى `.vscode/mcp.json`:

```json
{
  "servers": {
    "tarout": { "type": "http", "url": "https://tarout.sa/api/mcp" }
  }
}
```

### Windsurf

أضف هذا إلى `~/.codeium/windsurf/mcp_config.json` ثم أعد تشغيل Windsurf. يسمّي
Windsurf الحقل `serverUrl` وليس `url`:

```json
{
  "mcpServers": {
    "tarout": { "serverUrl": "https://tarout.sa/api/mcp" }
  }
}
```

### أي أداة أخرى

أي عميل يدعم خوادم MCP البعيدة يقبل الرابط مباشرة. تعمل النقطة عبر Streamable
HTTP وتستخدم OAuth 2.1 مع التسجيل الديناميكي للعملاء، فلا حاجة لتسجيل مسبق.

## ماذا يمكنك أن تطلب بعد ذلك

اللغة الطبيعية تكفي:

- «ما الذي يعمل لدي على تاروت؟»
- «انشر الفرع الرئيسي من مستودع api وأخبرني عندما يصبح جاهزًا.»
- «تطبيق الدفع يعطي خطأ 502. اقرأ السجلات وأخبرني بالسبب.»
- «أنشئ قاعدة بيانات Postgres لموقع التسويق واربط نص الاتصال.»
- «وجّه shop.example.com إلى تطبيق المتجر وأخبرني بسجلات DNS المطلوبة.»
- «كم أنفق، وعلى ماذا؟»

## الأدوات التي يراها

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

ولا شيء خارج المتناول: يستطيع الذكاء الاصطناعي استدعاء أي إمكانية في تاروت عبر
`tarout_call`، ومعرفة المتاح عبر `tarout_list_procedures`. لا يتطلب ذلك أي إعداد
منك.

## إن كنت تفضّل واجهة الأوامر

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

```sh
curl -fsSL https://tarout.sa/install.sh | sh
tarout login
```

راجع [دليل الوكلاء](https://tarout.sa/docs/for-ai/start) للصورة الكاملة.

## حل المشكلات

**الأدوات لا تظهر.** معظم العملاء يحتاجون إعادة تشغيل بعد تعديل ملف الإعدادات. في
Cursor راجع حدّ الأربعين أداة أعلاه.

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

**تظهر رسالة NEEDS_APPROVAL.** هذا هو السلوك المقصود. الإجراء محفوظ في
**الوكيل ← الموافقات** بانتظارك.

**تريد إلغاء الربط.** من **الوكيل ← مفاتيح API**، ألغِ الإدخال المسمّى باسم
عميلك. ينقطع الاتصال فورًا.

---

## Every Tarout agent guide

- [Start Here (Agents)](https://tarout.sa/docs/for-ai/start.md)
- [Overview](https://tarout.sa/docs/for-ai.md)
- [Deploying an app](https://tarout.sa/docs/for-ai/deploy.md)
- [Databases](https://tarout.sa/docs/for-ai/database.md)
- [Object storage](https://tarout.sa/docs/for-ai/storage.md)
- [Custom domains](https://tarout.sa/docs/for-ai/domains.md)
- [Plans and upgrades](https://tarout.sa/docs/for-ai/billing.md)
- [Troubleshooting](https://tarout.sa/docs/for-ai/troubleshoot.md)
- [Agent Onboarding](https://tarout.sa/docs/for-ai/onboarding.md)
- [CLI Reference](https://tarout.sa/docs/for-ai/cli-reference.md)
- [CLI JSON Schema](https://tarout.sa/docs/for-ai/cli-json-schema.md)

Whole corpus in one file: https://tarout.sa/llms-full.txt · index: https://tarout.sa/llms.txt
Any docs page is raw markdown at the same URL + `.md`. Short link to the entry point: https://tarout.sa/deploy.md