> ## Documentation Index
> Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# دليل إعداد بوابة الاستدلال التابعة لجهة خارجية لـ Claude Desktop

> Claude AI API guide - Ace Data Cloud

يُعد هذا الدليل لإعداد **Third-Party Inference Gateway** في Claude Desktop، وليس Claude Code، وليس MCP Connector في Claude Desktop.

## 1. الحصول على API Key

افتح [قائمة تطبيقات Ace Data Cloud](https://platform.acedata.cloud/console/applications)، وادخل إلى التطبيق المتاح وانسخ API Key.

![الحصول على Ace Data Cloud API Key](https://cdn.acedata.cloud/dvc3cg.jpg)

## 2. فتح إعدادات الاستدلال التابعة لجهة خارجية

في صفحة تسجيل الدخول إلى Claude Desktop، افتح بالتسلسل **Help → Troubleshooting → Enable Developer Mode**، ثم اختر **Developer → Configure Third-Party Inference…**.

![فتح Third-Party Inference في Claude Desktop](https://cdn.acedata.cloud/713ffd7104a3.png)

> الصورة من مستودع Bifrost Apache-2.0، وتُستخدم فقط لتحديد موقع قائمة Claude Desktop؛ وقد تختلف الواجهة قليلًا بين الإصدارات المختلفة.

## 3. إعداد Gateway

اختر **Gateway**، ثم املأ:

| الحقل | القيمة |
| - | - |
| Gateway base URL | `https://api.acedata.cloud` |
| Gateway API key | API Key الذي نسخته للتو |
| Gateway auth scheme | `bearer` |
| Credential kind | `Static API key` |

![واجهة إعداد Gateway في Claude Desktop](https://cdn.acedata.cloud/68d41fe682cb.png)

انقر على **Apply Changes**، ثم انقر على **Save & Restart**.

## 4. التحقق

بعد إعادة التشغيل، اختر نموذجًا متاحًا، وأنشئ محادثة جديدة وأرسل `Reply only OK`، ثم نفّذ مهمة أداة بسيطة. يمكن عرض سجلات الاستدعاء في [سجل الاستخدام](https://platform.acedata.cloud/console/usages).

تدعم Ace Data Cloud Gateway مسارات `/v1/models` و`/v1/messages` المتدفقة بمصادقة Bearer، واستدعاءات الأدوات ومتابعة `tool_result` التي يستخدمها Claude Desktop. سيتم الاحتفاظ بحقول التخزين المؤقت للمطالبات؛ وعندما تكون قيمتا كتابة وقراءة التخزين المؤقت كلتاهما 0، فلا يعني ذلك حدوث إصابة للتخزين المؤقت.

يشير الخطأ 401 عادةً إلى أن Key غير صحيح؛ وعند عدم العثور على نموذج، أعد التحقق من الإعدادات وأعد تشغيل Claude Desktop بالكامل. عند الإبلاغ عن مشكلة، قدّم trace ID الموجود في سجلات الاستدعاء، ولا تقدّم API Key.

## المراجع الرسمية

* [تثبيت الاستدلال التابع لجهة خارجية وإعداد الجهاز الواحد لـ Claude Desktop](https://claude.com/docs/third-party/claude-desktop/installation)
* [مرجع إعداد الاستدلال التابع لجهة خارجية لـ Claude Desktop](https://claude.com/docs/third-party/claude-desktop/configuration)

العودة إلى [دليل تكامل Claude App](https://platform.acedata.cloud/documents/mcp-tutorials-claude-desktop).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.