Web Data Forms

Otorga a los asistentes de IA acceso seguro a los datos comerciales estructurados de tu organización. Busca registros, crea y actualiza registros, recupera información de esquemas y gestiona estados de flujo de trabajo usando lenguaje natural.

GitHubPrueba este MCPPatrocinado

Documentación

Instrucciones del Servidor MCP de Web Data Forms

Conecta asistentes de IA como Claude y ChatGPT a tu cuenta de Web Data Forms para que puedan buscar envíos, crear nuevos envíos, actualizar datos existentes y gestionar flujos de trabajo usando lenguaje natural.

Por ejemplo, usa comandos como:

  • "Encuentra los datos de contacto de John Smith."
  • "Crea una nueva solicitud de soporte."
  • "Muéstrame los informes de inspección de esta semana."
  • "Actualiza el estado del flujo de trabajo a Completado."
  • "Crea una nueva solicitud de permiso de empleado."

El servidor está diseñado para no tener estado. No almacena tus credenciales. En su lugar, las credenciales se pasan en tiempo de ejecución para cada solicitud.

Para más información sobre Web Data Forms, visita https://www.webdataforms.com.

Tabla de Contenidos

Qué puede hacer este servidor

Este servidor expone las siguientes herramientas:

  • wdf_data_templates_list — lista las Plantillas de Datos (Formularios) habilitadas para automatización disponibles para el grupo actual, para que puedas identificar la Plantilla de Datos (Formulario) correcta antes de trabajar con envíos.
  • wdf_data_templates_get_schema_and_sample_submissions — recupera las definiciones de campos de un formulario, las definiciones de campos buscables y ejemplos representativos de envíos.
  • wdf_data_templates_submissions_list_recent — lista envíos recientes para una Plantilla de Datos (Formulario) específica cuando deseas una visión general en lugar de una búsqueda dirigida.
  • wdf_data_templates_submissions_get — recupera el contenido completo y los metadatos de un envío específico por Número de Envío.
  • wdf_data_templates_submissions_search — busca envíos por un valor de campo buscable, usando valores que están explícitamente marcados como buscables en la Plantilla de Datos (Formulario).
  • wdf_data_templates_submissions_create — crea un nuevo envío para una Plantilla de Datos (Formulario) usando los IDs de campo del esquema.
  • wdf_data_templates_submissions_update — actualiza un envío existente, con la salvedad de que reemplaza el objeto de datos completo del envío en lugar de fusionar cambios.
  • wdf_data_templates_submissions_get_workflow_meta — recupera los estados de flujo de trabajo válidos, prioridades, tipos y usuarios asignables para el grupo actual.
  • wdf_data_templates_submissions_update_workflow — reemplaza el estado del flujo de trabajo de un envío con los valores exactos de estado, prioridad, tipo, asignado y comentario que proporciones.

Configuración

Credenciales requeridas

Necesitas dos valores para cada solicitud:

  • x-api-key — tu Clave de API de Web Data Forms
  • x-group-id — tu ID de Grupo de Web Data Forms

Puedes encontrarlos en la página de grupo->información de tu cuenta de Web Data Forms.

Método preferido: encabezados de solicitud

Cuando sea posible, pasa las credenciales como encabezados HTTP:

  • x-api-key: <your-api-key>
  • x-group-id: <your-group-id>

Esta es la opción preferida porque mantiene las credenciales fuera de la URL y es más segura.

Método alternativo: parámetros de consulta

Si tu cliente MCP no admite encabezados personalizados, el servidor también acepta las credenciales como parámetros de consulta en la URL:

  • ?x-api-key=<your-api-key>&x-group-id=<your-group-id>

Ejemplo:

https://mcp.webdataforms.com?x-api-key=abc123&x-group-id=xyz456

Modelo de implementación actual

En este momento, el servidor está diseñado para usarse únicamente a través del endpoint remoto alojado. El uso local con stdio no es la vía compatible para usuarios finales.

Si tu cliente no puede enviar encabezados personalizados, usa el método alternativo de parámetros de consulta descrito anteriormente.

Opciones de transporte

Este servidor está diseñado actualmente para uso remoto con HTTP Streamable.

Transporte remoto HTTP Streamable

Úsalo para todas las implementaciones compatibles.

El endpoint HTTP es:

https://mcp.webdataforms.com

Cómo conectarse al servidor

Conexión solo remota

Conecta tu cliente MCP a la URL remota alojada y envía las credenciales como encabezados cuando sea compatible.

Ejemplo con encabezados:

curl -X POST "https://mcp.webdataforms.com" \
  -H "Content-Type: application/json" \
  -H "x-api-key: your-api-key" \
  -H "x-group-id: your-group-id" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

Ejemplo usando parámetros de consulta como método alternativo:

curl -X POST "https://mcp.webdataforms.com?x-api-key=your-api-key&x-group-id=your-group-id" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

Herramientas

1) wdf_data_templates_list

Úsala primero cuando necesites descubrir qué Plantillas de Datos (Formularios) habilitadas para automatización están disponibles en el grupo actual.

Caso de uso típico:

  • "Lista las Plantillas de Datos (Formularios) disponibles en mi grupo."
  • "Muéstrame las Plantillas de Datos (Formularios) con las que puedo trabajar."

Qué devuelve:

  • Una lista de Plantillas de Datos (Formularios) disponibles para el grupo activo.

Mejores prácticas:

  • Llámala antes de intentar crear, buscar o actualizar envíos para poder identificar un ID de Plantilla de Datos válido.

2) wdf_data_templates_get_schema_and_sample_submissions

Úsala siempre que necesites comprender la estructura de una Plantilla de Datos (Formulario) antes de crear, actualizar o buscar envíos.

Entrada requerida:

  • dataTemplateId

Qué devuelve:

  • Los campos del formulario, incluidos sus IDs de campo
  • Los campos buscables que se pueden usar con wdf_data_templates_submissions_search
  • Ejemplos representativos de envíos que muestran la estructura y los valores esperados

Mejores prácticas:

  • Úsala siempre antes de crear un nuevo envío si necesitas saber qué campos son obligatorios o compatibles.
  • Los IDs de campo devueltos aquí son las claves exactas esperadas por wdf_data_templates_submissions_create y wdf_data_templates_submissions_update; úsalos en lugar de las etiquetas de visualización.

3) wdf_data_templates_submissions_list_recent

Úsala para navegar o revisar envíos recientes de una Plantilla de Datos (Formulario) cuando no necesitas una búsqueda dirigida.

Entrada requerida:

  • dataTemplateId
  • opcional limit

Caso de uso típico:

  • "Muéstrame los últimos 10 envíos de esta Plantilla de Datos (Formulario)."

Mejores prácticas:

  • Úsala cuando necesites una visión general o quieras inspeccionar las formas de registros recientes antes de editarlos o crear otros nuevos.

4) wdf_data_templates_submissions_get

Úsala cuando ya conozcas el Número de Envío y quieras el contenido completo y los metadatos de ese envío.

Entrada requerida:

  • dataTemplateId
  • submissionNumber

Caso de uso típico:

  • "Obtén el envío 12345 de la Plantilla de Datos (Formulario) ABC123."

Mejores prácticas:

  • Si aún no tienes el número de envío, obténlo mediante wdf_data_templates_submissions_search o wdf_data_templates_submissions_list_recent.

5) wdf_data_templates_submissions_search

Úsala para encontrar envíos existentes por un valor de campo buscable.

Entrada requerida:

  • dataTemplateId
  • searchField
  • searchValue
  • opcional limit

Caso de uso típico:

  • "Encuentra envíos donde el nombre del cliente sea Jane Doe."

Nota importante:

  • Solo los campos marcados como buscables en el esquema de la Plantilla de Datos (Formulario) se pueden usar aquí.
  • Llama a wdf_data_templates_get_schema_and_sample_submissions primero para confirmar qué campos son buscables.

6) wdf_data_templates_submissions_create

Úsala para crear un nuevo envío para una Plantilla de Datos (Formulario).

Entrada requerida:

  • dataTemplateId
  • data (un objeto que contiene IDs de campo y valores)

Caso de uso típico:

  • "Crea un nuevo envío para la Plantilla de Datos (Formulario) ABC123 con estos valores."

Detalles importantes:

  • Las claves en data deben coincidir con los IDs de campo del esquema de la plantilla, no con las etiquetas de visualización.
  • Las claves no reconocidas pueden descartarse silenciosamente en lugar de generar un error.
  • Incluye los campos marcados como obligatorios en el esquema; los campos opcionales omitidos simplemente se dejan en blanco en el nuevo envío.

7) wdf_data_templates_submissions_update

Úsala para modificar un envío existente.

Entrada requerida:

  • dataTemplateId
  • submissionNumber
  • data (actualizaciones de campos)

Caso de uso típico:

  • "Actualiza el envío 12345 y cambia el campo de estado."

Detalles importantes:

  • Esta herramienta reemplaza el objeto de datos completo del envío con los valores que proporciones; es una sobrescritura completa, no una fusión.
  • Cualquier campo existente que no esté incluido en data se borrará y quedará vacío.
  • Antes de llamarla, recupera los valores actuales del envío con wdf_data_templates_submissions_get, wdf_data_templates_submissions_search o wdf_data_templates_submissions_list_recent, y luego incluye el conjunto completo de campos que deseas conservar junto con los que estás cambiando.
  • Los IDs de campo deben coincidir con el esquema de la plantilla; usa la herramienta de esquema para confirmarlos.

8) wdf_data_templates_submissions_get_workflow_meta

Úsala antes de actualizar valores de flujo de trabajo si aún no conoces los valores válidos de estado, prioridad, tipo y usuario.

Caso de uso típico:

  • "¿Qué estados de flujo de trabajo y asignados son válidos para este grupo?"

Qué devuelve:

  • Estados de flujo de trabajo válidos
  • Prioridades válidas
  • Tipos válidos
  • Usuarios asignables

Mejores prácticas:

  • Llámala antes de cualquier cambio de flujo de trabajo si los valores válidos aún no se conocen.

9) wdf_data_templates_submissions_update_workflow

Úsala para cambiar propiedades del flujo de trabajo como estado, prioridad, tipo y asignado para un envío específico.

Entrada requerida:

  • dataTemplateId
  • submissionNumber
  • statusId
  • priorityId
  • typeId

Entrada opcional:

  • assigneeUserId
  • comment

Caso de uso típico:

  • "Actualiza el flujo de trabajo del envío 12345 al estado X y prioridad Y."

Detalles importantes:

  • Esta herramienta reemplaza el estado del flujo de trabajo del envío con los valores exactos que proporciones; es una sobrescritura completa, no una actualización parcial.
  • statusId, priorityId y typeId son todos obligatorios incluso si solo uno está cambiando.
  • Reutiliza los valores existentes del envío para cualquier campo de flujo de trabajo que no tengas intención de cambiar.
  • Llama a wdf_data_templates_submissions_get_workflow_meta primero para obtener IDs válidos, y recupera los valores actuales del envío primero (usando wdf_data_templates_submissions_get, wdf_data_templates_submissions_search o wdf_data_templates_submissions_list_recent) si necesitas conservar el estado de flujo de trabajo existente.

Flujo de trabajo recomendado para agentes

Un buen patrón de trabajo para un asistente de IA es:

  1. Llama a wdf_data_templates_list para identificar el formulario/plantilla disponible.
  2. Llama a wdf_data_templates_get_schema_and_sample_submissions para comprender los campos.
  3. Si es necesario, llama a wdf_data_templates_submissions_search o wdf_data_templates_submissions_list_recent para encontrar datos existentes.
  4. Crea o actualiza envíos con wdf_data_templates_submissions_create o wdf_data_templates_submissions_update.
  5. Si hay cambios de flujo de trabajo involucrados, llama a wdf_data_templates_submissions_get_workflow_meta primero, luego a wdf_data_templates_submissions_update_workflow.

Esta secuencia ayuda a evitar nombres de campos no válidos y valores de flujo de trabajo incorrectos.

Uso de este servidor MCP con Claude

Claude con el endpoint HTTP remoto

Agregar Conector

Apunta Claude al servidor alojado agregando un nuevo conector personalizado:

https://mcp.webdataforms.com

Luego proporciona las credenciales como:

  • encabezados: x-api-key y x-group-id
  • o parámetros de consulta si el cliente no puede enviar encabezados

Agregar Contexto

Haz saber a Claude cuándo usar el conector de Web Data Forms usando una de las opciones a continuación.

Opción 1 - Crear un Proyecto

Crea un nuevo proyecto, asígnale un nombre apropiado (por ejemplo, Asistente de Negocios). En las instrucciones, haz saber a Claude cómo debe usarse el conector de Web Data Forms para este proyecto. Se proporcionan instrucciones de muestra a continuación, pero adáptalas a tus necesidades.

When answering questions that may depend on company-specific information, use the connected Web Data Forms MCP connector as the authoritative source.

This includes questions concerning company policies, procedures, customers, contacts, feedback, expenses, issues, internal records, and other organization-specific information.

Do not assume that information is unavailable merely because it is not present in the current conversation. Search the connected MCP data when appropriate.

When the user asks you to record, create, update, log, or modify company information, use the appropriate MCP tool rather than merely describing what the user should do.

For questions that are clearly unrelated to the organization, do not use the MCP connector unnecessarily.

Usa este proyecto para realizar tareas escribiendo o hablando de forma natural.

Opción 2 - Agregar Instrucciones Específicas del Chat

En una ventana de chat, indica a Claude que probablemente necesitará el conector de Web Data Forms para responder preguntas en este chat.

Realiza tareas escribiendo o hablando de forma natural.

Opción 3 - Indicar a Claude que Guarde Instrucciones en la Memoria a Largo Plazo

Este método puede no ser confiable en este momento.

Escribe instrucciones claras sobre cuándo usar el conector de Web Data Forms e indica a Claude que las guarde en su memoria a largo plazo.

Realiza tareas escribiendo o hablando de forma natural.

Uso de este servidor MCP con ChatGPT

Si tu entorno de ChatGPT admite conexiones MCP, configúralo para conectarse al endpoint del servidor alojado y pasa las credenciales como encabezados siempre que sea posible.

Configuración recomendada:

  • Usa el endpoint HTTP Streamable: https://mcp.webdataforms.com
  • Agrega los encabezados de autenticación x-api-key y x-group-id
  • Si tu cliente no permite encabezados personalizados, usa el método alternativo de parámetros de consulta

Ejemplo de destino de conexión:

https://mcp.webdataforms.com

Patrón de uso recomendado con ChatGPT

Pide al modelo que:

  • recuerde qué información está almacenada en Web Data Forms - por ejemplo, "Para referencia futura, recuerda que guardo mis contactos, gastos y problemas abiertos en Web Data Forms",
  • realice tareas escribiendo o hablando de forma natural - por ejemplo, "¿Puedes obtener el número de teléfono de John Smith?",

Uso de este servidor MCP con OpenClaw

OpenClaw debe configurarse para conectarse al endpoint de MCP en:

https://mcp.webdataforms.com

Proporcione la autenticación de una de las siguientes maneras:

  1. Preferida: envíe los encabezados x-api-key y x-group-id
  2. Alternativa: agregue ?x-api-key=...&x-group-id=... a la URL

Si OpenClaw admite un objeto de configuración del servidor o ajustes de conexión, use el equivalente de:

{
  "url": "https://mcp.webdataforms.com",
  "headers": {
    "x-api-key": "your-api-key",
    "x-group-id": "your-group-id"
  }
}

Si el cliente no puede establecer encabezados, use la variante de parámetro de consulta en su lugar.

Uso de este servidor MCP con Smithery

https://smithery.ai/servers/dotzcominc/web-data-forms

Solución de problemas

Error de autenticación

Si ve un error de autenticación, verifique que:

  • x-api-key esté presente y sea válido
  • x-group-id esté presente y sea válido
  • esté utilizando el transporte correcto
  • si el cliente no puede enviar encabezados, la alternativa de parámetro de consulta se esté utilizando correctamente

Plantilla o esquema faltante

Si un ID de plantilla parece inválido:

  • liste las plantillas nuevamente
  • verifique que esté utilizando el grupo correcto
  • verifique que la plantilla esté habilitada para automatización

Errores de actualización de flujo de trabajo

Si las actualizaciones de flujo de trabajo fallan:

  • llame a wdf_data_templates_submissions_get_workflow_meta primero
  • verifique que los IDs de estado/prioridad/tipo sean válidos
  • confirme que el ID de usuario asignado sea válido si se proporciona

Notas de seguridad

  • Nunca codifique credenciales en el código fuente o en repositorios públicos.
  • Prefiera la autenticación basada en encabezados sobre los parámetros de consulta cuando el cliente lo admita.
  • Si está implementando este servidor públicamente, asegúrese de que el endpoint solo sea utilizado por clientes de confianza.
  • El servidor no almacena credenciales de usuario; las espera en cada solicitud.

Resumen rápido

La forma más rápida de usar este servidor MCP es:

  1. Conéctese al servidor con sus credenciales.
  2. Use encabezados primero, parámetros de consulta solo como alternativa.
  3. Comience con wdf_data_templates_list.
  4. Inspeccione el esquema con wdf_data_templates_get_schema_and_sample_submissions.
  5. Busque, cree, actualice o cambie el estado del flujo de trabajo según sea necesario.