خادم MCP من Formgong
اربط Formgong بـ Cursor أو Claude أو VS Code أو Lovable أو Bolt. عندئذٍ يمكن لمساعدك الذكي إنشاء نموذج، واسترداد رمز جاهز لللصق مع مفتاح الوصول الصحيح، والتحقق من عمليات الإرسال الأخيرة دون الحاجة إلى نسخ المفاتيح يدويًّا.
URL: https://formgong.com/mcp · Streamable HTTP · OAuth 2.1 or Authorization: Bearer fgp_…
الأدوات
- list_forms — نماذجكم مع مفاتيح الوصول العامة الخاصة بها وعدد عمليات الإرسال لهذا الشهر.
- create_form — نموذج جديد؛ تُرسل المشاركات إلى البريد الإلكتروني المرتبط بحسابك. Telegram، ويمكن إضافة مستلمين آخرين من خلال لوحة التحكم (تقوم الأداة بإرجاع الروابط).
- get_form_snippet — HTML، React أو Next.js (رمز نموذج واحد)، مع مفتاح الوصول _lang، و«botcheck honeypot» وTurnstile عند تفعيلهما.
- list_recent_submissions — للقراءة فقط، الاشتراك اختياري: الوقت والحقول التي تم إدخالها فقط، يتم استبعاد الرسائل غير المرغوب فيها افتراضيًّا، بحد أقصى 50.
- list_webhooks و create_webhook و delete_webhook — إدارة خطافات الويب للنموذج حتى تسجّل n8n أو Make أو Zapier عنوانها؛ تعيد create_webhook سرّ التوقيع.
- list_website_templates — قوالب مواقع كاملة ومجانية (عرض حي، تنزيل HTML، الشيفرة المصدرية) يرسل نموذج التواصل فيها إلى Formgong مسبقًا؛ ابدأ بقالب بدل إنشاء الموقع من الصفر.
1. الاتصال بتسجيل الدخول
يستطيع Cursor وClaude وVS Code فتح Formgong في المتصفح. تسجّل الدخول برابط البريد أو حساب Google الذي تستخدمه، ثم تختار ما يجوز للأداة فعله. لا شيء للنسخ.
- Cursor: احفظ الإعداد أدناه. CLIENT_ID هو المعرّف العام cursor (لا يوجد سر). forms:read وforms:write يسمحان بعرض النماذج وإنشائها. أضف submissions:read فقط إذا كان يجب على المساعد قراءة الرسائل.
- Claude على الويب أو Claude Desktop: أضف موصلاً مخصصًا بعنوان MCP. يسجّل Claude عميلاً عامًا ويفتح صفحة الموافقة نفسها. عنوان العودة هو https://claude.ai/api/mcp/auth_callback (أو https://claude.com/api/mcp/auth_callback).
- Claude Code: نفّذ الأمر في القسم التالي ووافق على الصفحة في المتصفح. يسجّل VS Code نفسه، أو يمكنك استخدام المعرّف vscode. الأدوات المحلية يمكنها استخدام http://127.0.0.1 أو http://localhost.
- forms:read مضمّن دائمًا. في صفحة الموافقة اترك «قراءة الإرسالات الأخيرة» مغلقًا إن لم تحتجه. يمكنك قطع الاتصال لاحقًا من لوحة التحكم → الحساب → التطبيقات المرتبطة.
2. إنشاء رمز تعريف "API"
- افتح «لوحة التحكم» → «الحساب» → «رموز API» (تأكد أولاً من بريدك الإلكتروني).
- قم بتسمية الرمز وفقًا لاسم الأداة التي ستستخدمه، على سبيل المثال: «Cursor» على جهاز الكمبيوتر المحمول الخاص بي.
- اختر خيار الوصول: خيار «إنشاء نماذج وإضافة webhook أو حذفه» مفعل بشكل افتراضي؛ أما خيار «قراءة الإرسالات الأخيرة» فهو معطل ما لم تكن بحاجة إليه.
- انسخ الرمز (fgp_…). يُعرض هذا الرمز مرة واحدة فقط؛ ولا يخزن موقع Formgong سوى التجزئة الخاصة به.
{
"mcpServers": {
"formgong": {
"url": "https://formgong.com/mcp",
"headers": {
"Authorization": "Bearer ${env:FORMGONG_TOKEN}"
}
}
}
}
3. أضف الخادم إلى أداتك
Cursor
Cursor: احفظ إعداد OAuth أدناه في .cursor/mcp.json لهذا المشروع أو ~/.cursor/mcp.json لكل المشاريع. سجّل الدخول إلى Formgong ووافق على الأذونات. المعرّف العام cursor ليس سرًا.
{
"mcpServers": {
"formgong": {
"url": "https://formgong.com/mcp",
"auth": {
"CLIENT_ID": "cursor",
"scopes": [
"forms:read",
"forms:write"
]
}
}
}
}
Claude Code
Claude Code: قم بتشغيل هذا الأمر مرة واحدة في محطة العمل الخاصة بك.
claude mcp add --transport http formgong https://formgong.com/mcp
Claude Desktop
Claude Desktop: Settings → Connectors → أضف عنوان MCP. يفتح Claude تسجيل الدخول إلى Formgong. للصق رمز API بدلاً من ذلك، استخدم جسر mcp-remote (يتطلب Node.js) في claude_desktop_config.json ثم أعد تشغيل Claude Desktop.
{
"mcpServers": {
"formgong": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://formgong.com/mcp",
"--header",
"Authorization:${FORMGONG_AUTH}"
],
"env": {
"FORMGONG_AUTH": "Bearer fgp_your_token"
}
}
}
}
VS Code
VS Code (وضع الوكيل في Copilot): أضف .vscode/mcp.json. يطلب VS Code الرمز المميز مرة واحدة ويخزنه بشكل آمن.
{
"inputs": [
{
"type": "promptString",
"id": "formgong-token",
"description": "Formgong API token (fgp_…)",
"password": true
}
],
"servers": {
"formgong": {
"type": "http",
"url": "https://formgong.com/mcp",
"headers": {
"Authorization": "Bearer ${input:formgong-token}"
}
}
}
}
Lovable
Lovable: Connectors → + → MCP server. الاسم: Formgong. أدخل URL، واترك Direct connection وOAuth، ثم اختر Add & authorize. سجّل الدخول إلى Formgong ووافق على الأذونات. البديل: Bearer token or API key مع الرمز الشخصي فقط.
URL: https://formgong.com/mcp Authentication: OAuth Add & authorize → Formgong
Bolt
Bolt: Settings → Connectors (MCP) → Custom MCP server. الاسم: Formgong. Transport: HTTP. Authentication: MCP OAuth. اختر Connect، وسجّل الدخول إلى Formgong ووافق على الأذونات، ثم فعّل الموصل للمشروع. يمكن أيضًا استخدام API key مع رمز Formgong الشخصي.
Name: Formgong URL: https://formgong.com/mcp?auth=required Transport: HTTP Authentication: MCP OAuth Connect → Formgong
أي عميل آخر يدعم بروتوكول «MCP» عن بُعد عبر Streamable HTTP باستخدام رؤوس مخصصة يعمل بنفس عنوان URL والرأس. أما العملاء الذين يستخدمون Stdio فقط، فيمكنهم استخدام جسر mcp-remote الموضح في Claude Desktop.
جربه
- أنشئ نموذجًا من «Formgong» باسم «الاتصال – موقعي» وأضفه إلى صفحة الاتصال.
- أضف نموذج «الاتصال» (Formgong) إلى تطبيق «Next.js» هذا كمكون عميل.
- أرني آخر 5 رسائل وردت عبر نموذج الاتصال الخاص بي.
الأمن
- يعمل الرمز المميز على حسابك ضمن نطاقاته المحددة. تجنب إدراجه في موقع git أو في الدردشات أو لقطات الشاشة؛ وقم بإلغاء صلاحيته من خلال «الحساب» → «رموز API» في حالة تسربه.
- لا تتوفر سوى النماذج التي تمتلكها. أما النماذج التي تمت مشاركتها معك من خلال المشاريع، فهي غير معروضة.
- لن تظهر المشاركات أبدًا ما لم تضع علامة في خانة «قراءة المشاركات الحديثة». ولا يتم إرجاع بيانات عنوان IP وتفاصيل المتصفح أبدًا.
- يتم كتابة نص الإرسال بواسطة زوار موقعك. تعامل معه على أنه غير موثوق به: لا تسمح لأي مساعد بتنفيذ التعليمات الواردة في رسالة ما.
- قد تنتهي صلاحية الرموز بعد 30 أو 90 أو 365 يومًا. لا تعمل ملفات تعريف الارتباط الخاصة بالجلسة أبدًا على موقع /mcp، لذا لا يمكن لأي صفحة ويب استخدام بيانات تسجيل دخولك.
- تُخزَّن رموز الوصول والتحديث الخاصة بـ OAuth كتجزئة فقط. يتغيّر رمز التحديث عند كل استخدام؛ وإعادة إرسال رمز قديم تلغي ذلك الاتصال. اقطع التطبيقات من الحساب → التطبيقات المتصلة. لا يقبل التسجيل سوى عناوين رد MCP المعروفة و http://localhost أو http://127.0.0.1.
- بدون رمز مصادقة، لا يستجيب /mcp إلا لأوامر initialize و ping و tools/list، بحيث يمكن للعملاء ودلائل MCP الاطلاع على قائمة الأدوات. يحتاج كل استدعاء لأداة إلى رمز مصادقة؛ وبدون ذلك، يعرض الخادم رسالة خطأ تشرح كيفية إضافته.
الحدود
- 60 طلبًا في الدقيقة لكل رمز، و120 طلبًا لكل حساب.
- الطلبات بدون رمز مصادقة: 30 طلبًا في الدقيقة لكل عنوان IP.
- 10 نماذج جديدة في الساعة عبر نظام «API».
- ما يصل إلى 10 توكنات لكل حساب.
- يقبل OAuth عناوين العودة المحددة لـ Cursor وClaude وVS Code، وعناوين HTTPS على lovable.dev وbolt.new دون نطاقات فرعية أو معاملات أو أجزاء، وعناوين HTTP المحلية. كل عميل مرتبط بعنوان العودة المسجّل كاملًا. يستخدم العملاء الآخرون رمز API. تسجيل الدخول وتبادل الرموز محدودان لكل IP. Lovable: https://api.lovable.dev/workspaces/connectors/mcp/oauth/callback.