# خادم MCP (تجريبي)

خادم MCP تجريبي. قد تتغير الأدوات ومخططاتها قبل الإصدار المستقر.

تشغّل قُبة خادم MCP عن بُعد على العنوان `https://www.quba.co/api/mcp`. يستطيع الوكلاء فحص النصوص وإخفاء الهوية فيها، وقراءة سياسات مؤسستك، ومعرفة الرصيد. يستخدم كل استدعاء [مفتاح API](/app/api-keys) ويُحتسب مثل استدعاءات الواجهة.

## الأدوات [#الأدوات]

| الأداة           | الوظيفة                                                                      |
| ---------------- | ---------------------------------------------------------------------------- |
| `scan_text`      | فحص النص بحثًا عن البيانات الشخصية، مع نوع كل نتيجة وموضعها ودرجة الثقة.     |
| `anonymize_text` | إخفاء الهوية في النص بقواعد ترسلها مع الطلب أو بالسياسة المُسندة إلى مفتاحك. |
| `list_policies`  | عرض سياسات مؤسستك.                                                           |
| `get_policy`     | قراءة قواعد سياسة.                                                           |
| `get_balance`    | الرصيد المتبقي لمؤسستك.                                                      |

## الربط [#الربط]

### Claude Code [#claude-code]

```bash
claude mcp add --transport http quba https://www.quba.co/api/mcp \
  --header "Authorization: Bearer <your-api-key>"
```

### Cursor [#cursor]

أضف إلى `~/.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "quba": {
      "url": "https://www.quba.co/api/mcp",
      "headers": { "Authorization": "Bearer <your-api-key>" }
    }
  }
}
```

### VS Code [#vs-code]

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

```json
{
  "inputs": [
    { "type": "promptString", "id": "quba-key", "description": "Quba API key", "password": true }
  ],
  "servers": {
    "quba": {
      "type": "http",
      "url": "https://www.quba.co/api/mcp",
      "headers": { "Authorization": "Bearer ${input:quba-key}" }
    }
  }
}
```

### عملاء آخرون [#عملاء-آخرون]

يعمل أي عميل يدعم Streamable HTTP: استخدم العنوان أعلاه وأرسل المفتاح في `Authorization: Bearer <key>` أو `x-api-key: <key>`.

## ملاحظات [#ملاحظات]

* النص الذي يرسله الوكيل إلى أداة أصبح جزءًا من المحادثة. استخدم الأدوات لتنظيف النص قبل أن يغادر: عند المشاركة أو التسجيل أو إرساله إلى أدوات أخرى.
* تعالج قُبة النص ولا تخزّنه.
* السياسات للقراءة فقط عبر MCP. أنشئها وعدّلها من [لوحة التحكم](/app/policies).
* موصلات claude.ai وChatGPT غير مدعومة بعد.