NueForm

تكامل MCP

اربط منصة الذكاء الاصطناعي المفضلة لديك بـ NueForm عبر Model Context Protocol.

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:

text
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

json
{
  "mcpServers": {
    "nueform": {
      "url": "https://nueform.io/api/mcp"
    }
  }
}

أعد تشغيل Claude Desktop. سيُطلب منك تسجيل الدخول بحسابك في NueForm عند أول استخدام.

Claude Code (CLI)

شغّل الأمر التالي:

bash
claude mcp add nueform --transport http https://nueform.io/api/mcp

أو أضفه إلى ملف .claude/settings.json:

json
{
  "mcpServers": {
    "nueform": {
      "url": "https://nueform.io/api/mcp"
    }
  }
}

Cursor

أضفه إلى .cursor/mcp.json في جذر مشروعك (أو في الإعدادات العامة):

json
{
  "mcpServers": {
    "nueform": {
      "url": "https://nueform.io/api/mcp"
    }
  }
}

Windsurf

أضفه إلى إعدادات MCP في Windsurf:

json
{
  "mcpServers": {
    "nueform": {
      "url": "https://nueform.io/api/mcp"
    }
  }
}

VS Code (GitHub Copilot)

أضفه إلى .vscode/mcp.json في مساحة العمل:

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_mergeAudio Merge: نص واحد فيه عناصر نائبة {variable} وصف من القيم لكل مقطع؛ يصبح كل صف مقطعًا مستقلًا في مكتبتك. الصفوف التي تنقصها قيمة تُتخطّى ولا تُحتسب. ينفق رصيدًا (يحتاج إلى max_credits)
studio_audio_merge_statusمجانًا: تقدّم الدفعة (المقاطع المكتملة والفاشلة والمتبقية) والرصيد المستخدم
studio_voice_dropVoice Drop: رسالة صوتية إلى الهواتف. مستلم واحد مع recipient_expects_message: true يعني مكالمة شخصية؛ وما عدا ذلك يُرسل برسالة نصية أولًا إلى أرقام الولايات المتحدة وكندا، ويُتصل بمن يردّ بكلمة CALL وبالأرقام التي لا تصلها رسائلنا النصية (خارج الولايات المتحدة وكندا، إن كانت خطتك تسمح بالاتصال بها). يحتاج إلى أول عملية شراء للرصيد وبريد إلكتروني موثّق. ينفق رصيدًا (يحتاج إلى max_credits)
studio_voice_drop_statusمجانًا: حالة التسليم لكل مستلم، بمكالمة أو رسالة نصية، أو عدم التسليم وما أُعيد من رصيد
studio_time_capsuleTime Capsule: رسائل تُسلَّم في الأيام التي تختارها، الساعة 9:00 بتوقيت المستلم، بمكالمة أو رسالة نصية أو بريد إلكتروني. تحتاج المكالمة إلى recipient_expects_message: true. ينفق رصيدًا (يحتاج إلى max_credits)
studio_podcastPodcast from Anything: حلقة بمقدّمَين من رابط أو نص. يُكتب السيناريو مجانًا؛ ولا تُصنع الحلقة إلا إذا كانت تكلفتها الدقيقة ضمن max_credits
studio_talking_qrTalking 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 طلبات. إذا أرسلت طلبات كثيرة متتالية، فقد يحتاج مساعدك الذكي إلى الانتظار بين الاستدعاءات.

آخر تحديث: 22 نوفمبر 2026