دليل MCP

اجعل مساعدك يستخدم أنظمتك

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

اختر نوع عملك

كيف يعمل

MCP (بروتوكول سياق النموذج) معيار مفتوح لربط مساعدي الذكاء الاصطناعي ببرامج أخرى. يقدّم خادم MCP قائمة أدوات مثل find_slots أو my_orders. تربطه مرة واحدة في MagizAI، وتختار الأدوات المسموح للمساعد باستخدامها، ثم يستدعيها كلما احتاج سؤال الزائر إليها.

01
الربط
المهارات، ثم خوادم MCP. الصق عنوان https والرمز. يقرأ MagizAI قائمة الأدوات.
02
اختيار الأدوات
اضغط إدارة. حدّد الأدوات المطلوبة. الأداة غير المحددة لا تُستدعى أبدًا.
03
آمنة أو حساسة
الأداة الآمنة تعمل فورًا. الأداة الحساسة تنتظر أن يكتب الزائر رمزًا من ستة أرقام، فلا يتغير شيء دون موافقته.
04
ربط الحسابات بتسجيل الدخول
للأداة التي تقرأ بيانات عميل واحد، اضبط وسيط البريد أو الحساب على «تُملأ من الزائر المسجّل». عندها لا يؤخذ أبدًا من المحادثة.

الحدود التي يجب مراعاتها

هذه هي الحدود الفعلية في MagizAI. الخادم المبني ضمنها يعمل من المرة الأولى.

الحد	القيمة	ماذا يعني لك
النقل	Streamable HTTP عبر https	يجب أن يكون العنوان عامًا. الخوادم التي تعمل على جهاز فقط (stdio) لا يمكن ربطها.
تسجيل الدخول	بدون، رمز Bearer، ترويسة مخصصة، أو اسم مستخدم وكلمة مرور	الخدمات التي لا تقبل إلا تسجيل دخول OAuth لا يمكن ربطها بعد.
مدة الاستدعاء	10 ثوانٍ	الزائر ينتظر الرد. أجب من فهرس أو ذاكرة مؤقتة، لا من تقرير بطيء.
ما يقرؤه المساعد من النتيجة	أول 1500 حرف	أعد نصًا قصيرًا ودقيقًا: خمس نتائج بأهم المعلومات، لا سجلًا كاملًا.
الأدوات لكل خادم	50	خادم واحد لكل مهمة. أدوات قليلة وواضحة أفضل من أدوات كثيرة متداخلة.
الوسائط	نص، أرقام، صح/خطأ، خيارات ثابتة، قوائم بسيطة	oneOf و$ref وpattern وقوائم الكائنات غير مدعومة بعد. الأداة التي تستخدمها تظهر «لا يمكن استخدامها».
الخوادم لكل مساحة عمل	حسب خطتك	تعرض صفحة المهارات ثم خوادم MCP العدد الذي تسمح به خطتك.

العملاء المسجّلون

أدوات مثل «طلباتي» أو «مواعيدي» يجب ألا تعرض إلا بيانات العميل المسجّل نفسه. يحقق MagizAI ذلك برمز هوية موقَّع من موقعك، لا بما يكتبه الزائر.

في MagizAI، افتح روبوت المحادثة، ثم هوية الزائر الموقَّعة، وأنشئ سرًّا. احتفظ به على خادمك.
عندما يسجّل العميل دخوله إلى موقعك، يوقّع خادمك رمزًا قصيرًا (HS256) يحوي بريده ووقت انتهاء، ويضعه في وسم الأداة ضمن data-identity.
في إعدادات أداة MCP، اضبط وسيط البريد على «تُملأ من الزائر المسجّل». يملؤه MagizAI من الرمز الموثَّق ويرفض الاستدعاء إن لم يكن الزائر مسجّلًا.

<?php
// On your server, for the signed-in customer. $secret comes from the chatbot's
// "Signed visitor identity" setting and never goes to the browser.
function magiz_identity(string $email, string $name, string $secret): string
{
    $b64 = fn ($s) => rtrim(strtr(base64_encode($s), '+/', '-_'), '=');
    $head = $b64(json_encode(['alg' => 'HS256', 'typ' => 'JWT']));
    $body = $b64(json_encode([
        'email' => $email,
        'name'  => $name,
        'iat'   => time(),
        'exp'   => time() + 3600,
    ]));
    return "$head.$body." . $b64(hash_hmac('sha256', "$head.$body", $secret, true));
}
?>
<script src="https://magiz.ai/widget.js" data-key="YOUR_WIDGET_KEY"
        data-identity="<?= magiz_identity($user->email, $user->name, $secret) ?>" defer></script>

يجب أن يحوي الرمز exp وألا تزيد مدته عن 24 ساعة. السرّ لا يوضع في المتصفح أبدًا، بل الرمز النهائي فقط. مواقع WHMCS تحصل على ذلك تلقائيًا عبر وحدة WHMCS.

أمثلة حسب نوع العمل

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

استضافة المواقع

MagizAI لهذا النوع من الأعمال

استخدم وحدة WHMCS. شركات الاستضافة لا تحتاج خادم MCP: وحدة MagizAI لـ WHMCS تجيب عن الفواتير والخدمات والنطاقات والتذاكر للعملاء المسجّلين، وتعرض خططك على شكل بطاقات.

وحدة WHMCS

أو اربط

Stripe

IPTV والبث

MagizAI لهذا النوع من الأعمال

يسأل المشتركون متى ينتهي اشتراكهم وهل قناة ما مشمولة. يقرأ المساعد ذلك من لوحتك ويجيب في الثانية فجرًا دون تذكرة.

محادثة نموذجية

الزائر: My TV stopped working, is my subscription expired?

المساعد: Your Family package is active until the 24th and 2 of your 3 devices are in use, so it hasn't expired. Try restarting the app on the TV.

الزائر: Do you have 4K sports?

المساعد: Sports 4K is in the Premium package (Rs 899 a month, 5 devices).

اضبط الأدوات هكذا

packagesآمنة
find_channelآمنة
my_subscriptionآمنة· email تُملأ من الزائر المسجّل

برنامج البداية

تنزيل magizai-mcp-iptv.zip · 9 KB

SHA-256 14f5a08449fb90bbbab4956b82dd061d376d84b01a45d29807be09d590741964

أو اربط

n8n Stripe

العيادات

MagizAI لهذا النوع من الأعمال

يرى المرضى المواعيد الشاغرة الحقيقية ويحجزونها. ويرى المسجّلون منهم مواعيدهم القادمة.

محادثة نموذجية

الزائر: Can I see a doctor tomorrow morning?

المساعد: Yes. Tomorrow Dr. Aisha Rather is free at 09:00 and 09:20, and Dr. Imran Shah (children) at 10:00. Which one suits you?

الزائر: 9:20 with Dr. Rather please, it's for a cough. I'm Sara Ahmed, sara@example.com

المساعد: To book 09:20 tomorrow with Dr. Aisha Rather, please type the code 482915 to confirm.

الزائر: 482915

المساعد: You're booked for 09:20 tomorrow. Your reference is RFC-3A91C2. Please arrive 10 minutes early.

اضبط الأدوات هكذا

clinic_infoآمنة
find_slotsآمنة
request_bookingحساسة
my_appointmentsآمنة· patient_email تُملأ من الزائر المسجّل

برنامج البداية

تنزيل magizai-mcp-clinic.zip · 10 KB

SHA-256 8f9cf73d524e9d4e14f52745bf5180fd864899c20ce631461b6b38e86ee7ce03

أو اربط

n8n Zapier

عيادات الأسنان

MagizAI لهذا النوع من الأعمال

يسأل المرضى عن تكلفة العلاج وأوقات الفراغ، ويطلبون موعدًا من المحادثة.

محادثة نموذجية

الزائر: How much is a root canal?

المساعد: A root canal starts at Rs 6,000 per tooth and usually takes two visits. The crown is extra. Would you like a free time to come in?

الزائر: Yes, tomorrow afternoon if possible

المساعد: Tomorrow Dr. Nida Wani is free at 12:30 and Dr. Omar Lone at 17:00. Which one works for you?

اضبط الأدوات هكذا

treatment_pricesآمنة
find_slotsآمنة
request_appointmentحساسة

برنامج البداية

تنزيل magizai-mcp-dental.zip · 9 KB

SHA-256 60dfa4b72880d5760d9081c4cff5edde6d1503d3ac4b4895ecd88de292ca2f69

أو اربط

n8n Zapier

التعليم

MagizAI لهذا النوع من الأعمال

يبحث الطلاب عن الدورات حسب المادة وتاريخ البدء، ويتابع المتقدمون المسجّلون حالة طلباتهم.

محادثة نموذجية

الزائر: When does the Python course start and are there seats?

المساعد: Data science with Python (DS201) starts in about a month, runs 16 weeks on Tuesdays and Thursdays 18:00-20:00, and costs Rs 24,000. Only 3 seats are left.

الزائر: I applied already, what's my status?

المساعد: Your application APP-2231 needs one document: please upload your class 12 marksheet in the student portal.

اضبط الأدوات هكذا

find_coursesآمنة
my_applicationsآمنة· email تُملأ من الزائر المسجّل

برنامج البداية

تنزيل magizai-mcp-education.zip · 9 KB

SHA-256 224fd0609f46b61e8b160277c8ad3bb66aaa195f4519efa7943d477bd8aa19cd

أو اربط

Airtable Zapier

التجارة الإلكترونية

MagizAI لهذا النوع من الأعمال

يتحقق المتسوقون من السعر والمخزون والمقاسات، ويتتبع العملاء المسجّلون طلباتهم مع شركة الشحن ورقم التتبع.

محادثة نموذجية

الزائر: Where is my order?

المساعد: Order #1042 (Rs 7,450) shipped 3 days ago with Delhivery, tracking DLV778812. Order #1051 is being packed now.

الزائر: Is the rose pashmina back in stock?

المساعد: The rose pashmina is out of stock at the moment. The natural one is Rs 6,500 and 4 are in stock.

اضبط الأدوات هكذا

product_stockآمنة
store_policyآمنة
my_ordersآمنة· email تُملأ من الزائر المسجّل

برنامج البداية

تنزيل magizai-mcp-ecommerce.zip · 9 KB

SHA-256 d8aa3bdd8a91a371a6cda133261d2192cac461d134752e268707564ae0d8a945

أو اربط

Shopify Storefront Stripe

العقارات

MagizAI لهذا النوع من الأعمال

يبحث المشترون حسب المنطقة والميزانية وعدد الغرف، ويطّلعون على تفاصيل عقار، ويطلبون معاينة.

محادثة نموذجية

الزائر: Any 2 or 3 bedroom flats to rent in Srinagar under 30k?

المساعد: Yes: RE-102, a furnished 2-bedroom in Jawahar Nagar, 1,050 sq ft, Rs 28,000 a month, available now. Want to see it?

الزائر: Yes, Saturday morning

المساعد: I'll request a viewing of RE-102 for Saturday morning. Please type the code 551208 to confirm.

اضبط الأدوات هكذا

search_listingsآمنة
listing_detailsآمنة
request_viewingحساسة

برنامج البداية

تنزيل magizai-mcp-real-estate.zip · 10 KB

SHA-256 d0c1dad84a9d6e405900c053965699b4a2ebcfba303f561def3da12f7413b544

أو اربط

Airtable Make

الفنادق والسفر

MagizAI لهذا النوع من الأعمال

يتحقق الضيوف من الغرف المتاحة لتواريخهم، ويقارنون الرحلات، ويرسلون طلب حجز.

محادثة نموذجية

الزائر: Room for 2 from next Friday for 3 nights?

المساعد: Yes. A deluxe double with lake view is Rs 4,500 a night, Rs 13,500 for 3 nights, breakfast included. The houseboat room is Rs 6,500 a night with dinner too. Which would you like?

الزائر: What Gulmarg trips do you have?

المساعد: The Srinagar and Gulmarg package is 4 nights at Rs 18,500 per person, with a houseboat night, the Gulmarg day trip with gondola tickets and airport transfers.

اضبط الأدوات هكذا

check_availabilityآمنة
tour_packagesآمنة
request_bookingحساسة

برنامج البداية

تنزيل magizai-mcp-hotel.zip · 10 KB

SHA-256 fd27c3ea208e91ec02b500aca0dfefe6b24b06213a6d70dd80b00298bbbe0c95

أو اربط

Make n8n

الوكالات

MagizAI لهذا النوع من الأعمال

يرى العملاء المحتملون خدماتك وأسعارها الابتدائية. ويرى العملاء المسجّلون مرحلة مشروعهم والمحطة التالية ومسؤولهم.

محادثة نموذجية

الزائر: What's happening with our website project?

المساعد: The new company website (PRJ-310) is in design review. The next step is your homepage design sign-off, due in 3 days. Mehak is managing it.

اضبط الأدوات هكذا

servicesآمنة
my_projectsآمنة· email تُملأ من الزائر المسجّل

برنامج البداية

تنزيل magizai-mcp-agency.zip · 8 KB

SHA-256 ce433a86b097aed3a901946d19693087a7db3c9053447dd1f99435f440d7c4be

أو اربط

Zapier Atlassian

المال والتأمين

MagizAI لهذا النوع من الأعمال

يقارن الزوار التغطيات. ويرى العملاء المسجّلون مواعيد التجديد وحالة المطالبة دون اتصال.

محادثة نموذجية

الزائر: Where is my hospital claim?

المساعد: Claim CLM-5501 (Rs 42,000) on your Family Health Shield policy is under review. Our assessor will call you within 2 working days.

الزائر: When does my health policy renew?

المساعد: POL-88120 renews in about 40 days. The premium is Rs 14,500.

اضبط الأدوات هكذا

productsآمنة
my_policiesآمنة· email تُملأ من الزائر المسجّل
my_claimsآمنة· email تُملأ من الزائر المسجّل

برنامج البداية

تنزيل magizai-mcp-insurance.zip · 9 KB

SHA-256 f07d4b768d2a0fc51722111a98ae5c2f3bb2961992bc3f45f4a9b5db0010ec31

أو اربط

Stripe Zapier

البرمجيات وSaaS

MagizAI لهذا النوع من الأعمال

يعرف المستخدمون بوجود عطل معروف قبل فتح تذكرة، ويقارنون الخطط، ويرون مقاعدهم واستهلاكهم.

محادثة نموذجية

الزائر: Our emails aren't arriving

المساعد: There is a known issue right now: some emails are delayed by up to 10 minutes and a fix is in progress. They will arrive.

الزائر: How close are we to our limit?

المساعد: You've used 84,000 of 100,000 requests this month (84%) on the Growth plan, and 7 of 10 seats. It renews in 12 days.

اضبط الأدوات هكذا

service_statusآمنة
plansآمنة
my_accountآمنة· email تُملأ من الزائر المسجّل

برنامج البداية

تنزيل magizai-mcp-saas.zip · 9 KB

SHA-256 5b8e77ea251d2588cf41fb48e65f715a72dd3f0e5d5c790bcde0bbff2e02ab2d

أو اربط

Stripe Linear

المطاعم

MagizAI لهذا النوع من الأعمال

يقرأ الضيوف قائمة الطعام، ويتحققون من طاولة لهذه الليلة، ويحجزونها، ويرون حجوزاتهم.

محادثة نموذجية

الزائر: What's special today? We're vegetarian.

المساعد: Today's vegetarian special is phirni (Rs 160). For mains, the dum aloo is Rs 320. Would you like a table?

الزائر: Table for 4 tomorrow at 8pm

المساعد: A table for 4 is free tomorrow at 20:00. To reserve it, please type the code 730461.

اضبط الأدوات هكذا

menuآمنة
check_tableآمنة
reserve_tableحساسة
my_reservationsآمنة· email تُملأ من الزائر المسجّل

برنامج البداية

تنزيل magizai-mcp-restaurant.zip · 10 KB

SHA-256 d4ac852d93806ce3417a0610d1eba5fee6fe883b60a3028cb8a7298d892634d4

أو اربط

Zapier Make

أي عمل آخر

MagizAI لهذا النوع من الأعمال

أبسط نقطة بداية: إجابات من جدول معلوماتك (ساعات العمل، الموقع، الدفع) وطلبات معاودة الاتصال.

محادثة نموذجية

الزائر: Are you open on Sunday? Where can I park?

المساعد: We're closed on Sundays; Monday to Saturday we're open 09:30-19:00. There's parking behind the building on Residency Road.

اضبط الأدوات هكذا

business_infoآمنة
request_callbackحساسة

برنامج البداية

تنزيل magizai-mcp-general.zip · 9 KB

SHA-256 cb3994107ab2d6434741a01c7bca0c47aac603d2c6f9b4d9c51f26030c489d99

أو اربط

Zapier n8n

خدمات يمكنك ربطها اليوم

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

الخدمة	العنوان	تسجيل الدخول	مناسبة لـ
Shopify Storefront	https://{your-shop}.myshopify.com/api/mcp https://{your-shop}.myshopify.com/api/ucp/mcp	بدون	البحث عن المنتجات والسلة وسياسات المتجر والأسئلة الشائعة. اربط العنوانين: البحث عن المنتجات في الثاني.
Stripe	https://mcp.stripe.com	Bearer: مفتاح مقيَّد (rk_…)	الاستعلام عن المدفوعات والفواتير والاشتراكات. امنح المفتاح صلاحيات القراءة فقط.
Zapier	https://mcp.zapier.com/api/v1/connect	Bearer: رمز Zapier MCP الخاص بك	أي إجراء تضبطه في Zapier عبر آلاف التطبيقات. أسهل طريق إلى نظام بلا خادم MCP.
Make	https://<منطقتك>/mcp كما يظهر في Make	Bearer: رمز MCP من Make	سيناريوهات Make، كل واحد منها أداة.
n8n	رابط الإنتاج لعقدة «MCP Server Trigger»	Bearer أو ترويسة مخصصة	أي سير عمل تبنيه. n8n المستضاف ذاتيًا يُبقي بيانات العملاء على خادمك، وهذا يناسب العيادات.
Airtable	https://mcp.airtable.com/mcp	Bearer: رمز وصول شخصي	قواعد مثل قائمة الدورات أو العقارات. اقصر الرمز على القواعد التي يحتاجها المساعد.
Linear	https://mcp.linear.app/mcp	Bearer: مفتاح API	المهام والمشاريع، لأسئلة مثل «هل أُصلح الخلل الذي أبلغت عنه؟».
Atlassian	https://mcp.atlassian.com/v2/mcp	اسم المستخدم وكلمة المرور: بريدك ورمز API	Jira وConfluence. يجب أن يسمح مسؤول المؤسسة أولًا بتسجيل الدخول برمز API.

WordPress وWooCommerce

MCP Adapter في WordPress (وMCP في WooCommerce، وهو معاينة للمطورين) يسجّلان الدخول باسم مستخدم WordPress وكلمة مرور تطبيق. اختر «اسم المستخدم وكلمة المرور» في MagizAI. الأدلة الرسمية تستخدم وسيطًا محليًا، فجرّب الربط المباشر على موقع تجريبي أولًا.

غير متاحة بعد

HubSpot وNotion وSquare وCal.com وCalendly لا تقبل إلا تسجيل دخول OAuth على خوادم MCP المستضافة لديها، وهو غير مدعوم في MagizAI بعد. استخدم Zapier أو Make أو n8n بدلًا منها. Supabase يعمل، لكن رمزه يفتح حسابك كله بما في ذلك تنفيذ SQL، فلا تربطه بمساعد يخدم العملاء.

تشغيل برنامج بداية

كل برنامج بداية هو برنامج PHP صغير بلا اعتماديات. يعمل على الاستضافة المشتركة العادية، ويأتي ببيانات تجريبية ليعمل فور رفعه، وفيه ملف واحد tools.php توصله بقاعدة بياناتك. يتطلب PHP 7.4 أو أحدث مع PDO (SQLite للبيانات التجريبية، أو MySQL).

نزّل برنامج البداية لنوع عملك وارفع مجلده إلى موقعك، مثلًا إلى public_html/mcp/.
انسخ config.sample.php إلى config.php وضع في token سرًّا عشوائيًا طويلًا. يرفض الخادم العمل بالرمز التجريبي.
تحقق من أنه يستجيب. الأمر أدناه يجب أن يعرض قائمة الأدوات.

curl -X POST https://yourdomain.com/mcp/index.php \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

في MagizAI، اربطه بعنوان index.php مع مصادقة رمز Bearer، ثم اضبط الأدوات كما في بطاقته.
اسأل مساعدك من المحادثة على موقعك. تعرض «أحدث استدعاءات الأدوات» في صفحة الخادم كل استدعاء.

استخدم بياناتك الحقيقية

اضبط dsn وdb_user وdb_pass في config.php على قاعدة MySQL أو MariaDB لديك، وعدّل SQL في tools.php ليناسب جداولك. كل أداة كتلة واحدة: اسم، وجملة تقول متى تُستخدم، ووسائطها، ودالة تعيد نصًا قصيرًا.

<?php
// tools.php: one block per tool. $db is a PDO connection from config.php.
$server->tool(array(
    'name' => 'my_orders',
    'description' => 'Use when a signed-in customer asks where their order is.',
    'inputSchema' => array('type' => 'object', 'properties' => array(
        'email' => array('type' => 'string', 'maxLength' => 190),
    ), 'required' => array('email')),
    'annotations' => array('readOnlyHint' => true),
    'handler' => function (array $args) use ($db) {
        $q = $db->prepare('SELECT number, status, tracking FROM orders
                           WHERE email = ? ORDER BY placed_on DESC LIMIT 5');
        $q->execute(array($args['email']));
        $out = array();
        foreach ($q->fetchAll() as $o) {
            $out[] = "#{$o['number']}: {$o['status']} {$o['tracking']}";
        }
        return $out ? implode("\n", $out) : 'No orders found.';
    },
));

ملف .htaccess المرفق لا يسمح للويب إلا بالوصول إلى index.php. على nginx أضف القاعدة نفسها بنفسك، وإلا أمكن تنزيل قاعدة البيانات التجريبية.

ابنِ خادمك

أي لغة تصلح إذا كانت تدعم Streamable HTTP. هذه هي الخيارات المحدَّثة.

ابنِ خادمك
PHP / Laravel	laravel/mcp	Mcp::web('/mcp', Server::class)->middleware('auth:sanctum')
PHP	mcp/sdk	composer require mcp/sdk
Python	FastMCP	mcp.run(transport="http") + StaticTokenVerifier
TypeScript	@modelcontextprotocol/server	npm i @modelcontextprotocol/server @modelcontextprotocol/node
Go	modelcontextprotocol/go-sdk	mcp.NewStreamableHTTPHandler(...)

ووردبريس وWooCommerce: ثبّت إضافة بدل البرمجة

متجرك يحمل أصلًا المنتجات والمخزون والطلبات. ثبّت الإضافة، واختر ما يُسمح للمساعد باستخدامه، فيجيب من WooCommerce مباشرة: البحث والمخزون، وكلفة التوصيل لرمز بريدي، وصلاحية كود الخصم، وطلبات العميل المسجَّل وتتبّع شحنته. 32 أداة، دون كتابة أي كود.

تنزيل magizai-wordpress-1.3.0.zip · 72 KB

SHA-256 8a2a40bf78ff83d84e2785f02de937fad8691a85112521c99337f905711efbd5

برنامج بداية لـ Next.js وJavaScript

الفكرة نفسها كبرامج PHP، لكن مكتوبة لـ App Router في Next.js وبلا اعتماديات: العنوان، وسبع أدوات أمثلة (الخطة، الاستهلاك، الفواتير، رابط الفوترة، إعادة تعيين كلمة المرور، تذكرة الدعم)، والكود الذي يوقّع هوية العميل، ونافذة المحادثة التي تتابع تسجيل الدخول والخروج. مُختبَر مع عميل MagizAI نفسه.

تنزيل magizai-mcp-nextjs.zip · 12 KB

SHA-256 91aaa173184890491a46c212eb40865e74f36681cd598eac78231bd5d48fbbb9

قواعد لأدوات تعمل جيدًا

جملة واضحة لكل أداة تقول متى تُستخدم. يختار المساعد الأدوات بقراءة هذه الأوصاف.
علّم أدوات الاستعلام بـ readOnlyHint وكل ما يحذف أو يلغي بـ destructiveHint. لا يسمح MagizAI أبدًا بتعليم أداة مدمِّرة على أنها آمنة.
تحقق من كل وسيط في خادمك أيضًا، واقصر كل استعلام على صفوف العميل المسجّل.
أعد نصًا قصيرًا بالمعلومات اللازمة. لا تُعد أبدًا كلمات مرور أو أرقام بطاقات كاملة أو ملاحظات داخلية.
عامل استدعاء الأداة كأي طلب API عام: تحقق من الرمز، وسجّله، وحدّد معدّله.

حل المشكلات

ما تراه	ما العمل
يجب أن يكون الخادم متاحًا على الإنترنت عبر https.	العنوان خاص أو محلي أو ليس https. ضع الخادم على عنوان https عام.
باقتك لا تشمل خوادم MCP. قم بالترقية لربط خادم.	رقِّ خطتك من الفوترة. تبقى إعدادات الأدوات محفوظة وتعود حين تسمح الخطة بها.
غير قابلة للاستخدام: …	وسائط الأداة تستخدم شكلًا لا يدعمه MagizAI بعد. اقصرها على النص والأرقام وصح/خطأ والخيارات الثابتة والقوائم البسيطة.
تغيّرت على الخادم — راجعها واحفظ لاستخدامها مجددًا	تغيّرت الأداة على الخادم. افتح الخادم وراجع الأداة واحفظ.
يفشل الربط برمز 401	الرمز في MagizAI لا يطابق config.php. على Apache، يمرّر ملف .htaccess المرفق ترويسة Authorization، وبعض المستضيفين يحتاجون ذلك.
«Set a secret token in config.php»	البرنامج ما زال على الرمز التجريبي. ضع رمزًا حقيقيًا في config.php.
«This needs the visitor to be signed in.»	الأداة مرتبطة بالزائر المسجّل، وهذا الزائر غير مسجّل أو فشل رمز هويته. تحقق من هوية الزائر الموقَّعة في روبوت المحادثة.
لا يظهر أي استدعاء	المساعد لا يستخدم أداة أبدًا: تأكد أنها محددة، وأن مهارتها مفعّلة في المهارات، وأن وصفها يقول بوضوح متى تُستخدم.

هل تعثّر الربط؟

أرسل لنا عنوان الخادم وما تراه، وسنخبرك بسبب المشكلة.

تواصل معنا مركز المساعدة

اجعل مساعدك يستخدم أنظمتك

كيف يعمل

الربط

اختيار الأدوات

آمنة أو حساسة

ربط الحسابات بتسجيل الدخول

الحدود التي يجب مراعاتها

العملاء المسجّلون

أمثلة حسب نوع العمل

استضافة المواقع

IPTV والبث

العيادات

عيادات الأسنان

التعليم

التجارة الإلكترونية

العقارات

الفنادق والسفر

الوكالات

المال والتأمين

البرمجيات وSaaS

المطاعم

أي عمل آخر

خدمات يمكنك ربطها اليوم

WordPress وWooCommerce

غير متاحة بعد

تشغيل برنامج بداية

استخدم بياناتك الحقيقية

ابنِ خادمك

ووردبريس وWooCommerce: ثبّت إضافة بدل البرمجة

برنامج بداية لـ Next.js وJavaScript

قواعد لأدوات تعمل جيدًا

حل المشكلات

هل تعثّر الربط؟