---
title: "التكاملات: اربط Minds في كل مكان"
description: "استخدم Minds من ChatGPT وClaude وCursor وغيرها من مساعدي الذكاء الاصطناعي عبر MCP، وضمّن أداة محادثة على موقعك."
canonical_url: "https://getminds.ai/guide/ar/integrations"
last_updated: "2026-08-25T20:22:22.534Z"
---

# التكاملات

اربط Minds بمساعدي الذكاء الاصطناعي وموقعك. استخدم Minds الخاصة بك من ChatGPT أو Claude أو Cursor أو Langdock أو أي عميل متوافق مع MCP، أو ضمّنها مباشرة على موقعك.

## مساعدو الذكاء الاصطناعي (MCP)

استخدم Minds مباشرة من مساعد الذكاء الاصطناعي الخاص بك. أنشئ Minds، وشغّل بحث اللوحات، وحلّل النتائج، كل ذلك عبر محادثة طبيعية.

**عنوان خادم MCP:** `https://getminds.ai/mcp`

### ChatGPT

1. اذهب إلى **ChatGPT** ← **Settings** ← **Connected Apps**
2. ابحث عن "Minds" أو أضف عنوان MCP: `https://getminds.ai/mcp`
3. اضغط **Connect** وفوّض عبر OAuth
4. ابدأ بالطلب من ChatGPT إنشاء Minds وتشغيل بحث اللوحات

يعرض ChatGPT أدوات تفاعلية داخل المحادثة: نتائج لوحات بإجابات مجمَّعة، ومخططات شريطية، وصور Minds رمزية قابلة للنقر.

### Claude Desktop

**الموصّل البعيد (مُوصى به، يتيح الأدوات التفاعلية):**

1. افتح Claude Desktop ← **Customize** ← **Connectors**
2. أضف `https://getminds.ai/mcp`
3. فوّض عبر OAuth عند الطلب

**الموصّل المحلي (API key، نصي فقط):** أضف إلى ملف التهيئة (`~/Library/Application Support/Claude/claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "mindsai": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://getminds.ai/mcp",
        "--header", "Authorization: Bearer minds_YOUR_API_KEY"]
    }
  }
}
```

### Claude Code (CLI)

```bash
claude mcp add --transport http mindsai https://getminds.ai/mcp \
  --header "Authorization: Bearer minds_YOUR_API_KEY"
```

### Cursor

1. افتح **Cursor Settings** ← **MCP**
2. أضف عنوان الخادم: `https://getminds.ai/mcp`
3. فوّض عند الطلب

دعم الأدوات التفاعلية متاح منذ Cursor v2.6.

### Langdock

1. افتح **Langdock** ← **Integrations** ← **Add MCP Integration**
2. أدخل العنوان: `https://getminds.ai/mcp`
3. اختر **OAuth** كطريقة مصادقة
4. اضغط **"+ Add connection"** وفوّض
5. اضغط **"Test connection"** للتحقق من الأدوات

جميع الأدوات الـ 13 متاحة. إجابات نصية بروابط قابلة للنقر (بدون أدوات تفاعلية).

### VS Code (GitHub Copilot)

1. إعدادات VS Code ← **Extensions** ← **GitHub Copilot** ← **MCP Servers**
2. أضف `https://getminds.ai/mcp`
3. فوّض عند الطلب

### عملاء MCP آخرون

يمكن لأي عميل متوافق مع MCP الاتصال بـ `https://getminds.ai/mcp`، بما في ذلك OpenRouter وOpen WebUI. العملاء الذين يدعمون OAuth سيكتشفون مسار التفويض تلقائياً. وللعملاء بدون OAuth، استخدم API key (Settings ← API Keys) كرمز Bearer.

للاطلاع على مرجع الأدوات الكامل وتفاصيل الإعداد، راجع [توثيق MCP](/mcp/overview).

---

## Google Workspace والتحليلات

- [Minds لجداول بيانات Google](/guide/google-sheets): أرسل الأسئلة المحددة إلى Group موجودة واكتب الإجابات في ورقة البيانات.
- [Minds Panel Analytics لمنصة Looker Studio](/guide/looker-studio): استخدم تحليلات Panel موجودة في التقارير ولوحات المعلومات.

يتوقف توفر هذه التكاملات في Marketplace على مراجعة Google.

---

## تكاملات المحادثة

### Slack

*قريباً* - تحدث مع Minds في القنوات والرسائل المباشرة.

### Microsoft Teams

*قريباً* - أحضر Minds إلى مساحة عمل Teams الخاصة بك.

---

## تسجيل الدخول الموحّد للمؤسسات (SAML)

يمكن لعملاء المؤسسات تسجيل الدخول عبر موفّر هوية يديره العميل مثل Microsoft Entra ID أو Okta. في شاشة تسجيل الدخول أو إنشاء الحساب، اختر البريد الإلكتروني / SSO وأدخل بريد العمل. يتعرّف Minds تلقائياً على نطاقات SSO المسجّلة، ويخفي حقول كلمة المرور، ويعيد التوجيه إلى موفّر الهوية المُعد، ثم يُكمل تسجيل الدخول عبر رد PKCE الحالي `/auth/confirm`.

### إعداد المسؤول

1. أنشئ تطبيق SAML 2.0 للمؤسسة في Microsoft Entra ID (أو موفّر هوية آخر). يمكنك استيراد [بيانات Minds الوصفية](https://auth.getminds.ai/auth/v1/sso/saml/metadata) مباشرةً.
2. عند إدخال القيم يدوياً، استخدم:

  - **Identifier / Entity ID:** `https://auth.getminds.ai/auth/v1/sso/saml/metadata`
  - **Reply URL / ACS:** `https://auth.getminds.ai/auth/v1/sso/saml/acs`
  - **Logout URL (اختياري):** `https://auth.getminds.ai/auth/v1/sso/saml/slo`
3. أرسل البريد الإلكتروني ومعرّف مستخدم ثابتاً على الأقل ضمن claims؛ الاسم المعروض اختياري. ثم عيّن المستخدمين أو المجموعات المطلوبة للتطبيق.
4. أرسل إلى Minds **Federation Metadata URL** أو **Federation Metadata XML** لموفّر الهوية، مع نطاقات تسجيل الدخول الموثقة. لا يحتاج SAML إلى client ID أو client secret.
5. يفعّل Minds الاتصال، ثم يختبر الطرفان تسجيل الدخول من IdP ومن Minds باستخدام حساب اختبار.

تبقى سياسات MFA وثقة الجهاز ومخاطر الدخول والموقع بالكامل لدى موفّر هوية العميل. تُراجع حسابات Minds الحالية قبل التفعيل لأن هوية SAML لا تُدمج تلقائياً مع تسجيلات الدخول الحالية بكلمة المرور أو Google أو Apple أو Microsoft.

---

## التخزين السحابي (Google Drive وOneDrive)

أرفق ملفات من Google Drive أو OneDrive. يستخدم Google Drive نطاق `drive.file` لكل ملف. ويستخدم OneDrive الإذنين المفوَّضين `Files.Read` و`offline_access` مع **OneDrive الشخصي للمستخدم المسجّل**. لا تستورد أداة Minds ولا تخزّن إلا الملفات التي يختارها المستخدم صراحةً. لا يفحص Minds محرك الأقراص أو يزامنه، ولا يمكنه كتابة ملفات OneDrive أو تعديلها أو حذفها.

لا يدعم موصّل OneDrive الحالي المجلدات المشتركة خارج OneDrive الشخصي، ولا مكتبات مستندات SharePoint أو Teams. تحتاج هذه المصادر إلى تكامل منفصل بأذونات Microsoft Graph أوسع.

**الإعداد:** اضغط أيقونة Google Drive أو OneDrive في قائمة المرفقات "+"، أو اذهب إلى **Settings** ← **Integrations**. فوّض مرة واحدة، ثم اختر الملفات وقتما تحتاجها. يُحفظ الاتصال للمرة التالية.

### لمسؤولي المؤسسة

إذا كانت مؤسستك تقيّد وصول تطبيقات الأطراف الثالثة، فقد يحتاج مسؤول إلى الموافقة على Minds قبل أن يتمكن فريقك من الاتصال.

**Google Workspace.** في Google Admin console، اذهب إلى *Security* ← *Access and data control* ← *API controls* ← *App access control* ← *Manage third-party app access*. أضف Minds عبر معرّف عميل OAuth الخاص به واضبط الوصول على **Trusted**:

`686849389800-f4ef6g5a2icmm7dhcdonuombqfncl2u8.apps.googleusercontent.com`

يطلب Minds النطاق `drive.file` فقط، وهو يمنح الوصول إلى الملفات الفردية التي يفتحها المستخدم عبر أداة الاختيار، لا إلى محرك الأقراص Drive بالكامل.

**Microsoft 365 / Entra ID.** يمكن للمسؤول منح الموافقة على مستوى المؤسسة بفتح هذا الرابط وتسجيل الدخول كمسؤول:

`https://login.microsoftonline.com/common/adminconsent?client_id=fcf09c38-f994-4f8f-aab0-5eb8e6434271`

أو من Microsoft Entra admin center: *Enterprise applications* ← *Minds* ← *Permissions* ← *Grant admin consent*. توافق الإدارة على الإذنين المفوَّضين `Files.Read` و`offline_access` للمؤسسة، لكنها لا تمنح Minds وصولاً تطبيقياً إلى جميع محركات OneDrive في المؤسسة. بعد ذلك يربط كل مستخدم حسابه عبر **Settings** ← **Integrations** ← **OneDrive** ويختار الملفات المراد استيرادها.

---

## بنية تكاملات المؤسسات

```text
الموظفون ── SAML ──> موفّر الهوية ── assertion ──> Supabase Auth
   │                                               │
   └────────────── تطبيق/API Minds <── جلسة ───────┘
                         ├── Files.Read ──> Microsoft Graph
مساعدات AI ── OAuth 2.1/API key ──> Minds MCP ──> واجهات Minds المصرح بها
```

يدير موفّر الهوية الحسابات وMFA وConditional Access. يتحقق Supabase Auth من SAML assertion وينشئ جلسة Minds. يُستخدم Microsoft Graph فقط مع OneDrive الشخصي للمستخدم المتصل واستيراد الملفات المختارة. تستخدم عملاء MCP ‏OAuth 2.1 مع PKCE أو مفتاح Minds API. تمثل SSO وOneDrive وMCP تكاملات منفصلة، ولكل منها موافقتها ومسار إلغائها.

---

## أداة التضمين

أضف أداة محادثة إلى موقعك لدعم العملاء أو عروض المنتج أو التجارب التفاعلية.

**الميزات:**

- واجهة منبثقة بنمط دردشة الدعم
- اكتشاف تلقائي للوضع الفاتح/الداكن
- متجاوبة مع الجوال وسطح المكتب
- استمرار الجلسة عبر تحميلات الصفحة

**الإعداد:**

1. اذهب إلى **Settings** ← **Integrations** ← **Embed Widget**
2. اختر حتى 3 Minds لأداتك
3. انسخ وسم الـ script وأضفه إلى موقعك

**الاستخدام الأساسي:**

```html
<script
  src="https://getminds.ai/embed/chat-widget.js"
  data-widget-id="your-widget-id"
  async
></script>
```

<embed-widget-preview>



</embed-widget-preview>

**خيارات التهيئة:**

<table>
<thead>
  <tr>
    <th>
      السِمة
    </th>
    
    <th>
      الوصف
    </th>
    
    <th>
      الافتراضي
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        data-widget-id
      </code>
    </td>
    
    <td>
      معرّف أداتك (مطلوب)
    </td>
    
    <td>
      -
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        data-language
      </code>
    </td>
    
    <td>
      فرض اللغة: <code>
        en
      </code>
      
      ، <code>
        de
      </code>
      
      ، <code>
        es
      </code>
      
      ، <code>
        fr
      </code>
      
      ، <code>
        zh
      </code>
      
      ، <code>
        tr
      </code>
      
      ، <code>
        ar
      </code>
      
      ، <code>
        ja
      </code>
      
      ، <code>
        ko
      </code>
      
      . يتحكم في واجهة الأداة ولغة ردود الذكاء الاصطناعي معاً.
    </td>
    
    <td>
      اكتشاف تلقائي
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        data-position
      </code>
    </td>
    
    <td>
      <code>
        bottom-left
      </code>
      
       أو <code>
        bottom-right
      </code>
    </td>
    
    <td>
      <code>
        bottom-left
      </code>
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        data-theme
      </code>
    </td>
    
    <td>
      <code>
        light
      </code>
      
       أو <code>
        dark
      </code>
    </td>
    
    <td>
      اكتشاف تلقائي
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        data-max-messages
      </code>
    </td>
    
    <td>
      الحد الأقصى لرسائل المستخدم قبل دعوة التسجيل (1–10)
    </td>
    
    <td>
      <code>
        3
      </code>
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        data-greeting-delay
      </code>
    </td>
    
    <td>
      التأخير بالميلي ثانية قبل الترحيب الأولي
    </td>
    
    <td>
      <code>
        0
      </code>
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        data-persist-session
      </code>
    </td>
    
    <td>
      الاحتفاظ بالمحادثة عبر الصفحات
    </td>
    
    <td>
      <code>
        true
      </code>
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        data-size
      </code>
    </td>
    
    <td>
      حجم الأداة: <code>
        standard
      </code>
      
       أو <code>
        large
      </code>
    </td>
    
    <td>
      <code>
        standard
      </code>
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        data-primary-color
      </code>
    </td>
    
    <td>
      إطار المشغّل / اللون الأساسي كقيمة hex
    </td>
    
    <td>
      <code>
        #000000
      </code>
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        data-accent-color
      </code>
    </td>
    
    <td>
      لون تمييز أيقونة المحادثة كقيمة hex
    </td>
    
    <td>
      <code>
        #00E14F
      </code>
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        data-surface-color
      </code>
    </td>
    
    <td>
      لون سطح المشغّل كقيمة hex
    </td>
    
    <td>
      سمة الصفحة
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        data-launcher-label
      </code>
    </td>
    
    <td>
      النص المعروض تحت اسم Mind في المشغّل المغلق
    </td>
    
    <td>
      <code>
        تحدث مع Mind
      </code>
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        data-z-index
      </code>
    </td>
    
    <td>
      قيمة CSS z-index للأداة
    </td>
    
    <td>
      <code>
        999999
      </code>
    </td>
  </tr>
</tbody>
</table>

**JavaScript API:**

```javascript
// Control the widget
ArtOfXChatWidget.open();
ArtOfXChatWidget.close();
ArtOfXChatWidget.toggle();

// Events
ArtOfXChatWidget.on('message', (data) => {
  console.log(data.role, data.content);
});

// Clear history
ArtOfXChatWidget.clearHistory();
```

استخدم `ArtOfXChatWidget.open()` من زر موقعك الخاص إذا أردت مشغّلاً مخصصاً.

`ArtOfXWidget` يبقى اسماً بديلاً متوافقاً مع الإصدارات السابقة لواجهة API نفسها.

---

## استكشاف الأخطاء وإصلاحها

**أدوات MCP لا تظهر في عميلك**
أزل الموصّل وأعد إضافته، ثم أكمل مسار OAuth من جديد. بعض العملاء يخزّنون مؤقتاً قائمة أدوات فارغة من أول اتصال فاشل.

**خطأ "401 Unauthorized" مع API key**
تحقق من أن المفتاح يُرسل كرمز Bearer وأنه يبدأ بـ `minds_` (Settings ← API Keys).

**الأداة لا تظهر على موقعك**
تحقق من أن `data-widget-id` يطابق المعرّف الموجود في Settings ← Integrations ← Embed Widget، وأن وسم الـ script غير محجوب بمدير موافقات.

---

*التكاملات تجلب Minds إلى حيث تعمل بالفعل. اضبطها مرة واحدة، واستخدمها في كل مكان.*