שרת ה-MCP של Formgong

חבר את Formgong ל-Cursor, Claude, VS Code, Lovable או Bolt. לאחר מכן, העוזר ה-AI שלך יוכל ליצור טופס, לאחזר קוד מוכן להדבקה עם מפתח הגישה הנכון, ולבדוק הגשות אחרונות מבלי שתצטרך להעתיק מפתחות ידנית.

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

כלים

  • list_forms — הטפסים שלכם, יחד עם מפתחות הגישה הציבוריים שלהם ומספר ההגשות של החודש.
  • create_form — טופס חדש; ההגשות נשלחות לכתובת הדוא"ל של החשבון שלך. Telegram ונמענים נוספים מתווספים בלוח הבקרה (הכלי מציג את הקישורים).
  • get_form_snippet — HTML, React או Next.js קוד עבור טופס אחד, עם מפתח גישה, _lang, honeypot לבדיקת בוטים ו-Turnstile כאשר האפשרות מופעלת.
  • list_recent_submissions — לקריאה בלבד, הצטרפות מרצון: זמן ושדות שהוזנו בלבד, דואר זבל לא נכלל כברירת מחדל, עד 50.

1. צור אסימון של שירות ה-API של "API"

  1. פתח את לוח המחוונים → חשבון → אסימוני "API" (אמת תחילה את כתובת הדוא"ל שלך).
  2. תן לאסימון שם על פי הכלי שישתמש בו, לדוגמה: "Cursor" במחשב הנייד שלי.
  3. בחר את רמת הגישה: האפשרות "יצירת טפסים" מופעלת כברירת מחדל; האפשרות "קריאת הגשות אחרונות" אינה מופעלת, אלא אם כן אתה זקוק לה.
  4. העתיקו את האסימון (fgp_…). הוא מוצג פעם אחת בלבד; האתר Formgong שומר רק את ה-hash שלו.

2. הוסף את השרת לכלי שלך

Cursor

Cursor: הוסף ל-~/.cursor/mcp.json (כל הפרויקטים) או ל-.cursor/mcp.json (פרויקט אחד). הגדר את FORMGONG_TOKEN בסביבת העבודה שלך, או הדבק את האסימון במקום המשתנה בקובץ שאינך מבצע לו commit.

{
  "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 אינם יכולים להתחבר ישירות. האתר וההנחיות להעתקה והדבקה המופיעות במסמכים אלה עדיין פועלים בכל מקום.