خادم MCP من Formgong

اربط Formgong بـ Cursor أو Claude أو VS Code أو Lovable أو Bolt. عندئذٍ يمكن لمساعدك الذكي إنشاء نموذج، واسترداد رمز جاهز لللصق مع مفتاح الوصول الصحيح، والتحقق من عمليات الإرسال الأخيرة دون الحاجة إلى نسخ المفاتيح يدويًّا.

URL: https://formgong.com/mcp · Streamable HTTP · Authorization: Bearer fgp_…

الأدوات

• list_forms — نماذجكم مع مفاتيح الوصول العامة الخاصة بها وعدد عمليات الإرسال لهذا الشهر.
• create_form — نموذج جديد؛ تُرسل المشاركات إلى البريد الإلكتروني المرتبط بحسابك. Telegram، ويمكن إضافة مستلمين آخرين من خلال لوحة التحكم (تقوم الأداة بإرجاع الروابط).
• get_form_snippet — HTML، React أو Next.js (رمز نموذج واحد)، مع مفتاح الوصول _lang، و«botcheck honeypot» وTurnstile عند تفعيلهما.
• list_recent_submissions — للقراءة فقط، الاشتراك اختياري: الوقت والحقول التي تم إدخالها فقط، يتم استبعاد الرسائل غير المرغوب فيها افتراضيًّا، بحد أقصى 50.

1. إنشاء رمز تعريف "API"

1. افتح «لوحة التحكم» → «الحساب» → «رموز API» (تأكد أولاً من بريدك الإلكتروني).
2. قم بتسمية الرمز وفقًا لاسم الأداة التي ستستخدمه، على سبيل المثال: «Cursor» على جهاز الكمبيوتر المحمول الخاص بي.
3. اختر خيار الوصول: خيار «إنشاء نماذج» مفعل بشكل افتراضي؛ أما خيار «قراءة الإرسالات الأخيرة» فهو معطل ما لم تكن بحاجة إليه.
4. انسخ الرمز (fgp_…). يُعرض هذا الرمز مرة واحدة فقط؛ ولا يخزن موقع Formgong سوى التجزئة الخاصة به.

2. أضف الخادم إلى أداتك

Cursor

Cursor: أضف إلى ~/.cursor/mcp.json (جميع المشاريع) أو .cursor/mcp.json (مشروع واحد). قم بتعيين FORMGONG_TOKEN في بيئتك، أو الصق الرمز المميز بدلاً من المتغير في ملف لا تقوم بإدراجه في سجل التغييرات.

{
  "mcpServers": {
    "formgong": {
      "url": "https://formgong.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:FORMGONG_TOKEN}"
      }
    }
  }
}

Claude Code

Claude Code: قم بتشغيل هذا الأمر مرة واحدة في محطة العمل الخاصة بك.

claude mcp add --transport http formgong https://formgong.com/mcp \
  --header "Authorization: Bearer fgp_your_token"

Claude Desktop

Claude Desktop: تتطلب الموصلات المخصصة في Settings → Connectors وجود OAuth، وهو ما لا يوفره Formgong حتى الآن. استخدم جسر 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: Settings → Connectors → Custom MCP server. أدخل عنوان URL، واختر «Bearer token or API key»، ثم الصق الرمز فقط (بدون كلمة Bearer).

URL: https://formgong.com/mcp
Authentication: Bearer token or API key
Token: fgp_your_token

Bolt

Bolt: Settings → Connectors (MCP) → Custom MCP server. Transport: HTTP. Authentication: API key، ثم قم بلصق الرمز.

Name: Formgong
URL: https://formgong.com/mcp
Transport: HTTP
Authentication: API key → fgp_your_token

أي عميل آخر يدعم بروتوكول «MCP» عن بُعد عبر Streamable HTTP باستخدام رؤوس مخصصة يعمل بنفس عنوان URL والرأس. أما العملاء الذين يستخدمون Stdio فقط، فيمكنهم استخدام جسر mcp-remote الموضح في Claude Desktop.

جربه

• أنشئ نموذجًا من «Formgong» باسم «الاتصال – موقعي» وأضفه إلى صفحة الاتصال.
• أضف نموذج «الاتصال» (Formgong) إلى تطبيق «Next.js» هذا كمكون عميل.
• أرني آخر 5 رسائل وردت عبر نموذج الاتصال الخاص بي.

الأمن

• يعمل الرمز المميز على حسابك ضمن نطاقاته المحددة. تجنب إدراجه في موقع git أو في الدردشات أو لقطات الشاشة؛ وقم بإلغاء صلاحيته من خلال «الحساب» → «رموز API» في حالة تسربه.
• لا تتوفر سوى النماذج التي تمتلكها. أما النماذج التي تمت مشاركتها معك من خلال المشاريع، فهي غير معروضة.
• لن تظهر المشاركات أبدًا ما لم تضع علامة في خانة «قراءة المشاركات الحديثة». ولا يتم إرجاع بيانات عنوان IP وتفاصيل المتصفح أبدًا.
• يتم كتابة نص الإرسال بواسطة زوار موقعك. تعامل معه على أنه غير موثوق به: لا تسمح لأي مساعد بتنفيذ التعليمات الواردة في رسالة ما.
• قد تنتهي صلاحية الرموز بعد 30 أو 90 أو 365 يومًا. لا تعمل ملفات تعريف الارتباط الخاصة بالجلسة أبدًا على موقع /mcp، لذا لا يمكن لأي صفحة ويب استخدام بيانات تسجيل دخولك.
• بدون رمز مصادقة، لا يستجيب /mcp إلا لأوامر initialize و ping و tools/list، بحيث يمكن للعملاء ودلائل MCP الاطلاع على قائمة الأدوات. يحتاج كل استدعاء لأداة إلى رمز مصادقة؛ وبدون ذلك، يعرض الخادم رسالة خطأ تشرح كيفية إضافته.

الحدود

• 60 طلبًا في الدقيقة لكل رمز، و120 طلبًا لكل حساب.
• الطلبات بدون رمز مصادقة: 30 طلبًا في الدقيقة لكل عنوان IP.
• 10 نماذج جديدة في الساعة عبر نظام «API».
• ما يصل إلى 10 توكنات لكل حساب.
• OAuth هذه الميزة غير مدعومة حتى الآن، لذا لا يمكن لموصلات الويب ChatGPT و claude.ai الاتصال مباشرةً. ولا يزال الموقع ومطالبات النسخ واللصق الواردة في هذه الوثائق تعمل في كل مكان.