Formswrite

Convierte documentos en formularios

GitHub

Documentación

Formswrite MCP

Conecta Claude Desktop, Cursor, Claude Code y otros clientes MCP a la API de Formswrite.

Convierte documentos en formularios de Google, edita preguntas, lista y publica formularios, y ejecuta herramientas de asistente de formularios con IA — todo desde tu LLM.

Lo que puedes hacer

Una vez instalado, tu LLM obtiene acceso al conjunto de herramientas de Formswrite:

  • create_form — crea un trabajo de Formswrite desde un documento de Google, PDF o texto pegado
  • get_form_data — lee las preguntas, opciones y metadatos actuales de un formulario
  • modify_questions — añade, edita, elimina o reordena preguntas
  • update_form_metadata — actualiza el título, la descripción o la introducción
  • publish_form — publica un formulario en borrador para que pueda recibir respuestas
  • export_form — exporta un formulario a Google Forms, Moodle, Kahoot, Quizizz, Canvas y más de 25 formatos adicionales
  • list_jobs / get_job — navega e inspecciona tus trabajos de conversión

Instalación

1. Obtén un token de API

Inicia sesión en tu panel de Formswrite y crea un token de API en: https://app.formswrite.com/settings/api-tokens

2. Añádelo a tu cliente MCP

Claude Desktop

Edita ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "formswrite": {
      "command": "npx",
      "args": ["-y", "@formswrite/mcp"],
      "env": {
        "FORMSWRITE_API_TOKEN": "fw_..."
      }
    }
  }
}

Reinicia Claude Desktop. Las herramientas de Formswrite aparecerán en la lista de herramientas.

Cursor

En Configuración → MCP, añade:

{
  "formswrite": {
    "command": "npx",
    "args": ["-y", "@formswrite/mcp"],
    "env": { "FORMSWRITE_API_TOKEN": "fw_..." }
  }
}

Claude Code

claude mcp add formswrite -- npx -y @formswrite/mcp

Luego establece el token en ~/.claude/settings.json:

{ "env": { "FORMSWRITE_API_TOKEN": "fw_..." } }

Streamable HTTP directo (sin necesidad de npm)

Si tu cliente admite el transporte Streamable HTTP de forma nativa (Cursor 0.45+, ChatGPT MCP, Claude Desktop reciente), puedes omitir este paquete y conectarte directamente:

URL:    https://mcp.formswrite.com/mcp
Header: Authorization: Bearer fw_...

Cómo funciona

Este paquete es un pequeño puente entre stdio y Streamable HTTP. Se ejecuta localmente en tu máquina, abre una conexión a https://mcp.formswrite.com/mcp usando tu token de API y reenvía mensajes JSON-RPC entre tu cliente MCP (stdio) y el servidor de Formswrite (HTTP).

Toda la lógica de las herramientas reside en el backend de Formswrite — este paquete no contiene lógica de negocio y nunca ve tus datos de formulario más allá de reenviarlos.

Configuración

Variable de entornoObligatoriaPredeterminadoDescripción
FORMSWRITE_API_TOKENsí—Token de API desde tu panel de Formswrite
FORMSWRITE_MCP_URLnohttps://mcp.formswrite.com/mcpAnulación para staging o autoalojado

Solución de problemas

La salida de diagnóstico se escribe en stderr (stdout es el canal JSON-RPC). Para ver los registros:

  • Claude Desktop: abre el panel de registros MCP (Configuración → Desarrollador)
  • CLI: ejecuta FORMSWRITE_API_TOKEN=... npx @formswrite/mcp 2>&1 >/dev/null

Problemas comunes:

  • Missing token — FORMSWRITE_API_TOKEN no está configurado en el bloque env de tu cliente
  • 401 unauthorized — el token no es válido, ha caducado o corresponde a un entorno incorrecto. Genera uno nuevo en la URL del panel indicada arriba
  • 429 rate_limited — has superado el límite de 60 solicitudes/minuto; reduce la velocidad

Licencia

MIT — consulta LICENCIA.

Enlaces