Serveur MCP Formgong

Connectez Formgong à Cursor, Claude, VS Code, Lovable ou Bolt. Votre assistant IA pourra alors créer un formulaire, récupérer du code prêt à coller avec la clé d'accès appropriée et vérifier les soumissions récentes sans que vous ayez à copier les clés manuellement.

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

Outils

list_forms — vos formulaires, accompagnés de leurs clés d'accès publiques, ainsi que le nombre de soumissions de ce mois-ci.
create_form — un nouveau formulaire ; les soumissions sont envoyées à l'adresse e-mail associée à votre compte. Telegram et les destinataires supplémentaires sont ajoutés depuis le tableau de bord (l'outil génère les liens).
get_form_snippet — HTML, React ou Next.js : code pour un formulaire, avec clé d'accès, _lang, honeypot botcheck et Turnstile lorsqu'ils sont activés.
list_recent_submissions — en lecture seule, inscription facultative : heure et champs renseignés uniquement, spams exclus par défaut, jusqu'à 50.

1. Créer un jeton « API »

Ouvrez le Tableau de bord → Compte → JetonAPIs (veuillez d'abord confirmer votre adresse e-mail).
Nommez le jeton d'après l'outil qui l'utilisera, par exemple «Cursor sur mon ordinateur portable ».
Choisissez le niveau d'accès : l'option « Créer des formulaires » est activée par défaut ; l'option « Consulter les soumissions récentes » est désactivée, sauf si vous en avez besoin.
Copiez le jeton (fgp_…). Il n’apparaît qu’une seule fois ; Formgong n’en conserve qu’un hachage.

2. Ajoutez le serveur à votre outil

Cursor

Cursor : ajoutez-le à ~/.cursor/mcp.json (pour tous les projets) ou à .cursor/mcp.json (pour un seul projet). Définissez la variable FORMGONG_TOKEN dans votre environnement, ou collez le jeton à la place de la variable dans un fichier que vous ne validez pas.

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

Claude Code

Claude Code : exécutez cette commande une seule fois dans votre terminal.

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

Claude Desktop

Claude Desktop : les connecteurs personnalisés disponibles sur Settings → Connectors nécessitent OAuth, ce que Formgong ne propose pas encore. Veuillez utiliser à la place le pont mcp-remote (nécessite Node.js) disponible sur claude_desktop_config.json, puis redémarrez 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 (mode « Copilot » : mode agent) : ajoutez .vscode/mcp.json. VS Code vous demande le jeton une seule fois et le stocke en toute sécurité.

{
  "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. Saisissez l'URL, sélectionnez « Bearer token or API key » et collez uniquement le jeton (sans le mot « 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, puis collez le jeton.

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

Tout autre client prenant en charge l'MCP à distance via Streamable HTTP avec des en-têtes personnalisés fonctionne avec la même URL et les mêmes en-têtes. Les clients utilisant uniquement Stdio peuvent utiliser le pont mcp-remote présenté à l'adresse Claude Desktop.

Essayez-le

Créez un formulaire « Formgong » intitulé « Contact – mon site » et ajoutez-le à la page de contact.
Ajoutez le formulaire « Contact » de Formgong à cette application Next.js en tant que composant client.
Affichez-moi les 5 derniers messages reçus via mon formulaire de contact.

Sécurité

Un jeton agit sur votre compte dans les limites de ses autorisations. Ne le divulguez pas dans les messages «git », les discussions ou les captures d'écran ; révoquez-le dans Compte → Jetons « API » en cas de fuite.
Seuls les formulaires dont vous êtes propriétaire sont disponibles. Les formulaires qui vous sont partagés dans le cadre de projets ne sont pas accessibles.
Les soumissions ne sont jamais visibles à moins que vous ne cochiez la case « Lire les soumissions récentes ». Les données IP et les informations relatives au navigateur ne sont jamais transmises.
Le texte saisi est rédigé par vos visiteurs. Considérez-le comme non fiable : ne laissez pas un assistant suivre les instructions contenues dans un message.
Les jetons peuvent expirer au bout de 30, 90 ou 365 jours. Les cookies de session ne fonctionnent jamais sur /mcp ; une page Web ne peut donc pas utiliser vos identifiants de connexion.
Sans jeton, /mcp ne répond qu’aux commandes initialize, ping et tools/list, afin que les clients et les répertoires MCP puissent consulter la liste des outils. Chaque appel d’outil nécessite un jeton ; en l’absence de jeton, le serveur renvoie une erreur expliquant comment l’ajouter.

Limites

60 requêtes par minute et par jeton, 120 par compte.
Requêtes sans jeton : 30 par minute et par adresse IP.
10 nouveaux formulaires par heure via l'APIe.
Jusqu'à 10 jetons par compte.
OAuth n'est pas encore pris en charge ; par conséquent, les connecteurs Web ChatGPT et claude.ai ne peuvent pas se connecter directement. Le site et les instructions de copier-coller figurant dans ces documents fonctionnent toujours partout.