Model Context Protocol (MCP) معيار مفتوح يتيح لمساعدي الذكاء الاصطناعي التفاعل مباشرةً مع الخدمات الخارجية. يمنح خادم MCP في NueForm مساعدك الذكي وصولًا كاملًا إلى مساحة عملك: النماذج والردود والتحليلات والفرق وخطافات الويب (Webhooks) وVoice Studio وغير ذلك.
ماذا يمكنك أن تفعل؟
بعد ربط MCP، يمكنك أن تطلب من مساعدك الذكي أشياء مثل:
- "ما معدل الإكمال في كل نماذجي هذا الشهر؟"
- "أنشئ استبيانًا لرضا العملاء بتقييم NPS."
- "صدّر كل ردود الربع الأول بصيغة CSV."
- "أضف sarah@company.com إلى فريق التسويق."
- "ما الأسئلة التي تستغرق أطول وقت للإجابة؟"
- "اقرأ هذا الإعلان بصوت Rosa، ولا تنفق أكثر من 2,000 رصيد."
- "كم رصيدًا تبقّى لي هذا الشهر؟"
يحوّل مساعدك الذكي هذه الطلبات المكتوبة بلغة طبيعية تلقائيًا إلى استدعاءات API المناسبة في NueForm.
المتطلبات
- حساب NueForm (الخطة المجانية تكفي)
- عميل ذكاء اصطناعي متوافق مع MCP (انظر أدلة الإعداد أدناه)
أدلة الإعداد
عنوان URL لخادم MCP في NueForm:
https://nueform.io/api/mcp
تتم المصادقة عبر OAuth: سيفتح عميل الذكاء الاصطناعي نافذة متصفح لتسجّل الدخول بحسابك في NueForm. لا حاجة إلى مفاتيح API.
Claude Desktop
أضف ما يلي إلى ملف claude_desktop_config.json:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"nueform": {
"url": "https://nueform.io/api/mcp"
}
}
}
أعد تشغيل Claude Desktop. سيُطلب منك تسجيل الدخول بحسابك في NueForm عند أول استخدام.
Claude Code (CLI)
شغّل الأمر التالي:
claude mcp add nueform --transport http https://nueform.io/api/mcp
أو أضفه إلى ملف .claude/settings.json:
{
"mcpServers": {
"nueform": {
"url": "https://nueform.io/api/mcp"
}
}
}
Cursor
أضفه إلى .cursor/mcp.json في جذر مشروعك (أو في الإعدادات العامة):
{
"mcpServers": {
"nueform": {
"url": "https://nueform.io/api/mcp"
}
}
}
Windsurf
أضفه إلى إعدادات MCP في Windsurf:
{
"mcpServers": {
"nueform": {
"url": "https://nueform.io/api/mcp"
}
}
}
VS Code (GitHub Copilot)
أضفه إلى .vscode/mcp.json في مساحة العمل:
{
"servers": {
"nueform": {
"url": "https://nueform.io/api/mcp"
}
}
}
عملاء MCP آخرون
يمكن لأي عميل يدعم نقل MCP عبر HTTP Streamable الاتصال بـ NueForm. وجّهه إلى:
- عنوان URL للخادم:
https://nueform.io/api/mcp - المصادقة: OAuth 2.0 (يجب أن يتولى العميل الخطوات تلقائيًا)
الأدوات المتاحة
يوفّر خادم MCP في NueForm 75 أداة في 11 فئة:
النماذج (8 أدوات)
| الأداة | الوصف |
|---|---|
list_forms | سرد النماذج مع البحث والتقسيم إلى صفحات والتصفية |
get_form | الحصول على نموذج بكل أسئلته |
create_form | إنشاء نموذج جديد مع أسئلة اختيارية |
update_form | تحديث إعدادات النموذج وأسئلته (بما في ذلك auto_translate: NueLingo، Pro+) |
delete_form | حذف نموذج وكل بياناته (النموذج الذي فيه عقود موقّعة يحتاج إلى delete_signed_contracts: true، وهذا يحذف العقود نهائيًا أيضًا) |
publish_form | نشر نموذج بالتحققات نفسها التي يجريها زر النشر في المحرر (يُنشئ نسخة؛ ويعيد تحذيرات، أو خطأً يسرد الأسئلة التي يجب إصلاحها) |
unpublish_form | إلغاء نشر نموذج (نماذج الفرق: لمسؤولي الفريق ومالكيه فقط) |
duplicate_form | تكرار نموذج بكل أسئلته |
تُحفظ النماذج كمسودات. تجري publish_form (أو published: true في create_form وupdate_form) التحققات نفسها التي يجريها زر النشر في المحرر: لا ينشر نماذج الفريق إلا مسؤولو الفريق ومالكوه، وتتبع ميزات Pro خطة مالك النموذج، ويجب أن تكون أسئلة الحجز وخطوة البريد الإلكتروني وFuse والأسئلة المركّبة مُعدّة بالكامل. إذا فشل أحد التحققات، لا يُنشر شيء وتعيد الأداة السبب والأسئلة التي يجب إصلاحها وتلميحًا لمساعدك الذكي. النموذج الذي يُنشأ مع published: true يُنشأ رغم ذلك كمسودة عندما يُمنع نشره.
التحليلات (5 أدوات)
| الأداة | الوصف |
|---|---|
get_dashboard_analytics | تحليلات مجمّعة لكل النماذج |
get_form_analytics | تحليلات نموذج محدد |
get_geo_points | بيانات التوزيع الجغرافي للردود |
get_temporal_response | توزيع الردود حسب الساعة |
get_question_timing | بيانات توزيع الوقت لكل سؤال |
الردود (5 أدوات)
| الأداة | الوصف |
|---|---|
list_responses | سرد الردود مع تصفية حسب التاريخ وحالة الإكمال |
get_response | الحصول على رد واحد بكل إجاباته |
delete_response | حذف رد واحد |
export_responses_csv | تصدير كل الردود بصيغة CSV |
bulk_delete_responses | حذف ما يصل إلى 100 رد دفعة واحدة |
خطافات الويب (6 أدوات)
| الأداة | الوصف |
|---|---|
get_form_webhook | الحصول على إعداد خطاف الويب لنموذج |
update_form_webhook | تعيين عنوان URL لخطاف الويب في نموذج أو إزالته |
list_global_webhooks | سرد نقاط نهاية خطافات الويب العامة (Pro+) |
update_global_webhooks | تحديث خطافات الويب العامة (Pro+) |
get_webhook_secret | الحصول على سر توقيع خطافات الويب (Pro+) |
regenerate_webhook_secret | إعادة إنشاء سر التوقيع (Pro+) |
الفرق (12 أداة)
| الأداة | الوصف |
|---|---|
list_teams | سرد كل الفرق التي تنتمي إليها |
create_team | إنشاء فريق جديد |
get_team | الحصول على تفاصيل الفريق وأعضائه |
update_team | تحديث اسم الفريق |
delete_team | حذف فريق (للمالك فقط) |
list_team_members | سرد أعضاء الفريق |
add_team_member | إضافة مستخدم موجود في NueForm عبر بريده الإلكتروني (الدور admin أو editor أو viewer، والافتراضي viewer؛ وmember اسم بديل قديم لـ viewer). لعنوان ليس له حساب، استخدم create_invitation |
update_team_member | تغيير دور عضو (admin أو editor أو viewer؛ وmember اسم بديل قديم لـ viewer) |
remove_team_member | إزالة عضو (يلغي أيضًا دعواته المعلّقة إلى الفريق) |
list_invitations | سرد الدعوات المعلّقة لفريق، الأحدث أولًا، بما فيها الدعوات المنتهية (موسومة بـ expired: لا يمكن قبول الدعوة المنتهية ولم تعد تشغل مقعدًا؛ وتحذفها delete_invitation). لا تُضمَّن رموز الروابط إلا للمالكين (owner) والمسؤولين (admin) |
create_invitation | دعوة شخص عبر بريده الإلكتروني: يرسل NueForm الدعوة (الدور admin أو editor أو viewer، والافتراضي viewer؛ وmember اسم بديل قديم لـ viewer) |
delete_invitation | إلغاء دعوة معلّقة |
جلسات Fuse (9 أدوات)
| الأداة | الوصف |
|---|---|
list_fuse_sessions | سرد جلسات Fuse لنموذج، كل منها بنتائجها المباشرة ومشاركيها |
create_fuse_session | بدء جلسة Fuse لنموذج (تحتفظ بإعداد Fuse للنموذج كما هو الآن) |
get_fuse_session | الحصول على جلسة بنتائجها المباشرة ومشاركيها |
rename_fuse_session | إعادة تسمية جلسة |
pause_fuse_session | إيقاف جلسة نشطة مؤقتًا |
resume_fuse_session | استئناف جلسة متوقفة مؤقتًا |
archive_fuse_session | أرشفة جلسة |
unarchive_fuse_session | إعادة جلسة من الأرشيف |
delete_fuse_session | حذف جلسة مع مشاركيها وإجراءاتها (لا يمكن التراجع عن ذلك) |
المركّبات (6 أدوات)
| الأداة | الوصف |
|---|---|
list_composites | سرد مركّباتك (مجموعات قابلة لإعادة الاستخدام من الحقول الفرعية للأسئلة المركّبة وأسئلة القوائم) |
get_composite | الحصول على مركّب بنسخة العمل وحالة النشر |
create_composite | إنشاء مركّب فارغ كمسودة |
update_composite | استبدال نسخة العمل لمركّب (تبقى النماذج على النسخة المنشورة حتى تنشر) |
publish_composite | نشر نسخة العمل: تعتمدها النماذج التي تستخدم المركّب عند نشرها التالي |
delete_composite | حذف مركّب لم يعد أي نموذج يستخدمه (تبقى الإجابات التي جُمعت) |
عام (6 أدوات)
| الأداة | الوصف |
|---|---|
get_user | الحصول على ملفك الشخصي ومعلومات خطتك |
list_files | سرد الملفات المرفوعة |
get_form_theme | الحصول على إعدادات المظهر لنموذج |
update_form_theme | تحديث الألوان والخطوط والتنسيق |
list_payment_accounts | سرد حساباتك في Stripe Connect وحسابات الدفع بأسمائها، لاستخدامها في أسئلة الدفع |
list_form_versions | سرد النسخ المنشورة لنموذج، الأحدث أولًا |
Voice Studio (8 أدوات)
| الأداة | الوصف |
|---|---|
voice_estimate | مجانًا: ما ستنفقه voice_generate على نص أو سيناريو، ومدة الصوت، وهل يكفي رصيدك |
voice_generate | تحويل نص إلى كلام بصوت واحد، أو قراءة سيناريو بعدة أصوات، والاحتفاظ به في مكتبتك. ينفق رصيدًا (يحتاج إلى max_credits) |
voices_list | أصوات NueForm الجاهزة وأصواتك وأصوات فرقك، مع معرّفات nv_… للتحدث بها |
voice_design | تصميم صوت من وصف: 3 خيارات يقول كل منها جملتك النموذجية. ينفق رصيدًا (يحتاج إلى max_credits) |
voice_save | الاحتفاظ بأحد خيارات التصميم كصوت: 50,000 رصيد ($5). يحتاج إلى max_credits |
voice_clone | استنساخ صوت من تسجيل مدته 30–60 ثانية على رابط عام، مع نصه وrights_confirmed: true: 50,000 رصيد ($5). يحتاج إلى max_credits |
library_list | مكتبتك في Voice Studio أو مكتبة فريق، الأحدث أولًا، مع البحث |
library_get | مقطع واحد، مع رابط تنزيل صالح لمدة 15 دقيقة عندما يصبح الصوت جاهزًا |
عندما تنظّف NueForm تسجيلات الصوت في حسابك، تتضمّن إجابة voice_clone أيضًا sample_cleanup: cleaned (هل صُنعت نسخة منظَّفة)، وused (cleaned أو original: التسجيل الذي صُنع منه الصوت)، وsteps (ما تمّ: noise وhum وrumble وclicks وecho وsibilance وlevel)، وvoice_check (passed أو not_needed أو fell_back، أو skipped عندما تعذّر التنظيف)، وfallback (0 كما خُطّط، 1 تنظيف أخفّ، 2 أُبقي على الأصل). من دون sample_cleanup، استُخدم التسجيل كما هو. تعني echo أنّه تمّ تقليل صدى الغرفة: في هذه الخطوة تُعالَج نسخة من التسجيل على خوادم مزوّد وحدات GPU لدينا (ولا تُحفَظ هناك)، ولا تُستخدم إلّا إذا بقي الصوت كما هو.
Studio Apps (7 أدوات)
| الأداة | الوصف |
|---|---|
studio_audio_merge | Audio Merge: نص واحد فيه عناصر نائبة {variable} وصف من القيم لكل مقطع؛ يصبح كل صف مقطعًا مستقلًا في مكتبتك. الصفوف التي تنقصها قيمة تُتخطّى ولا تُحتسب. ينفق رصيدًا (يحتاج إلى max_credits) |
studio_audio_merge_status | مجانًا: تقدّم الدفعة (المقاطع المكتملة والفاشلة والمتبقية) والرصيد المستخدم |
studio_voice_drop | Voice Drop: رسالة صوتية إلى الهواتف. مستلم واحد مع recipient_expects_message: true يعني مكالمة شخصية؛ وما عدا ذلك يُرسل برسالة نصية أولًا إلى أرقام الولايات المتحدة وكندا، ويُتصل بمن يردّ بكلمة CALL وبالأرقام التي لا تصلها رسائلنا النصية (خارج الولايات المتحدة وكندا، إن كانت خطتك تسمح بالاتصال بها). يحتاج إلى أول عملية شراء للرصيد وبريد إلكتروني موثّق. ينفق رصيدًا (يحتاج إلى max_credits) |
studio_voice_drop_status | مجانًا: حالة التسليم لكل مستلم، بمكالمة أو رسالة نصية، أو عدم التسليم وما أُعيد من رصيد |
studio_time_capsule | Time Capsule: رسائل تُسلَّم في الأيام التي تختارها، الساعة 9:00 بتوقيت المستلم، بمكالمة أو رسالة نصية أو بريد إلكتروني. تحتاج المكالمة إلى recipient_expects_message: true. ينفق رصيدًا (يحتاج إلى max_credits) |
studio_podcast | Podcast from Anything: حلقة بمقدّمَين من رابط أو نص. يُكتب السيناريو مجانًا؛ ولا تُصنع الحلقة إلا إذا كانت تكلفتها الدقيقة ضمن max_credits |
studio_talking_qr | Talking QR: رمز QR قابل للطباعة يشغّل رسالة صوتية عند مسحه. الاستضافة مجانية؛ والكلام الجديد ينفق رصيدًا (يحتاج إلى max_credits) |
الرصيد (3 أدوات)
| الأداة | الوصف |
|---|---|
credits_balance | الرصيد الذي يمكنك إنفاقه الآن، والرصيد المضمَّن هذا الشهر، وما ينتهي قريبًا |
credits_activity | شهر من نشاط الرصيد، الأحدث أولًا: الخصومات والاستردادات التلقائية والمنح |
rate_card | تكلفة كل إجراء بالرصيد |
إنفاق الرصيد
تحتاج الأدوات التي تنفق رصيدًا (voice_generate وvoice_design وvoice_save وvoice_clone وstudio_audio_merge وstudio_voice_drop وstudio_time_capsule وstudio_podcast وstudio_talking_qr) إلى max_credits: أقصى ما يمكن أن ينفقه الاستدعاء (10,000 رصيد = $1). من دونه، أو عندما يكلّف الاستدعاء أكثر، لا يُنفق شيء وتجيب الأداة بالتكلفة الدقيقة، حتى يتمكن مساعدك الذكي من سؤالك أولًا.
- يكلّف الكلام رصيدًا واحدًا لكل حرف منطوق، بأي لغة. إعادة إنشاء المقطع نفسه خلال 30 يومًا مجانية، والسطور التي تفشل يُستردّ رصيدها تلقائيًا.
- يكلّف الصوت الجديد، المصمَّم والمحفوظ أو المستنسخ، 50,000 رصيد ($5).
- تنطبق القواعد نفسها كما في التطبيق: يُفحص النص وفق سياسة الاستخدام قبل أي خصم، ويحتاج حفظ صوت أو استنساخه إلى أول عملية شراء للرصيد وبريد إلكتروني مؤكَّد. لا تستنسخ إلا صوتًا يحق لك استخدامه.
- إذا انتهت مهلة استدعاء، أعد إرساله بالوسائط نفسها و
idempotency_keyنفسه (من 8 إلى 100 حرف أو رقم أو-أو_؛ وكل إجابة تتضمّن المفتاح المستخدم): ستحصل على نتيجة الاستدعاء الأول بدلًا من الدفع مرتين. - روابط الصوت صالحة لمدة 15 دقيقة. وتعطيك
library_getرابطًا جديدًا. - يُدفع الكلام والأصوات الجديدة وStudio Apps التي تُنتج الكلام مما اخترته في الدفع لـ Voice Studio من في محفظتك: أرصدتك الخاصة، ما لم تختر فريقًا (وعندها يصبح الصوت الذي تُنشئه ملكًا للفريق). وتعرض
credits_balanceما يتيح لك ذلك إنفاقه. وتستخدمstudio_voice_dropوstudio_time_capsuleأرصدتك الخاصة دائمًا. وإذا تعذّر على الفريق الدفع، فلا يُنفق شيء وتوضّح الإجابة السبب. - لا يمكن عبر MCP شراء الرصيد أو إهداؤه أو تفعيل الشحن التلقائي: افعل ذلك من المحفظة في NueForm.
للكميات الكبيرة من شيفرتك الخاصة، تحتسب واجهة API للصوت 0.4 رصيد لكل حرف.
أمثلة الاستخدام
تحليل أداء نموذج
أنت: "ما معدل الإكمال لنموذج آراء العملاء هذا الشهر؟"
الذكاء الاصطناعي: يستخدم
get_form_analyticsمع تصفية التاريخ، ثم يجيب: "معدل الإكمال لنموذج آراء العملاء هذا الشهر 73% (219 ردًا مكتملًا من أصل 300). وهذا أعلى من 68% في الشهر الماضي."
إنشاء نموذج
أنت: "أنشئ استبيانًا سريعًا لرضا العملاء من 3 أسئلة: تقييم، ومربع تعليق، وحقل بريد إلكتروني."
الذكاء الاصطناعي: يستخدم
create_formمع قائمة الأسئلة، ثم يؤكد: "تم! أنشأت 'استبيان رضا العملاء' بثلاثة أسئلة. هل تريد أن أنشره؟"
إدارة الردود
أنت: "صدّر كل الردود من نموذج طلب التوظيف بصيغة CSV لأراجعها في جدول بيانات."
الذكاء الاصطناعي: يستخدم
export_responses_csvويعيد بيانات CSV التي يمكنك حفظها في ملف.
إنشاء تعليق صوتي
أنت: "اقرأ مواعيد العمل الجديدة بصوت Rosa، ولا تنفق أكثر من 2,000 رصيد."
الذكاء الاصطناعي: يستخدم
voices_listليجد Rosa، ثمvoice_generateمعmax_credits: 2000، ويجيب: "تم. كلّف ذلك 612 رصيدًا. هذا هو الصوت؛ الرابط صالح لمدة 15 دقيقة."
استكشاف الأخطاء وإصلاحها
"Authentication failed"
تأكد من أنك سجّلت الدخول بحساب NueForm الصحيح. جرّب فصل خادم MCP وإعادة ربطه في عميل الذكاء الاصطناعي.
"Permission denied" في أدوات خطافات الويب أو الفرق
تتطلب بعض الأدوات خطة معينة (Pro أو Enterprise) أو دورًا في الفريق (مسؤول أو مالك). تحقق من خطتك في صفحة الفوترة.
الأدوات لا تظهر
أعد تشغيل عميل الذكاء الاصطناعي بعد إضافة إعداد MCP. تحتاج بعض العملاء إلى إعادة تشغيل كاملة لاكتشاف خوادم MCP الجديدة.
"not_started" من أداة في Voice Studio
لم يُنفق شيء: لم يكن في الاستدعاء max_credits، أو كانت التكلفة أعلى منه. تتضمّن الإجابة التكلفة الدقيقة؛ أعد إرسال الاستدعاء مع max_credits لا يقل عنها.
حدود الطلبات
يطبّق خادم MCP في NueForm حدود الطلبات نفسها في الدقيقة التي تطبّقها REST API (100 طلب في الدقيقة، و500 في Enterprise)، وتُحسب لكل مستخدم وبشكل منفصل عن مفاتيح API الخاصة بك. كل طلب يُحسب، بما في ذلك كل طلب داخل دفعة، ولا تحمل الدفعة أكثر من 10 طلبات. إذا أرسلت طلبات كثيرة متتالية، فقد يحتاج مساعدك الذكي إلى الانتظار بين الاستدعاءات.