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 · OAuth 2.1 or 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.
- list_webhooks, create_webhook, delete_webhook — gèrent les webhooks d'un formulaire pour que n8n, Make ou Zapier enregistrent leur URL ; create_webhook renvoie le secret de signature.
- list_website_templates — modèles de sites complets et gratuits (démo, téléchargement HTML, code source) dont le formulaire de contact envoie déjà à Formgong ; partez d'un modèle plutôt que de générer le site de zéro.
1. Se connecter par une session
Cursor, Claude et VS Code peuvent ouvrir Formgong dans le navigateur. Vous vous connectez avec le même lien e-mail ou le compte Google que vous utilisez déjà, puis vous choisissez ce que l'outil peut faire. Rien à coller.
- Cursor : enregistrez la configuration ci-dessous. CLIENT_ID est l'identifiant public cursor (il n'y a pas de secret). forms:read et forms:write permettent de lister et de créer des formulaires. Ajoutez submissions:read seulement si l'assistant doit lire les messages.
- Claude sur le web ou Claude Desktop : ajoutez un connecteur personnalisé avec l'URL MCP. Claude enregistre un client public et ouvre la même page d'approbation. L'adresse de retour est https://claude.ai/api/mcp/auth_callback (ou https://claude.com/api/mcp/auth_callback).
- Claude Code : exécutez la commande de la section suivante et approuvez la page dans le navigateur. VS Code s'enregistre seul, ou vous pouvez utiliser l'identifiant vscode. Les outils locaux peuvent utiliser http://127.0.0.1 ou http://localhost.
- forms:read est toujours inclus. Sur la page d'approbation, laissez « Consulter les soumissions récentes » désactivé si vous n'en avez pas besoin. Vous pourrez déconnecter l'application dans Tableau de bord → Compte → Applications connectées.
2. 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 et ajouter ou supprimer des webhooks » 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.
{
"mcpServers": {
"formgong": {
"url": "https://formgong.com/mcp",
"headers": {
"Authorization": "Bearer ${env:FORMGONG_TOKEN}"
}
}
}
}
3. Ajoutez le serveur à votre outil
Cursor
Cursor : enregistrez la configuration OAuth ci-dessous dans .cursor/mcp.json (ce projet) ou ~/.cursor/mcp.json (tous les projets). Connectez-vous à Formgong et approuvez les permissions. L’identifiant public cursor n’est pas un secret.
{
"mcpServers": {
"formgong": {
"url": "https://formgong.com/mcp",
"auth": {
"CLIENT_ID": "cursor",
"scopes": [
"forms:read",
"forms:write"
]
}
}
}
}
Claude Code
Claude Code : exécutez cette commande une seule fois dans votre terminal.
claude mcp add --transport http formgong https://formgong.com/mcp
Claude Desktop
Claude Desktop : Settings → Connectors → ajoutez l'URL MCP. Claude ouvre la connexion Formgong. Pour coller un jeton d'API, utilisez le pont mcp-remote (nécessite Node.js) dans 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: Connectors → + → MCP server. Nom : Formgong. Saisissez l’URL, gardez Direct connection et OAuth, cliquez sur Add & authorize. Connectez-vous à Formgong et approuvez les permissions. Alternative : Bearer token or API key avec votre jeton personnel uniquement.
URL: https://formgong.com/mcp Authentication: OAuth Add & authorize → Formgong
Bolt
Bolt: Settings → Connectors (MCP) → Custom MCP server. Nom : Formgong. Transport: HTTP. Authentication: MCP OAuth. Cliquez sur Connect, connectez-vous à Formgong et approuvez les permissions, puis activez le connecteur pour le projet. API key accepte aussi un jeton personnel Formgong.
Name: Formgong URL: https://formgong.com/mcp?auth=required Transport: HTTP Authentication: MCP OAuth Connect → Formgong
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.
- Les jetons d'accès et d'actualisation OAuth ne sont stockés que sous forme de hash. Un jeton d'actualisation change à chaque utilisation ; renvoyer un ancien jeton révoque cette connexion. Déconnectez les applications dans Compte → Applications connectées. L'enregistrement n'accepte que les callbacks MCP connus et http://localhost ou http://127.0.0.1.
- 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 accepte les callbacks indiqués pour Cursor, Claude et VS Code, les adresses HTTPS sur lovable.dev et bolt.new (sans sous-domaines, paramètres ni fragments) et les adresses HTTP locales. Chaque client reste lié à son adresse de retour exacte. Les autres clients utilisent un jeton API. Connexion et échange de jetons limités par IP. Lovable: https://api.lovable.dev/workspaces/connectors/mcp/oauth/callback.