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:
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
{
"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:
claude mcp add nueform --transport http https://nueform.io/api/mcp
O agrégalo a tu .claude/settings.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):
{
"mcpServers": {
"nueform": {
"url": "https://nueform.io/api/mcp"
}
}
}
Windsurf
Agrégalo a tu configuración de MCP en los ajustes de Windsurf:
{
"mcpServers": {
"nueform": {
"url": "https://nueform.io/api/mcp"
}
}
}
VS Code (GitHub Copilot)
Agrégalo a .vscode/mcp.json en tu espacio de trabajo:
{
"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)
| Herramienta | Descripción |
|---|---|
list_forms | Lista formularios con búsqueda, paginación y filtros |
get_form | Obtiene un formulario con todas sus preguntas |
create_form | Crea un formulario nuevo, con preguntas opcionales |
update_form | Actualiza la configuración y las preguntas de un formulario (incl. auto_translate: NueLingo, Pro+) |
delete_form | Elimina 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_form | Publica 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_form | Despublica un formulario (formularios de equipo: solo administradores y propietarios del equipo) |
duplicate_form | Duplica 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)
| Herramienta | Descripción |
|---|---|
get_dashboard_analytics | Analíticas agregadas de todos los formularios |
get_form_analytics | Analíticas de un formulario concreto |
get_geo_points | Datos de dispersión geográfica de las respuestas |
get_temporal_response | Distribución de las respuestas por hora |
get_question_timing | Datos de dispersión del tiempo por pregunta |
Respuestas (5 herramientas)
| Herramienta | Descripción |
|---|---|
list_responses | Lista respuestas con filtros de fecha y de finalización |
get_response | Obtiene una respuesta con todas sus contestaciones |
delete_response | Elimina una respuesta |
export_responses_csv | Exporta todas las respuestas como CSV |
bulk_delete_responses | Elimina hasta 100 respuestas a la vez |
Webhooks (6 herramientas)
| Herramienta | Descripción |
|---|---|
get_form_webhook | Obtiene la configuración del webhook de un formulario |
update_form_webhook | Establece o elimina la URL del webhook de un formulario |
list_global_webhooks | Lista los endpoints de webhooks globales (Pro+) |
update_global_webhooks | Actualiza los webhooks globales (Pro+) |
get_webhook_secret | Obtiene el secreto de firma de los webhooks (Pro+) |
regenerate_webhook_secret | Regenera el secreto de firma (Pro+) |
Equipos (12 herramientas)
| Herramienta | Descripción |
|---|---|
list_teams | Lista todos los equipos a los que perteneces |
create_team | Crea un equipo nuevo |
get_team | Obtiene los datos y los miembros de un equipo |
update_team | Actualiza el nombre del equipo |
delete_team | Elimina un equipo (solo el propietario) |
list_team_members | Lista los miembros del equipo |
add_team_member | Agrega 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_member | Cambia el rol de un miembro (admin, editor o viewer; member es un alias obsoleto de viewer) |
remove_team_member | Quita a un miembro (también cancela sus invitaciones pendientes al equipo) |
list_invitations | Lista 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_invitation | Invita 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_invitation | Cancela una invitación pendiente |
Sesiones de Fuse (9 herramientas)
| Herramienta | Descripción |
|---|---|
list_fuse_sessions | Lista las sesiones de Fuse de un formulario, cada una con sus resultados en vivo y sus participantes |
create_fuse_session | Inicia una sesión de Fuse para un formulario (conserva la configuración de Fuse del formulario tal como está ahora) |
get_fuse_session | Obtiene una sesión con sus resultados en vivo y sus participantes |
rename_fuse_session | Cambia el nombre de una sesión |
pause_fuse_session | Pausa una sesión activa |
resume_fuse_session | Reanuda una sesión pausada |
archive_fuse_session | Archiva una sesión |
unarchive_fuse_session | Recupera una sesión archivada |
delete_fuse_session | Elimina una sesión con sus participantes y acciones (no se puede deshacer) |
Compuestos (6 herramientas)
| Herramienta | Descripción |
|---|---|
list_composites | Lista tus compuestos (grupos reutilizables de subcampos para preguntas compuestas y de lista) |
get_composite | Obtiene un compuesto con su copia de trabajo y su estado de publicación |
create_composite | Crea un compuesto vacío como borrador |
update_composite | Reemplaza la copia de trabajo de un compuesto (los formularios siguen usando la versión publicada hasta que publiques) |
publish_composite | Publica la copia de trabajo: los formularios que usan el compuesto la adoptan la próxima vez que se publiquen |
delete_composite | Elimina un compuesto que ya no usa ningún formulario (las respuestas recopiladas se conservan) |
General (6 herramientas)
| Herramienta | Descripción |
|---|---|
get_user | Obtiene tu perfil y la información de tu plan |
list_files | Lista los archivos subidos |
get_form_theme | Obtiene la configuración del tema de un formulario |
update_form_theme | Actualiza colores, fuentes y estilos |
list_payment_accounts | Lista tus cuentas de Stripe Connect y tus cuentas de pago por nombre, para usarlas en preguntas de pago |
list_form_versions | Lista las versiones publicadas de un formulario, de la más reciente a la más antigua |
Voice Studio (8 herramientas)
| Herramienta | Descripción |
|---|---|
voice_estimate | Gratis: 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_generate | Convierte 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_list | Las voces de catálogo de NueForm y las tuyas y las de tus equipos, con los IDs nv_… para hablar con ellas |
voice_design | Diseña una voz a partir de una descripción: 3 opciones que dicen tu frase de muestra. Gasta créditos (necesita max_credits) |
voice_save | Conserva una opción de diseño como voz: 50.000 créditos ($5). Necesita max_credits |
voice_clone | Clona 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_list | Tu Biblioteca de Voice Studio, o la de un equipo, de lo más reciente a lo más antiguo, con búsqueda |
library_get | Un 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)
| Herramienta | Descripción |
|---|---|
studio_audio_merge | Audio 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_status | Gratis: el progreso de un lote (clips hechos, fallidos y pendientes) y los créditos usados |
studio_voice_drop | Voice 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_status | Gratis: la entrega a cada destinatario, por llamada o SMS, o no entregado y lo que se devolvió |
studio_time_capsule | Time 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_podcast | Podcast 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_qr | Talking 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)
| Herramienta | Descripción |
|---|---|
credits_balance | Los créditos que puedes gastar ahora, los créditos incluidos de este mes y lo que vence pronto |
credits_activity | Un mes de actividad de créditos, de lo más reciente a lo más antiguo: cargos, devoluciones automáticas y asignaciones |
rate_card | Lo 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_gette 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_balancemuestra lo que eso te permite gastar.studio_voice_dropystudio_time_capsulesiempre 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_analyticscon 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_formcon 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_csvy 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_listpara encontrar a Rosa, luegovoice_generateconmax_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.