Servidor MCP de Formgong
Conecte Formgong a Cursor, Claude, VS Code, Lovable o Bolt. De este modo, su asistente de IA podrá crear un formulario, obtener código listo para pegar con la clave de acceso correcta y comprobar los envíos recientes sin que usted tenga que copiar las claves a mano.
URL: https://formgong.com/mcp · Streamable HTTP · OAuth 2.1 or Authorization: Bearer fgp_…
Herramientas
- list_forms — sus formularios, junto con sus claves de acceso público y el recuento de envíos de este mes.
- create_form — un nuevo formulario; las inscripciones se envían al correo electrónico de su cuenta. Telegram y los destinatarios adicionales se añaden en el panel de control (la herramienta genera los enlaces).
- get_form_snippet — HTML, React o Next.js: código para un formulario, con clave de acceso, _lang, honeypot de botcheck y Turnstile cuando esté habilitado.
- list_recent_submissions — Solo lectura, participación voluntaria: únicamente la hora y los campos rellenados; el correo basura se excluye por defecto; hasta 50.
- list_webhooks, create_webhook, delete_webhook — gestionan los webhooks de un formulario para que n8n, Make o Zapier registren su URL; create_webhook devuelve el secreto de firma.
- list_website_templates — plantillas web completas y gratuitas (demo, descarga HTML, código) cuyo formulario de contacto ya envía a Formgong; empiece con una en lugar de generar el sitio desde cero.
1. Conectar con inicio de sesión
Cursor, Claude y VS Code pueden abrir Formgong en el navegador. Usted inicia sesión con el mismo enlace de correo o la cuenta de Google que ya usa y elige qué puede hacer la herramienta. No hay nada que pegar.
- Cursor: guarde la configuración de abajo. CLIENT_ID es el identificador público cursor (no hay secreto). forms:read y forms:write permiten listar y crear formularios. Añada submissions:read solo si el asistente debe leer los mensajes.
- Claude en la web o Claude Desktop: añada un conector personalizado con la URL de MCP. Claude registra un cliente público y abre la misma página de aprobación. La dirección de retorno es https://claude.ai/api/mcp/auth_callback (o https://claude.com/api/mcp/auth_callback).
- Claude Code: ejecute el comando de la sección siguiente y apruebe la página en el navegador. VS Code se registra solo, o puede usar el identificador vscode. Las herramientas locales pueden usar retornos en http://127.0.0.1 o http://localhost.
- forms:read siempre está incluido. En la página de aprobación, deje desactivado «Leer envíos recientes» si no lo necesita. Puede desconectar la aplicación en Panel → Cuenta → Aplicaciones conectadas.
2. Cree un token de API
- Acceda a «Panel de control» → «Cuenta» → «Tokens de API» (confirme primero su correo electrónico).
- Asigne al token el nombre de la herramienta que lo va a utilizar; por ejemplo, «Cursor» en mi ordenador portátil.
- Seleccione el tipo de acceso: la opción «Crear formularios y añadir o eliminar webhooks» está activada de forma predeterminada; la opción «Leer envíos recientes» está desactivada, a menos que la necesite.
- Copie el token (fgp_…). Solo se muestra una vez; Formgong solo almacena un hash del mismo.
{
"mcpServers": {
"formgong": {
"url": "https://formgong.com/mcp",
"headers": {
"Authorization": "Bearer ${env:FORMGONG_TOKEN}"
}
}
}
}
3. Añada el servidor a su herramienta
Cursor
Cursor: guarde la configuración OAuth de abajo en .cursor/mcp.json (este proyecto) o ~/.cursor/mcp.json (todos los proyectos). Inicie sesión en Formgong y apruebe los permisos. El identificador público cursor no es un secreto.
{
"mcpServers": {
"formgong": {
"url": "https://formgong.com/mcp",
"auth": {
"CLIENT_ID": "cursor",
"scopes": [
"forms:read",
"forms:write"
]
}
}
}
}
Claude Code
Claude Code: ejecútelo una vez en su terminal.
claude mcp add --transport http formgong https://formgong.com/mcp
Claude Desktop
Claude Desktop: Settings → Connectors → añada la URL de MCP. Claude abre el inicio de sesión de Formgong. Para pegar un token de API, use el puente mcp-remote (requiere Node.js) en claude_desktop_config.json y reinicie 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 (Modo agente de Copilot): añada .vscode/mcp.json. VS Code solicita el token una sola vez y lo almacena de forma segura.
{
"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. Nombre: Formgong. Introduzca la URL, mantenga Direct connection y OAuth, pulse Add & authorize. Inicie sesión en Formgong y apruebe los permisos. Alternativa: Bearer token or API key y solo su token personal.
URL: https://formgong.com/mcp Authentication: OAuth Add & authorize → Formgong
Bolt
Bolt: Settings → Connectors (MCP) → Custom MCP server. Nombre: Formgong. Transport: HTTP. Authentication: MCP OAuth. Pulse Connect, inicie sesión en Formgong y apruebe los permisos; active el conector para el proyecto. API key también admite un token personal de Formgong.
Name: Formgong URL: https://formgong.com/mcp?auth=required Transport: HTTP Authentication: MCP OAuth Connect → Formgong
Cualquier otro cliente que admita el protocolo «MCP» remoto a través de Streamable HTTP con encabezados personalizados funciona con la misma URL y el mismo encabezado. Los clientes que solo admiten Stdio pueden utilizar el puente «mcp-remote» que se muestra en Claude Desktop.
Pruébelo
- Cree un formulario de «Formgong» llamado «Contacto – mi sitio web» y añádalo a la página de contacto.
- Añada el formulario «Contacto» de Formgong a esta aplicación de Next.js como componente de cliente.
- Muéstrame los últimos 5 mensajes de mi formulario de contacto.
Seguridad
- Un token actúa en su cuenta dentro de sus ámbitos de aplicación. Evite incluirlo en «git», chats y capturas de pantalla; revóquelo en «Cuenta» → «APIar tokens» en caso de que se filtre.
- Solo están disponibles los formularios de los que es usted propietario. Los formularios que se han compartido con usted a través de proyectos no se muestran.
- Las entradas nunca estarán disponibles a menos que marque la casilla «Leer entradas recientes». Nunca se facilitan datos de IP ni detalles del navegador.
- El texto enviado lo escriben sus visitantes. Considérelo poco fiable: no permita que un asistente siga las instrucciones que figuren en un mensaje.
- Los tokens pueden caducar a los 30, 90 o 365 días. Las cookies de sesión nunca funcionan en /mcp, por lo que una página web no puede utilizar sus datos de inicio de sesión.
- Los tokens de acceso y de actualización de OAuth se guardan solo como un hash. El token de actualización cambia en cada uso; reenviar uno antiguo revoca esa conexión. Desconecte las aplicaciones en Cuenta → Aplicaciones conectadas. El registro solo acepta callbacks MCP conocidos y http://localhost o http://127.0.0.1.
- Sin un token, /mcp solo responde a initialize, ping y tools/list, de modo que los clientes y los directorios MCP puedan ver la lista de herramientas. Cada llamada a una herramienta requiere un token; sin él, el servidor devuelve un error en el que se explica cómo añadirlo.
Límites
- 60 solicitudes por minuto por token, 120 por cuenta.
- Solicitudes sin token: 30 por minuto por dirección IP.
- 10 nuevos formularios por hora a través de la plataforma «API».
- Hasta 10 fichas por cuenta.
- OAuth acepta los callbacks indicados para Cursor, Claude y VS Code, direcciones HTTPS en lovable.dev y bolt.new (sin subdominios, parámetros ni fragmentos) y direcciones HTTP locales. Cada cliente queda vinculado a su URL de retorno exacta. Otros clientes usan un token de API. Inicio de sesión e intercambio de tokens limitados por IP. Lovable: https://api.lovable.dev/workspaces/connectors/mcp/oauth/callback.