Formgong MCP sunucusu

Formgong'u Cursor, Claude, VS Code, Lovable veya Bolt'a bağlayın. Yapay zekâ asistanınız form oluşturabilir, doğru erişim anahtarıyla hazır kodu alabilir ve son gönderimlere bakabilir; anahtarları elle kopyalamanız gerekmez.

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

Araçlar

list_forms — formlarınız, herkese açık erişim anahtarları ve bu ayki gönderim sayısı.
create_form — yeni form; gönderimler hesap e-postanıza gelir. Telegram ve ek alıcılar panelden bağlanır (araç bağlantıları döndürür).
get_form_snippet — bir form için HTML, React veya Next.js kodu; erişim anahtarı, _lang, botcheck honeypot ve açıksa Turnstile dahil.
list_recent_submissions — salt okunur ve ayrıca izin gerekir: yalnızca zaman ve gönderilen alanlar, varsayılan olarak spam hariç, en fazla 50.

1. API anahtarı oluşturun

Panel → Hesap → API anahtarları'nı açın (önce e-postanızı doğrulayın).
Anahtara onu kullanacak aracın adını verin, ör. “Dizüstü bilgisayarımdaki Cursor”.
Erişimi seçin: “Form oluşturma” varsayılan olarak açıktır; gerekmedikçe “Son gönderimleri okuma”yı kapalı bırakın.
Anahtarı (fgp_…) kopyalayın. Yalnızca bir kez gösterilir; Formgong yalnızca özetini (hash) saklar.

2. Sunucuyu aracınıza ekleyin

Cursor

Cursor: ~/.cursor/mcp.json (tüm projeler) veya .cursor/mcp.json (tek proje) dosyasına ekleyin. FORMGONG_TOKEN ortam değişkenini tanımlayın ya da anahtarı git'e eklemediğiniz bir dosyada değişkenin yerine yapıştırın.

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

Claude Code

Claude Code: terminalde bir kez çalıştırın.

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

Claude Desktop

Claude Desktop: Settings → Connectors'daki özel bağlayıcılar OAuth gerektirir ve Formgong henüz OAuth sunmuyor. Bunun yerine claude_desktop_config.json içinde mcp-remote köprüsünü (Node.js gerekir) kullanın ve Claude Desktop'ı yeniden başlatın.

{
  "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 ajan modu): .vscode/mcp.json ekleyin. VS Code anahtarı bir kez sorar ve güvenle saklar.

{
  "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'yi girin, “Bearer token or API key” seçin ve yalnızca anahtarı yapıştırın (Bearer kelimesi olmadan).

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, ardından anahtarı yapıştırın.

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

Streamable HTTP üzerinden uzak MCP'yi ve özel başlıkları destekleyen diğer tüm istemciler aynı URL ve başlıkla çalışır. Yalnızca stdio destekleyen istemciler Claude Desktop'taki mcp-remote köprüsünü kullanabilir.

Deneyin

“İletişim – sitem” adlı bir Formgong formu oluştur ve iletişim sayfasına ekle.
“İletişim” Formgong formunu bu Next.js uygulamasına istemci bileşeni olarak ekle.
İletişim formumdan gelen son 5 mesajı göster.

Güvenlik

Anahtar, izinleri dahilinde hesabınız adına çalışır. Git'e, sohbetlere ve ekran görüntülerine koymayın; sızarsa Hesap → API anahtarları'ndan iptal edin.
Yalnızca sahibi olduğunuz formlar erişilebilir. Projeler üzerinden sizinle paylaşılan formlar açılmaz.
“Son gönderimleri okuma”yı işaretlemedikçe gönderimlere erişilemez. IP verileri ve tarayıcı bilgileri asla döndürülmez.
Gönderim metnini ziyaretçileriniz yazar. Güvenilmez kabul edin: asistanın mesajlardaki talimatlara uymasına izin vermeyin.
Anahtarlar 30, 90 veya 365 gün sonra sona erebilir. Oturum çerezleri /mcp üzerinde asla çalışmaz; bir web sayfası girişinizi kullanamaz.
Token olmadan /mcp yalnızca initialize, ping ve tools/list komutlarına yanıt verir; böylece istemciler ve MCP dizinleri araç listesini görebilir. Her araç çağrısı için bir token gereklidir; token olmadan sunucu, tokenin nasıl ekleneceğini açıklayan bir hata mesajı döndürür.

Sınırlar

Anahtar başına dakikada 60, hesap başına 120 istek.
Token içermeyen istekler: IP adresi başına dakikada 30 adet.
API üzerinden saatte 10 yeni form.
Hesap başına en fazla 10 anahtar.
OAuth henüz desteklenmiyor; bu nedenle ChatGPT ve claude.ai web bağlayıcıları doğrudan bağlanamaz. Site ve bu belgelerdeki hazır istemler her yerde çalışır.