# IaGenify SDK 0.3.0: اربط الوكلاء بخوادم MCP التي تختارها.

Canonical URL: https://www.iagenify.com/ar/news/iagenify-sdk-mcp-client

أصبح SDK عميلاً لـ MCP: اربط الخوادم المتوافقة، واختر الأدوات المتاحة، واستخدمها من دون إنشاء محوّل خاص بكل مزود.

## Key points
- يمكن ربط خادم MCP متوافق عبر واجهة موحدة في SDK.
- يمكن تحديد قائمة الأدوات المسموح بها بدلاً من تفعيل كل شيء تلقائياً.
- تستخدم الوكلاء الخوادم المختارة، كما تتاح تعريفات الأدوات لمن يبني حلقة نموذج خاصة به.

تتحدث أدوات مفيدة كثيرة بالفعل بروتوكول MCP. وكان استخدامها عبر SDK يتطلب غالباً محوّلاً لكل مزود وطريقة مستقلة لترجمة تعريفات الأدوات. يضيف IaGenify SDK 0.3.0 عميلاً لـ MCP لربط الخوادم المتوافقة عبر واجهة واحدة.

## اربط مرة واحدة واختر الأدوات المتاحة

تتضمن الوصلة عنوان الخادم ويمكن أن تتضمن رمز المصادقة. يختار المطور الأدوات التي يريد إتاحتها. إذا لم تُحدّد قائمة، فلن تُفعّل أي أداة؛ ويظل الوصول صريحاً.


```
await api.mcp.connect({
  name: "team-tools",
  url: "https://tools.example.com/mcp",
  token: process.env.TOOLS_TOKEN,
  tools: ["search", "get_record"],
});
```

يستخدم المثال خادماً عاماً. في التطبيق الحقيقي، تحفظ بيانات الدخول في مخزن أسرار بيئة التشغيل، لا في حزمة المتصفح أو مقال أو مستودع الشيفرة.

## امنح الوكيل مجموعة أدوات محددة

بعد ربط الخادم، يمكن للوكيل استخدام أدواته. ويمكن للمطور أيضاً جلب تعريفات MCP وتمريرها إلى حلقة النموذج الخاصة به من دون استخدام محرك الوكلاء في SDK.


```
const agent = api.agents.create({
  runtime: "local",
  machine,
  model: "your-model",
  mcp: ["team-tools"],
});

const definitions = await api.mcp.tools();
```

يجعل الخيار `mcp` الاختيار واضحاً عند إنشاء الوكيل. عند حذفه تُستخدم الخوادم المرتبطة بالحساب، أما القائمة الفارغة فتعني صراحةً عدم استخدام أي خادم.

## تبقى الأذونات جزءاً من التكامل

يسهّل MCP ربط الأدوات، لكنه لا يلغي ضرورة فهم صلاحياتها. يلتزم SDK بأذونات الخادم ووضع تشغيل الوكيل. وينبغي للتطبيق قصر الخوادم والعمليات على ما تحتاج إليه المهمة.

يفيد ذلك الفرق التي تستخدم خادم MCP بالفعل: يمكنها إعادة استخدام واجهة البروتوكول، واختيار الأدوات المسموحة، وترك الخادم القائم يصف عملياته.

## بروتوكول واحد وطريقتان للاستخدام

تريد بعض التطبيقات أن يدير IaGenify حلقة الوكيل؛ ولدى تطبيقات أخرى تنسيقها الخاص وتحتاج فقط إلى تعريفات الأدوات. يدعم SDK كلا المسارين.

> اربط أدوات فريقك الحالية، واختر ما يستطيع الوكيل رؤيته، وأبقِ هذا الحد واضحاً في الشيفرة.

يجعل SDK 0.3.0 بروتوكول MCP نوع اتصال أساسياً. يصبح التكامل أسهل، مع بقاء اختيار الأدوات والأذونات بيد التطبيق.

## FAQ
### هل أحتاج إلى محوّل IaGenify لكل خادم MCP؟
لا. يربط SDK الخوادم المتوافقة عبر واجهة عميل موحدة.

### هل تُفعّل كل الأدوات عند ربط الخادم؟
لا. يمكنك تحديد قائمة صريحة، ومن دونها لا تُفعّل أي أداة افتراضياً.

### هل يمكن استخدام MCP من دون `api.agents`؟
نعم. توفر `api.mcp.tools()` تعريفات الأدوات لحلقة نموذج خاصة بك.

### أين أحفظ رمز MCP؟
في مخزن أسرار على الخادم أو إعدادات بيئة التشغيل، وليس في شيفرة المتصفح أو المستودع.