Formgong
Producto Guía Plantillas Precios Blog Entrar Pedir clave

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 · 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.

1. 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» 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.

2. Añada el servidor a su herramienta

Cursor

Cursor: añádalo a ~/.cursor/mcp.json (todos los proyectos) o a .cursor/mcp.json (un solo proyecto). Configure FORMGONG_TOKEN en su entorno, o pegue el token en lugar de la variable en un archivo que no se incluya en el control de versiones.

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

Claude Code

Claude Code: ejecútelo una vez en su terminal.

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

Claude Desktop

Claude Desktop: los conectores personalizados de Settings → Connectors requieren OAuth, que Formgong aún no ofrece. Utilice en su lugar el puente mcp-remote (requiere Node.js) en claude_desktop_config.json y, a continuación, 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: Settings → Connectors → Custom MCP server. Introduzca la URL, seleccione «Bearer token or API key» y pegue únicamente el token (sin la palabra «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, y, a continuación, pegue el token.

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

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.
  • 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 Aún no es compatible, por lo que los conectores web ChatGPT y claude.ai no pueden conectarse directamente. La página web y las instrucciones para copiar y pegar que figuran en estos documentos siguen funcionando en todas partes.