שרת ה-MCP של Formgong
חבר את Formgong ל-Cursor, Claude, VS Code, Lovable או Bolt. לאחר מכן, העוזר ה-AI שלך יוכל ליצור טופס, לאחזר קוד מוכן להדבקה עם מפתח הגישה הנכון, ולבדוק הגשות אחרונות מבלי שתצטרך להעתיק מפתחות ידנית.
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, honeypot לבדיקת בוטים ו-Turnstile כאשר האפשרות מופעלת.
- list_recent_submissions — לקריאה בלבד, הצטרפות מרצון: זמן ושדות שהוזנו בלבד, דואר זבל לא נכלל כברירת מחדל, עד 50.
- list_webhooks, create_webhook, delete_webhook — ניהול ה-webhooks של טופס, כדי ש-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"
- פתח את לוח המחוונים → חשבון → אסימוני "API" (אמת תחילה את כתובת הדוא"ל שלך).
- תן לאסימון שם על פי הכלי שישתמש בו, לדוגמה: "Cursor" במחשב הנייד שלי.
- בחר את רמת הגישה: האפשרות "יצירת טפסים והוספה או הסרה של webhooks" מופעלת כברירת מחדל; האפשרות "קריאת הגשות אחרונות" אינה מופעלת, אלא אם כן אתה זקוק לה.
- העתיקו את האסימון (fgp_…). הוא מוצג פעם אחת בלבד; האתר Formgong שומר רק את ה-hash שלו.
{
"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 נשמרים רק כגיבוב. אסימון הרענון משתנה בכל שימוש; שליחה חוזרת של אסימון ישן מבטלת את החיבור. נתקו אפליקציות תחת חשבון → אפליקציות מחוברות. הרישום מקבל רק כתובות callback מוכרות של 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.