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

# خادم MCP

> دع مساعدًا ذكيًا يعمل على حسابك عبر بروتوكول Model Context Protocol.

توفر HueChat خادم MCP محصورًا بالحساب عبر HTTP القابل للبث:

```
https://app.huechat.ai/v2/mcp
```

## الحصول على مفتاح

يستخدم MCP بيان اعتماد خاصًا به يُعتمد بشكل منفصل. بصفتك مدير حساب، افتح
**الإعدادات ← التكاملات ← MCP**، اطلب الوصول للحساب، انتظر الموافقة، ثم انسخ
المفتاح عند ظهوره. يُعرض مرة واحدة.

<Note>
  لا يمكن استخدام مفتاح REST محدود النطاق لـ MCP، ويُرفض مفتاح MCP على مسارات
  REST. يجب أن يحمل مفتاح MCP `mcp:use` بالإضافة إلى نطاقات الموارد التي تحتاجها
  الأدوات التي تفعّلها فقط.
</Note>

يجب أن يبقى مقدّم الطلب مديرًا نشطًا؛ فالتنزيل أو الإزالة أو إلغاء المفتاح أو
انتهاؤه يعطّل بيان الاعتماد.

## الترويسات المطلوبة

```http theme={null}
Authorization: Bearer <MCP key>
Content-Type: application/json
Accept: application/json, text/event-stream
MCP-Protocol-Version: 2025-11-25
```

## المصافحة

<Steps>
  <Step title="التهيئة">
    ```bash theme={null}
    curl -fsS https://app.huechat.ai/v2/mcp \
      -H "Authorization: Bearer $HUECHAT_MCP_KEY" \
      -H "Content-Type: application/json" \
      -H "Accept: application/json, text/event-stream" \
      -H "MCP-Protocol-Version: 2025-11-25" \
      --data '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-11-25","capabilities":{},"clientInfo":{"name":"my-integration","version":"1.0.0"}}}'
    ```
  </Step>

  <Step title="إرسال إشعار initialized">
    ```json theme={null}
    { "jsonrpc": "2.0", "method": "notifications/initialized", "params": {} }
    ```
  </Step>

  <Step title="عرض الأدوات المتاحة لمفتاحك">
    ```json theme={null}
    { "jsonrpc": "2.0", "id": 2, "method": "tools/list", "params": {} }
    ```

    تُصفّى القائمة حسب نطاقات المفتاح.
  </Step>

  <Step title="استدعاء أداة للقراءة فقط">
    ```json theme={null}
    { "jsonrpc": "2.0", "id": 3, "method": "tools/call",
      "params": { "name": "get_contacts", "arguments": { "query": "Example", "limit": 10 } } }
    ```
  </Step>
</Steps>

## إعداد العميل

يقبل معظم عملاء MCP هذا الشكل:

```json theme={null}
{
  "mcpServers": {
    "huechat": {
      "type": "http",
      "url": "https://app.huechat.ai/v2/mcp",
      "headers": {
        "Authorization": "Bearer ${HUECHAT_MCP_KEY}",
        "MCP-Protocol-Version": "2025-11-25"
      }
    }
  }
}
```

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