mirror of
https://github.com/crewAIInc/crewAI.git
synced 2026-04-30 23:02:50 +00:00
137 lines
8.3 KiB
Plaintext
137 lines
8.3 KiB
Plaintext
---
|
|
title: "خوادم MCP المخصصة"
|
|
description: "اربط خوادم MCP الخاصة بك بـ CrewAI AMP مع وصول عام أو مصادقة بمفتاح API أو OAuth 2.0"
|
|
icon: "plug"
|
|
mode: "wide"
|
|
---
|
|
|
|
يدعم CrewAI AMP الاتصال بأي خادم MCP يُنفّذ [Model Context Protocol](https://modelcontextprotocol.io/). يمكنك إحضار خوادم عامة لا تتطلب مصادقة، وخوادم محمية بمفتاح API أو رمز حامل، وخوادم تستخدم OAuth 2.0 للوصول المفوّض الآمن.
|
|
|
|
## المتطلبات المسبقة
|
|
|
|
<CardGroup cols={2}>
|
|
<Card title="حساب CrewAI AMP" icon="user">
|
|
تحتاج إلى حساب [CrewAI AMP](https://app.crewai.com) نشط.
|
|
</Card>
|
|
<Card title="رابط خادم MCP" icon="link">
|
|
رابط خادم MCP الذي تريد الاتصال به. يجب أن يكون الخادم متاحاً من الإنترنت ويدعم نقل Streamable HTTP.
|
|
</Card>
|
|
</CardGroup>
|
|
|
|
## إضافة خادم MCP مخصص
|
|
|
|
<Steps>
|
|
<Step title="فتح الأدوات والتكاملات">
|
|
انتقل إلى **Tools & Integrations** في الشريط الجانبي الأيسر لـ CrewAI AMP، ثم اختر علامة تبويب **Connections**.
|
|
</Step>
|
|
|
|
<Step title="بدء إضافة خادم MCP مخصص">
|
|
انقر على زر **Add Custom MCP Server**. سيظهر مربع حوار مع نموذج التهيئة.
|
|
</Step>
|
|
|
|
<Step title="ملء المعلومات الأساسية">
|
|
- **Name** (مطلوب): اسم وصفي لخادم MCP (مثل "My Internal Tools Server").
|
|
- **Description**: ملخص اختياري لما يقدمه خادم MCP هذا.
|
|
- **Server URL** (مطلوب): الرابط الكامل لنقطة نهاية خادم MCP (مثل `https://my-server.example.com/mcp`).
|
|
</Step>
|
|
|
|
<Step title="اختيار طريقة المصادقة">
|
|
اختر إحدى طرق المصادقة الثلاث المتاحة بناءً على كيفية تأمين خادم MCP. راجع الأقسام أدناه لتفاصيل كل طريقة.
|
|
</Step>
|
|
|
|
<Step title="إضافة رؤوس مخصصة (اختياري)">
|
|
إذا كان خادم MCP يتطلب رؤوساً إضافية في كل طلب (مثل معرّفات المستأجر أو رؤوس التوجيه)، انقر على **+ Add Header** وقدم اسم الرأس وقيمته. يمكنك إضافة رؤوس مخصصة متعددة.
|
|
</Step>
|
|
|
|
<Step title="إنشاء الاتصال">
|
|
انقر على **Create MCP Server** لحفظ الاتصال. سيظهر خادم MCP المخصص الآن في قائمة الاتصالات وستكون أدواته متاحة للاستخدام في طواقمك.
|
|
</Step>
|
|
</Steps>
|
|
|
|
## طرق المصادقة
|
|
|
|
### بدون مصادقة
|
|
|
|
اختر هذا الخيار عندما يكون خادم MCP متاحاً للجمهور ولا يتطلب أي بيانات اعتماد. هذا شائع للخوادم مفتوحة المصدر أو الخوادم الداخلية العاملة خلف VPN.
|
|
|
|
### رمز المصادقة
|
|
|
|
استخدم هذه الطريقة عندما يكون خادم MCP محمياً بمفتاح API أو رمز حامل.
|
|
|
|
<Frame>
|
|
<img src="/images/enterprise/custom-mcp-auth-token.png" alt="خادم MCP مخصص برمز مصادقة" />
|
|
</Frame>
|
|
|
|
| الحقل | مطلوب | الوصف |
|
|
|-------|-------|-------|
|
|
| **Header Name** | نعم | اسم رأس HTTP الذي يحمل الرمز (مثل `X-API-Key`، `Authorization`). |
|
|
| **Value** | نعم | مفتاح API أو رمز الحامل الخاص بك. |
|
|
| **Add to** | لا | أين يتم إرفاق بيانات الاعتماد — **Header** (افتراضي) أو **Query parameter**. |
|
|
|
|
<Tip>
|
|
إذا كان خادمك يتوقع رمز `Bearer` في رأس `Authorization`، عيّن Header Name إلى `Authorization` والقيمة إلى `Bearer <your-token>`.
|
|
</Tip>
|
|
|
|
### OAuth 2.0
|
|
|
|
استخدم هذه الطريقة لخوادم MCP التي تتطلب تفويض OAuth 2.0. سيتعامل CrewAI مع تدفق OAuth الكامل، بما في ذلك تحديث الرمز.
|
|
|
|
<Frame>
|
|
<img src="/images/enterprise/custom-mcp-oauth.png" alt="خادم MCP مخصص مع OAuth 2.0" />
|
|
</Frame>
|
|
|
|
| الحقل | مطلوب | الوصف |
|
|
|-------|-------|-------|
|
|
| **Redirect URI** | — | مُعبأ مسبقاً وللقراءة فقط. انسخ هذا الرابط وسجّله كرابط إعادة توجيه مصرّح به في مزود OAuth. |
|
|
| **Authorization Endpoint** | نعم | الرابط الذي يُوجَّه إليه المستخدمون لتفويض الوصول (مثل `https://auth.example.com/oauth/authorize`). |
|
|
| **Token Endpoint** | نعم | الرابط المستخدم لتبادل رمز التفويض برمز وصول (مثل `https://auth.example.com/oauth/token`). |
|
|
| **Client ID** | نعم | معرّف عميل OAuth الصادر من مزودك. |
|
|
| **Client Secret** | لا | سر عميل OAuth. غير مطلوب للعملاء العامين باستخدام PKCE. |
|
|
| **Scopes** | لا | قائمة نطاقات مفصولة بمسافات للطلب (مثل `read write`). |
|
|
| **Token Auth Method** | لا | كيفية إرسال بيانات اعتماد العميل عند تبادل الرموز — **Standard (POST body)** أو **Basic Auth (header)**. الافتراضي هو Standard. |
|
|
| **PKCE Supported** | لا | فعّل إذا كان مزود OAuth يدعم Proof Key for Code Exchange. موصى به لتحسين الأمان. |
|
|
|
|
<Info>
|
|
**اكتشاف تهيئة OAuth**: إذا كان مزود OAuth يدعم OpenID Connect Discovery، انقر على رابط **Discover OAuth Config** لملء نقاط نهاية التفويض والرمز تلقائياً من رابط `/.well-known/openid-configuration` الخاص بالمزود.
|
|
</Info>
|
|
|
|
#### إعداد OAuth 2.0 خطوة بخطوة
|
|
|
|
<Steps>
|
|
<Step title="تسجيل رابط إعادة التوجيه">
|
|
انسخ **Redirect URI** المعروض في النموذج وأضفه كرابط إعادة توجيه مصرّح به في إعدادات تطبيق مزود OAuth.
|
|
</Step>
|
|
|
|
<Step title="إدخال نقاط النهاية وبيانات الاعتماد">
|
|
املأ **Authorization Endpoint** و**Token Endpoint** و**Client ID**، واختيارياً **Client Secret** و**Scopes**.
|
|
</Step>
|
|
|
|
<Step title="تهيئة طريقة تبادل الرمز">
|
|
اختر **Token Auth Method** المناسبة. معظم المزودين يستخدمون الافتراضي **Standard (POST body)**. بعض المزودين القدامى يتطلبون **Basic Auth (header)**.
|
|
</Step>
|
|
|
|
<Step title="تفعيل PKCE (موصى به)">
|
|
حدد **PKCE Supported** إذا كان مزودك يدعمه. يضيف PKCE طبقة أمان إضافية لتدفق رمز التفويض وموصى به لجميع التكاملات الجديدة.
|
|
</Step>
|
|
|
|
<Step title="الإنشاء والتفويض">
|
|
انقر على **Create MCP Server**. سيتم توجيهك إلى مزود OAuth لتفويض الوصول. بمجرد التفويض، سيخزن CrewAI الرموز ويحدّثها تلقائياً حسب الحاجة.
|
|
</Step>
|
|
</Steps>
|
|
|
|
## استخدام خادم MCP المخصص
|
|
|
|
بمجرد الاتصال، تظهر أدوات خادم MCP المخصص جنباً إلى جنب مع الاتصالات المدمجة في صفحة **Tools & Integrations**. يمكنك:
|
|
|
|
- **تعيين الأدوات للوكلاء** في طواقمك تماماً كأي أداة CrewAI أخرى.
|
|
- **إدارة الرؤية** للتحكم في أعضاء الفريق الذين يمكنهم استخدام الخادم.
|
|
- **تعديل أو إزالة** الاتصال في أي وقت من قائمة الاتصالات.
|
|
|
|
<Warning>
|
|
إذا أصبح خادم MCP غير قابل للوصول أو انتهت صلاحية بيانات الاعتماد، ستفشل استدعاءات الأدوات التي تستخدم ذلك الخادم. تأكد من استقرار رابط الخادم وتحديث بيانات الاعتماد.
|
|
</Warning>
|
|
|
|
<Card title="تحتاج مساعدة؟" icon="headset" href="mailto:support@crewai.com">
|
|
تواصل مع فريق الدعم للمساعدة في تهيئة خادم MCP المخصص أو استكشاف الأخطاء.
|
|
</Card>
|