---
title: "Client Setup"
description: "اضبط Minds MCP مع ChatGPT وClaude Desktop وCursor وسائر العملاء."
canonical_url: "https://getminds.ai/mcp/ar/setup"
last_updated: "2026-08-13T13:01:10.903Z"
---

# Client Setup

يربط هذا الدليل [خادم Minds MCP لأبحاث السوق](/mcp/overview) بعملاء الذكاء الاصطناعي الذين يدعمون الأدوات البعيدة. استخدم `https://getminds.ai/mcp` كرابط الخادم.

## ChatGPT

1. افتح **ChatGPT** ← **Settings** ← **Connected Apps**
2. ابحث عن "Minds" أو أضف الـ MCP URL: `https://getminds.ai/mcp`
3. انقر **Connect** وفوِّض عبر OAuth (سجِّل الدخول إلى حساب Minds الخاص بك)
4. ابدأ المحادثة — اطلب من ChatGPT إنشاء Minds وتشغيل panels وتحليل النتائج

يُصيِّر ChatGPT widgets تفاعلية مضمَّنة — نتائج الـ panel مع استجابات مُجمَّعة ومخططات أعمدة وـ avatars Minds قابلة للنقر تظهر مباشرةً في الدردشة.

## Claude Desktop

### Option A: Remote Connector (موصى به — يُفعِّل widgets تفاعلية)

1. افتح Claude Desktop ← **Customize** ← **Connectors** (أو **Settings** ← **Connections**)
2. أضف `https://getminds.ai/mcp` كـ remote connector جديد
3. فوِّض عبر OAuth عند الطلب — سجِّل الدخول إلى حساب Minds الخاص بك
4. تظهر الأدوات تلقائياً بعد التفويض

### Option B: Local Connector (API key، نص فقط)

أضف إلى ملف التهيئة (`~/Library/Application Support/Claude/claude_desktop_config.json` على macOS):

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

أعد تشغيل Claude Desktop. الأدوات تعمل فوراً لكن الـ widgets التفاعلية غير متاحة مع الـ local connectors.

### دعم Widget في Claude

تُرجع الأدوات الخمس عشرة المُعلنة نصاً منظماً وروابط قابلة للنقر. يسجّل الخادم أيضاً 18 أداة قانونية إضافية للتكاملات الصريحة. يعتمد عرض الـ widgets على العميل وإصداره، لذلك يجب أن يبقى التكامل قابلاً للاستخدام من النتائج النصية والمنظمة وحدها.

## 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. أضف خادماً جديداً بالـ URL: `https://getminds.ai/mcp`
3. فوِّض الوصول عند الطلب

## VS Code (GitHub Copilot)

1. افتح VS Code Settings ← **Extensions** ← **GitHub Copilot** ← **MCP Servers**
2. أضف `https://getminds.ai/mcp` كخادم جديد
3. فوِّض عند الطلب

## OpenRouter وOpen WebUI والبوابات المتوافقة مع OpenAI

عندما يقوم **مزود النموذج** (وليس المضيف) بتنفيذ استدعاء MCP من جانب الخادم — مثل نموذج `openai/*` عبر OpenRouter، أو OpenAI Responses API مباشرةً، أو Open WebUI في وضع *Native function-calling* — **يجب** عليك استخدام مصادقة API key. لا يعمل OAuth على هذا المسار.

### لماذا لا يعمل OAuth هنا

عندما يقوم Open WebUI بتشغيل وكيل `openai/gpt-5.2` في وضع Native، فإنه يرسل وصف أداة MCP كجزء من الطلب إلى OpenAI/OpenRouter. ثم يقوم MCP runner من جانب الخادم لـ OpenAI (يعمل على Azure، يمكن تمييزه عبر `User-Agent: python-httpx/*`) باستدعاء نقطة النهاية `/mcp` لدينا مباشرة. هذا الـ runner يرفق فقط الترويسات **الثابتة** المهيّأة عند تسجيل الأداة — ولا يقوم بمصافحة MCP OAuth (RFC 9728 / 8414 / 7591). لذلك فإن وضع *OAuth — يعيد توجيه access token الخاص بمستخدم النظام* في Open WebUI لا يعمل هنا: token المستخدم لا يغادر Open WebUI أبداً.

النتيجة: يتلقى Minds الطلب بدون ترويسة `Authorization` ويعيد:

```text
401 Unauthorized
www-authenticate: Bearer resource_metadata="https://getminds.ai/.well-known/oauth-protected-resource"
{"error":{"code":-32001,"message":"Authentication required. Connect your Minds account via OAuth or provide an API key."}}
```

### إعداد Open WebUI

1. أنشئ مفتاح API في [Settings → API Keys](/settings/api-keys) (الصيغة `minds_…`).
2. في Open WebUI: **Admin ← الإعدادات ← الأدوات ← + اتصال**.
3. الإعدادات:

  - **النوع**: `Streamable HTTP (MCP)`
  - **URL**: `https://getminds.ai/mcp`
  - **المصادقة**: `Bearer` *(ليس OAuth)*
  - **Token**: مفتاحك `minds_…`
4. احفظ الاتصال.
5. في علامة التبويب *الأدوات* لوكيلك، فعّل أداة **Get Minds**.
6. اختبر بأن تطلب من الوكيل سرد Minds الخاصة بك.

إذا أبقيت `المصادقة: OAuth`، فإن الاستدعاءات تنجح فقط عندما ينفّذ Open WebUI الأداة بنفسه (أي *Function calling = Default*، وليس *Native*). معظم المستخدمين يريدون وضع Native — لذا استخدم مفتاح Bearer.

### OpenRouter مباشرة (برمجياً)

عند استدعاء OpenRouter chat completions API مع إرفاق Minds MCP server، مرّر مفتاح API في حقل `headers` الثابت من وصف الأداة:

```json
{
  "type": "mcp",
  "server_label": "minds",
  "server_url": "https://getminds.ai/mcp",
  "headers": {
    "Authorization": "Bearer minds_API_KEY_الخاص_بك"
  }
}
```

نفس الشيء ينطبق على OpenAI Responses API مباشرة:

```python
from openai import OpenAI
client = OpenAI()
client.responses.create(
    model="gpt-5.2",
    input="اعرض Minds الخاصة بي",
    tools=[{
        "type": "mcp",
        "server_label": "minds",
        "server_url": "https://getminds.ai/mcp",
        "headers": {"Authorization": f"Bearer {os.environ['MINDS_API_KEY']}"},
    }],
)
```

## مصادقة API Key

للوصول البرمجي أو العملاء الذين لا يدعمون OAuth:

1. افتح [Settings → API Keys](/settings/api-keys) في Minds
2. أنشئ مفتاح API جديداً (يبدأ بـ `minds_`)
3. مرِّره كـ Bearer token: `Authorization: Bearer minds_your_key_here`

## OAuth Discovery

للمطورين الذين يبنون تكاملات MCP، تتوفر OAuth metadata في:

<table>
<thead>
  <tr>
    <th>
      Endpoint
    </th>
    
    <th>
      Description
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        /.well-known/oauth-protected-resource
      </code>
    </td>
    
    <td>
      Protected resource metadata (RFC 9728)
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        /.well-known/oauth-authorization-server
      </code>
    </td>
    
    <td>
      Authorization server metadata (RFC 8414)
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        /oauth/register
      </code>
    </td>
    
    <td>
      Dynamic Client Registration (RFC 7591)
    </td>
  </tr>
</tbody>
</table>

OAuth 2.1 مع PKCE (S256) مطلوب. العملاء العامون (`token_endpoint_auth_method: "none"`) مدعومون.

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

### خطأ "Authentication required"

تأكد من إكمال تدفق تفويض OAuth. افصل عميل MCP وأعد اتصاله لإعادة التفويض.

إذا كنت تستدعي Minds عبر **OpenRouter أو Open WebUI في وضع Native أو OpenAI Responses API مباشرة**، فإن OAuth غير مدعوم على هذا المسار — لا يستطيع MCP runner من جانب الخادم لمزود النموذج تنفيذ مصافحة OAuth. بدّل اتصال MCP الخاص بك إلى **مصادقة Bearer / API key** بمفتاح `minds_…`. راجع [OpenRouter وOpen WebUI والبوابات المتوافقة مع OpenAI](#openrouter-%D9%88open-webui-%D9%88%D8%A7%D9%84%D8%A8%D9%88%D8%A7%D8%A8%D8%A7%D8%AA-%D8%A7%D9%84%D9%85%D8%AA%D9%88%D8%A7%D9%81%D9%82%D8%A9-%D9%85%D8%B9-openai) أعلاه.

### OAuth في Claude Desktop لا يكتمل

إذا فُتحت نافذة OAuth المنبثقة لكنها لم تكتمل أبداً، جرِّب نهج API key (Option B أعلاه). OAuth في remote connector الخاص بـ Claude Desktop قد يكون متقطعاً.

### Mind غير موجود

عند استخدام `sparkName`، تأكد من أن الاسم يطابق الـ Mind الخاص بك بشكل وثيق. يستخدم النظام fuzzy matching لكنه يتطلب درجة تشابه معقولة.

### Mind لا يزال يتدرب

قد تستغرق الـ Minds الجديدة لحظة لإكمال التدريب. استخدم `get_mind_status` للتحقق من اكتمال التدريب قبل الدردشة.

### انتهاء مهلة سؤال الـ Panel

أسئلة الـ panel مع groups كثيرة قد تستغرق أكثر من دقيقتين. حاول تقليل عدد الـ groups أو تبسيط السؤال.

### تصدير PDF غير جاهز

تُولَّد تقارير PDF بشكل غير متزامن. استخدم `get_panel_status` للتحقق من حالة التصدير. عادةً ما يستغرق التوليد 30-60 ثانية.