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.

  1. 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.
  2. 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).
  3. 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.
  4. 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

  1. Acceda a «Panel de control» → «Cuenta» → «Tokens de API» (confirme primero su correo electrónico).
  2. Asigne al token el nombre de la herramienta que lo va a utilizar; por ejemplo, «Cursor» en mi ordenador portátil.
  3. 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.
  4. 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.

AI builder prompts · Agent rules files