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 · OAuth 2.1 or 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.
  • list_webhooks, create_webhook, delete_webhook — formun webhook'larını yönetir; böylece n8n, Make veya Zapier kendi adresini ekleyebilir. create_webhook imza anahtarını döndürür.
  • list_website_templates — iletişim formu zaten Formgong'a gönderen ücretsiz hazır web sitesi şablonları (canlı demo, HTML indirme, kaynak kod); siteyi sıfırdan üretmek yerine bir şablonla başlayın.

1. Oturum açarak bağlanın

Cursor, Claude ve VS Code, Formgong'u tarayıcıda açabilir. Zaten kullandığınız e-posta bağlantısı veya Google hesabıyla giriş yapar, sonra aracın ne yapabileceğini seçersiniz. Yapıştırmanız gereken bir şey yoktur.

  1. Cursor: aşağıdaki yapılandırmayı kaydedin. CLIENT_ID, genel kimlik cursor'dur (gizli anahtar yoktur). forms:read ve forms:write asistanın formları listelemesini ve oluşturmasını sağlar. submissions:read yalnızca iletileri okuması gerekiyorsa ekleyin.
  2. Web'de Claude veya Claude Desktop: MCP URL'si ile özel bir bağlayıcı ekleyin. Claude genel bir istemci kaydeder ve aynı onay sayfasını açar. Geri çağırma adresi https://claude.ai/api/mcp/auth_callback (veya https://claude.com/api/mcp/auth_callback) adresidir.
  3. Claude Code: sonraki bölümdeki komutu çalıştırın ve tarayıcıdaki sayfayı onaylayın. VS Code kendini kaydeder ya da vscode kimliğini kullanırsınız. Yerel araçlar http://127.0.0.1 veya http://localhost geri çağırma adreslerini kullanabilir.
  4. forms:read her zaman açıktır. Onay sayfasında gerekmedikçe “Son gönderimleri okuma”yı kapalı bırakın. Uygulamayı daha sonra Panel → Hesap → Bağlı uygulamalar altından kesebilirsiniz.

2. API anahtarı oluşturun

  1. Panel → Hesap → API anahtarları'nı açın (önce e-postanızı doğrulayın).
  2. Anahtara onu kullanacak aracın adını verin, ör. “Dizüstü bilgisayarımdaki Cursor”.
  3. Erişimi seçin: “Form oluşturma, webhook ekleme ve kaldırma” varsayılan olarak açıktır; gerekmedikçe “Son gönderimleri okuma”yı kapalı bırakın.
  4. Anahtarı (fgp_…) kopyalayın. Yalnızca bir kez gösterilir; Formgong yalnızca özetini (hash) saklar.
{
  "mcpServers": {
    "formgong": {
      "url": "https://formgong.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:FORMGONG_TOKEN}"
      }
    }
  }
}

3. Sunucuyu aracınıza ekleyin

Cursor

Cursor: aşağıdaki oturum açma yapılandırmasını kaydedin (genel kimlik cursor, gizli anahtar yok). Cursor Formgong'u açar; istediğiniz erişimi onaylayın. Kişisel bir API anahtarı için önceki bölümdeki yapılandırmayı kullanın ve bu dosyayı git'e koymayın.

{
  "mcpServers": {
    "formgong": {
      "url": "https://formgong.com/mcp",
      "auth": {
        "CLIENT_ID": "cursor",
        "scopes": [
          "forms:read",
          "forms:write"
        ]
      }
    }
  }
}

Claude Code

Claude Code: terminalde bir kez çalıştırın. Tarayıcıda Formgong sayfasını onaylayın. Oturum açmayı atlamak için --header "Authorization: Bearer fgp_your_token" ekleyin.

claude mcp add --transport http formgong https://formgong.com/mcp

Claude Desktop

Claude Desktop: Settings → Connectors → MCP URL'sini ekleyin. Claude, Formgong oturumunu açar. Bunun yerine bir API anahtarı yapıştırmak için 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: Connectors → + → MCP server. Ad: Formgong. URL girin, Direct connection ve OAuth seçeneklerini koruyun, Add & authorize seçin. Formgong hesabınıza giriş yapıp izinleri onaylayın. Alternatif: Bearer token or API key ile yalnızca kişisel tokenınızı yapıştırın.

URL: https://formgong.com/mcp
Authentication: OAuth
Add & authorize → Formgong

Bolt

Bolt: Settings → Connectors (MCP) → Custom MCP server. Ad: Formgong. Transport: HTTP. Authentication: MCP OAuth. Connect seçin, Formgong hesabınıza giriş yapıp izinleri onaylayın, ardından proje için bağlantıyı etkinleştirin. API key ile kişisel Formgong tokenı da kullanılabilir.

Name: Formgong
URL: https://formgong.com/mcp?auth=required
Transport: HTTP
Authentication: MCP OAuth
Connect → Formgong

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.
  • OAuth erişim ve yenileme anahtarları yalnızca özet (hash) olarak saklanır. Yenileme anahtarı her kullanımda değişir; eskisini tekrar göndermek o bağlantıyı iptal eder. Uygulamaları Hesap → Bağlı uygulamalar altından kesin. Kayıt yalnızca bilinen MCP geri çağırma adreslerini ve http://localhost veya http://127.0.0.1 adreslerini kabul eder.
  • 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 kaydı Cursor, Claude ve VS Code geri dönüş adreslerini, lovable.dev ve bolt.new üzerindeki HTTPS adreslerini (alt alan, sorgu veya fragment olmadan) ve yerel HTTP adreslerini kabul eder. Her istemci tam kayıtlı geri dönüş adresine bağlıdır. Diğer istemciler API tokenı kullanır. Giriş ve token değişimi IP başına sınırlıdır. Lovable: https://api.lovable.dev/workspaces/connectors/mcp/oauth/callback.

AI araçları için promptlar · Ajanlar için kural dosyaları