NueForm

Integración MCP

Conecta tu plataforma de IA favorita a NueForm con el Model Context Protocol.

El Model Context Protocol (MCP) es un estándar abierto que permite a los asistentes de IA interactuar directamente con servicios externos. El servidor MCP de NueForm le da a tu IA acceso completo a tu espacio de trabajo: formularios, respuestas, analíticas, equipos, webhooks, Voice Studio y más.

¿Qué puedes hacer?

Con MCP conectado, puedes pedirle a tu IA cosas como:

  • "¿Cuál es mi tasa de finalización en todos los formularios este mes?"
  • "Crea una encuesta de satisfacción del cliente con puntuación NPS."
  • "Exporta todas las respuestas del primer trimestre como CSV."
  • "Agrega a sarah@company.com al equipo de Marketing."
  • "¿Qué preguntas tardan más en responderse?"
  • "Lee este anuncio con la voz de Rosa. No gastes más de 2.000 créditos."
  • "¿Cuántos créditos me quedan este mes?"

Tu IA traduce automáticamente estas peticiones en lenguaje natural a las llamadas a la API de NueForm que corresponden.

Requisitos previos

  • Una cuenta de NueForm (el plan gratuito sirve)
  • Un cliente de IA compatible con MCP (consulta las guías de configuración más abajo)

Guías de configuración

La URL del servidor MCP de NueForm:

text
https://nueform.io/api/mcp

La autenticación se hace mediante OAuth: tu cliente de IA abrirá una ventana del navegador para que inicies sesión con tu cuenta de NueForm. No necesitas claves de API.

Claude Desktop

Agrega lo siguiente a tu claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

json
{
  "mcpServers": {
    "nueform": {
      "url": "https://nueform.io/api/mcp"
    }
  }
}

Reinicia Claude Desktop. La primera vez que lo uses, se te pedirá que inicies sesión con tu cuenta de NueForm.

Claude Code (CLI)

Ejecuta el siguiente comando:

bash
claude mcp add nueform --transport http https://nueform.io/api/mcp

O agrégalo a tu .claude/settings.json:

json
{
  "mcpServers": {
    "nueform": {
      "url": "https://nueform.io/api/mcp"
    }
  }
}

Cursor

Agrégalo a .cursor/mcp.json en la raíz de tu proyecto (o en la configuración global):

json
{
  "mcpServers": {
    "nueform": {
      "url": "https://nueform.io/api/mcp"
    }
  }
}

Windsurf

Agrégalo a tu configuración de MCP en los ajustes de Windsurf:

json
{
  "mcpServers": {
    "nueform": {
      "url": "https://nueform.io/api/mcp"
    }
  }
}

VS Code (GitHub Copilot)

Agrégalo a .vscode/mcp.json en tu espacio de trabajo:

json
{
  "servers": {
    "nueform": {
      "url": "https://nueform.io/api/mcp"
    }
  }
}

Otros clientes MCP

Cualquier cliente compatible con el transporte MCP HTTP Streamable puede conectarse a NueForm. Configúralo con:

  • URL del servidor: https://nueform.io/api/mcp
  • Autenticación: OAuth 2.0 (el cliente debería gestionar el flujo automáticamente)

Herramientas disponibles

El servidor MCP de NueForm ofrece 75 herramientas en 11 categorías:

Formularios (8 herramientas)

HerramientaDescripción
list_formsLista formularios con búsqueda, paginación y filtros
get_formObtiene un formulario con todas sus preguntas
create_formCrea un formulario nuevo, con preguntas opcionales
update_formActualiza la configuración y las preguntas de un formulario (incl. auto_translate: NueLingo, Pro+)
delete_formElimina un formulario y todos sus datos (un formulario con contratos firmados necesita delete_signed_contracts: true, que también elimina los contratos de forma permanente)
publish_formPublica un formulario con las mismas comprobaciones que el botón Publicar del editor (crea una versión; devuelve advertencias, o un error con las preguntas que hay que corregir)
unpublish_formDespublica un formulario (formularios de equipo: solo administradores y propietarios del equipo)
duplicate_formDuplica un formulario con todas sus preguntas

Los formularios se guardan como borradores. publish_form (o published: true en create_form y update_form) hace las mismas comprobaciones que el botón Publicar del editor: los formularios de equipo solo los pueden publicar los administradores y propietarios del equipo, las funciones Pro siguen el plan del propietario del formulario, y las preguntas de reservas, de paso de correo, de Fuse y compuestas deben estar completamente configuradas. Si una comprobación falla, no se publica nada y la herramienta devuelve el motivo, las preguntas que hay que corregir y una indicación para tu IA. Un formulario creado con published: true se crea igualmente como borrador cuando su publicación está bloqueada.

Analíticas (5 herramientas)

HerramientaDescripción
get_dashboard_analyticsAnalíticas agregadas de todos los formularios
get_form_analyticsAnalíticas de un formulario concreto
get_geo_pointsDatos de dispersión geográfica de las respuestas
get_temporal_responseDistribución de las respuestas por hora
get_question_timingDatos de dispersión del tiempo por pregunta

Respuestas (5 herramientas)

HerramientaDescripción
list_responsesLista respuestas con filtros de fecha y de finalización
get_responseObtiene una respuesta con todas sus contestaciones
delete_responseElimina una respuesta
export_responses_csvExporta todas las respuestas como CSV
bulk_delete_responsesElimina hasta 100 respuestas a la vez

Webhooks (6 herramientas)

HerramientaDescripción
get_form_webhookObtiene la configuración del webhook de un formulario
update_form_webhookEstablece o elimina la URL del webhook de un formulario
list_global_webhooksLista los endpoints de webhooks globales (Pro+)
update_global_webhooksActualiza los webhooks globales (Pro+)
get_webhook_secretObtiene el secreto de firma de los webhooks (Pro+)
regenerate_webhook_secretRegenera el secreto de firma (Pro+)

Equipos (12 herramientas)

HerramientaDescripción
list_teamsLista todos los equipos a los que perteneces
create_teamCrea un equipo nuevo
get_teamObtiene los datos y los miembros de un equipo
update_teamActualiza el nombre del equipo
delete_teamElimina un equipo (solo el propietario)
list_team_membersLista los miembros del equipo
add_team_memberAgrega por correo a un usuario de NueForm que ya existe (rol admin, editor o viewer, por defecto viewer; member es un alias obsoleto de viewer). Para una dirección sin cuenta, usa create_invitation
update_team_memberCambia el rol de un miembro (admin, editor o viewer; member es un alias obsoleto de viewer)
remove_team_memberQuita a un miembro (también cancela sus invitaciones pendientes al equipo)
list_invitationsLista las invitaciones pendientes de un equipo, de la más reciente a la más antigua, incluidas las vencidas (marcadas con expired: una invitación vencida no se puede aceptar y ya no ocupa un asiento; delete_invitation la elimina). Los tokens de enlace solo se incluyen para propietarios y administradores
create_invitationInvita a alguien por correo: NueForm le envía la invitación (rol admin, editor o viewer, por defecto viewer; member es un alias obsoleto de viewer)
delete_invitationCancela una invitación pendiente

Sesiones de Fuse (9 herramientas)

HerramientaDescripción
list_fuse_sessionsLista las sesiones de Fuse de un formulario, cada una con sus resultados en vivo y sus participantes
create_fuse_sessionInicia una sesión de Fuse para un formulario (conserva la configuración de Fuse del formulario tal como está ahora)
get_fuse_sessionObtiene una sesión con sus resultados en vivo y sus participantes
rename_fuse_sessionCambia el nombre de una sesión
pause_fuse_sessionPausa una sesión activa
resume_fuse_sessionReanuda una sesión pausada
archive_fuse_sessionArchiva una sesión
unarchive_fuse_sessionRecupera una sesión archivada
delete_fuse_sessionElimina una sesión con sus participantes y acciones (no se puede deshacer)

Compuestos (6 herramientas)

HerramientaDescripción
list_compositesLista tus compuestos (grupos reutilizables de subcampos para preguntas compuestas y de lista)
get_compositeObtiene un compuesto con su copia de trabajo y su estado de publicación
create_compositeCrea un compuesto vacío como borrador
update_compositeReemplaza la copia de trabajo de un compuesto (los formularios siguen usando la versión publicada hasta que publiques)
publish_compositePublica la copia de trabajo: los formularios que usan el compuesto la adoptan la próxima vez que se publiquen
delete_compositeElimina un compuesto que ya no usa ningún formulario (las respuestas recopiladas se conservan)

General (6 herramientas)

HerramientaDescripción
get_userObtiene tu perfil y la información de tu plan
list_filesLista los archivos subidos
get_form_themeObtiene la configuración del tema de un formulario
update_form_themeActualiza colores, fuentes y estilos
list_payment_accountsLista tus cuentas de Stripe Connect y tus cuentas de pago por nombre, para usarlas en preguntas de pago
list_form_versionsLista las versiones publicadas de un formulario, de la más reciente a la más antigua

Voice Studio (8 herramientas)

HerramientaDescripción
voice_estimateGratis: lo que voice_generate gastaría con un texto o un guion, cuánto duraría el audio y si tu saldo lo cubre
voice_generateConvierte texto en voz con una voz, o lee un guion con varias voces, y lo guarda en tu Biblioteca. Gasta créditos (necesita max_credits)
voices_listLas voces de catálogo de NueForm y las tuyas y las de tus equipos, con los IDs nv_… para hablar con ellas
voice_designDiseña una voz a partir de una descripción: 3 opciones que dicen tu frase de muestra. Gasta créditos (necesita max_credits)
voice_saveConserva una opción de diseño como voz: 50.000 créditos ($5). Necesita max_credits
voice_cloneClona una voz a partir de una grabación de 30 a 60 segundos en un enlace público, con su transcripción y rights_confirmed: true: 50.000 créditos ($5). Necesita max_credits
library_listTu Biblioteca de Voice Studio, o la de un equipo, de lo más reciente a lo más antiguo, con búsqueda
library_getUn clip, con un enlace de descarga que funciona durante 15 minutos cuando el audio está listo

Cuando NueForm limpia las grabaciones de voz de tu cuenta, la respuesta de voice_clone incluye también sample_cleanup: cleaned (si se hizo una copia limpia), used (cleaned u original: la grabación con la que se hizo la voz), steps (lo que se hizo: noise, hum, rumble, clicks, echo, sibilance, level), voice_check (passed, not_needed, fell_back, o skipped cuando la limpieza no pudo hacerse) y fallback (0 según lo previsto, 1 una limpieza más suave, 2 se conservó la original). Sin sample_cleanup, la grabación se usó tal cual. echo significa que se redujo el eco de la sala: para ese paso, una copia de la grabación se procesa en los servidores de nuestro proveedor de GPU (no se guarda allí), y solo se usa si la voz sigue sonando igual.

Studio Apps (7 herramientas)

HerramientaDescripción
studio_audio_mergeAudio Merge: un guion con marcadores {variable} y una fila de valores por clip; cada fila se convierte en su propio clip en tu Biblioteca. Las filas a las que les falta un valor se omiten y no se cobran. Gasta créditos (necesita max_credits)
studio_audio_merge_statusGratis: el progreso de un lote (clips hechos, fallidos y pendientes) y los créditos usados
studio_voice_dropVoice Drop: un mensaje de voz a teléfonos. Un solo destinatario con recipient_expects_message: true es una llamada personal; lo demás va primero por SMS a números de EE. UU. y Canadá, con llamadas a quienes respondan CALL y a los números a los que no llegan nuestros SMS (fuera de EE. UU. y Canadá, si tu plan puede llamar allí). Necesita una primera compra de créditos y un correo verificado. Gasta créditos (necesita max_credits)
studio_voice_drop_statusGratis: la entrega a cada destinatario, por llamada o SMS, o no entregado y lo que se devolvió
studio_time_capsuleTime Capsule: mensajes entregados los días que elijas, a las 9:00 en la zona horaria del destinatario, por llamada, SMS o correo. Una llamada necesita recipient_expects_message: true. Gasta créditos (necesita max_credits)
studio_podcastPodcast from Anything: un episodio con dos presentadores a partir de un enlace o un texto. El guion se escribe gratis; el episodio solo se crea cuando su costo exacto cabe en max_credits
studio_talking_qrTalking QR: un código QR imprimible que reproduce un mensaje de voz al escanearlo. El alojamiento es gratis; la voz nueva gasta créditos (necesita max_credits)

Créditos (3 herramientas)

HerramientaDescripción
credits_balanceLos créditos que puedes gastar ahora, los créditos incluidos de este mes y lo que vence pronto
credits_activityUn mes de actividad de créditos, de lo más reciente a lo más antiguo: cargos, devoluciones automáticas y asignaciones
rate_cardLo que cuesta cada acción en créditos

Gastar créditos

Las herramientas que gastan créditos (voice_generate, voice_design, voice_save, voice_clone, studio_audio_merge, studio_voice_drop, studio_time_capsule, studio_podcast y studio_talking_qr) necesitan max_credits: lo máximo que puede gastar una llamada (10.000 créditos = $1). Sin él, o cuando la llamada costaría más, no se gasta nada y la herramienta responde con el costo exacto, para que tu IA pueda consultarte antes.

  • La voz cuesta 1 crédito por carácter hablado, en cualquier idioma. Volver a crear el mismo clip en un plazo de 30 días es gratis, y las líneas que fallan se devuelven automáticamente.
  • Una voz nueva, diseñada y guardada o clonada, cuesta 50.000 créditos ($5).
  • Se aplican las mismas reglas que en la app: el texto se revisa con la política de uso antes de cobrar nada, y para guardar o clonar una voz hace falta una primera compra de créditos y un correo verificado. Clona solo voces que tengas derecho a usar.
  • Si una llamada se queda sin tiempo, vuelve a hacerla con los mismos argumentos y el mismo idempotency_key (de 8 a 100 letras, números, - o _; cada respuesta incluye el que está en uso): recibes el resultado de la primera llamada en lugar de pagar dos veces.
  • Los enlaces de audio funcionan durante 15 minutos. library_get te da uno nuevo.
  • La voz, las voces nuevas y las Studio Apps que crean voz se pagan con lo que elegiste en Pagar Voice Studio con en tu Billetera: tus propios créditos, salvo que hayas elegido un equipo (entonces una voz que crees es del equipo). credits_balance muestra lo que eso te permite gastar. studio_voice_drop y studio_time_capsule siempre usan tus propios créditos. Si el equipo no puede pagar, no se gasta nada y la respuesta dice por qué.
  • Por MCP no se pueden comprar créditos, regalarlos ni activar la recarga automática: hazlo en tu Billetera en NueForm.

Para grandes volúmenes desde tu propio código, la API de voz cobra 0,4 créditos por carácter.

Ejemplos de uso

Analizar el rendimiento de un formulario

Tú: "¿Cuál es la tasa de finalización de mi formulario de Opiniones de clientes este mes?"

IA: Usa get_form_analytics con filtros de fecha y luego informa: "Tu formulario de Opiniones de clientes tiene una tasa de finalización del 73 % este mes (219 completadas de 300 respuestas en total). Es más que el 68 % del mes pasado."

Crear un formulario

Tú: "Crea una encuesta rápida de satisfacción del cliente con 3 preguntas: una valoración, un cuadro de comentarios y un campo de correo."

IA: Usa create_form con una lista de preguntas y luego confirma: "¡Listo! He creado la 'Encuesta de satisfacción del cliente' con 3 preguntas. ¿Quieres que la publique?"

Gestionar respuestas

Tú: "Exporta todas las respuestas de mi formulario de Solicitud de empleo como CSV para revisarlas en una hoja de cálculo."

IA: Usa export_responses_csv y devuelve los datos CSV, que puedes guardar en un archivo.

Hacer una locución

Tú: "Lee nuestro nuevo horario con la voz de Rosa. No gastes más de 2.000 créditos."

IA: Usa voices_list para encontrar a Rosa, luego voice_generate con max_credits: 2000, y responde: "Listo. Ha costado 612 créditos. Aquí tienes el audio; el enlace funciona durante 15 minutos."

Solución de problemas

"Authentication failed"

Asegúrate de haber iniciado sesión en la cuenta de NueForm correcta. Prueba a desconectar y volver a conectar el servidor MCP en tu cliente de IA.

"Permission denied" en herramientas de webhooks o de equipos

Algunas herramientas requieren planes concretos (Pro o Enterprise) o roles de equipo (administrador o propietario). Revisa tu plan en la página de facturación.

No aparecen las herramientas

Reinicia tu cliente de IA después de agregar la configuración de MCP. Algunos clientes necesitan un reinicio completo para detectar servidores MCP nuevos.

"not_started" en una herramienta de Voice Studio

No se gastó nada: la llamada no tenía max_credits, o el costo era mayor. La respuesta incluye el costo exacto; vuelve a enviar la llamada con un max_credits de al menos ese valor.

Límites de solicitudes

El servidor MCP de NueForm aplica los mismos límites por minuto que la API REST (100 solicitudes por minuto, 500 en Enterprise), contados por usuario y por separado de tus claves de API. Cada solicitud cuenta, también cada una dentro de un lote, y un lote puede llevar como máximo 10 solicitudes. Si haces muchas solicitudes seguidas, puede que la IA tenga que esperar entre llamadas.

Ultima actualizacion: 22 de noviembre de 2026