Servidor MCP de Fillout.io

Servidor MCP para la API de Fillout.io, que permite la gestión de formularios, el manejo de respuestas y el análisis.

Configuración del token

1. Obtenga su clave API de Fillout.io:

   • Inicie sesión en su cuenta de Fillout.io

   • Vaya a Configuración de la cuenta → API y webhooks

   • Haga clic en "Crear nueva clave API".

   • Copia tu nueva clave API

2. Información de la clave API:

   • Las claves de producción comienzan con fo_live_

   • Las claves de prueba comienzan con fo_test_

   • Las claves de prueba solo funcionan con formularios de prueba

   • Las claves API proporcionan acceso a todos los recursos de su cuenta

3. Reemplace your-fillout-api-key en la configuración con su clave API.

⚠️ Notas de seguridad:

• Mantenga su clave API segura y privada

• Utilice claves de prueba para el desarrollo

• Almacenar claves en variables de entorno

• Gire las llaves periódicamente

• Nunca envíe claves al control de versiones

Solución de problemas de tokens

Mensajes de error comunes

1. "Clave API proporcionada no válida" o "Error de autenticación"

   • Causa : La clave API falta, está mal formada o no es válida

   • Solución :

     • Verifique que la clave comience con fo_live_ o fo_test_

     • Comprobar si hay espacios o caracteres adicionales

     • Asegúrese de que la variable de entorno esté configurada correctamente

     • Crea una nueva clave si es necesario

2. "Tecla de modo de prueba utilizada con formulario en vivo"

   • Causa : Uso de la clave de prueba ( fo_test_ ) con el formulario de producción

   • Solución :

     • Utilice claves activas para formularios de producción

     • Crear formulario de prueba para desarrollo

     • Cambiar al tipo de clave apropiado

3. "Límite de velocidad excedido"

   • Causa : demasiadas solicitudes de API

   • Solución :

     • Implementar la limitación de solicitudes

     • Comprobar el uso en el panel de control

     • Optimizar patrones de solicitud

Pasos de validación

1. Comprobar el formato de la clave API:

   # Key should: - Start with 'fo_live_' or 'fo_test_' - Be approximately 50 characters - Contain only letters, numbers, and underscores

2. Clave API de prueba:

   curl -H "Authorization: Bearer your-api-key" \ https://api.fillout.com/v1/api/forms

Características

Gestión de formularios

• Enumere todos los formularios

• Obtener detalles del formulario

• Crear nuevos formularios

• Eliminar formularios

• Actualizar la configuración del formulario

Manejo de respuestas

• Enviar respuestas del formulario

• Obtener envíos de formularios

• Filtrar respuestas

• Exportar respuestas

Analítica

• Tasas de respuesta

• Tiempos de finalización

• Tendencias de envío

Herramientas

1. list_forms

   • Obtenga todos los formularios accesibles

   • Parámetros:

     • limit (opcional): Número de formularios a devolver

     • offset (opcional): desplazamiento de paginación

   • Devuelve: Matriz de objetos de formulario

2. get_form

   • Obtenga información detallada del formulario

   • Parámetros:

     • formId (cadena): identificador del formulario

   • Devoluciones: Detalles del formulario, incluidas preguntas y configuraciones

3. create_form

   • Crear un nuevo formulario

   • Parámetros:

     • name (cadena): Nombre del formulario

     • description (cadena opcional): Descripción del formulario

     • questions (matriz): Matriz de objetos de pregunta

       • type : Tipo de pregunta (por ejemplo, 'Respuesta corta', 'Opción múltiple')

       • name : Texto de la pregunta

       • required : si la pregunta es obligatoria

       • choices : Matriz de opciones para preguntas de opción múltiple

   • Devuelve: objeto de formulario creado

4. get_form_responses

   • Obtener envíos de formularios

   • Parámetros:

     • formId (cadena): identificador del formulario

     • filters (opcionales): filtros de respuesta

     • pageSize (opcional): Resultados por página

     • afterDate (opcional): Filtrar por fecha de envío

     • beforeDate (opcional): Filtrar por fecha de envío

     • status (opcional): Filtrar por estado de finalización

   • Devuelve: Matriz de respuestas del formulario

5. submit_form_response

   • Enviar una nueva respuesta

   • Parámetros:

     • formId (cadena): identificador del formulario

     • responses (matriz): Matriz de respuestas

       • questionId : Identificador de la pregunta

       • value : Valor de respuesta

     • calculations (opcional): cálculos personalizados

   • Devoluciones: Confirmación de envío

Configuración

Uso con Claude Desktop

Configuración de Docker

Configuración NPX

Edificio

Prerrequisitos

• Node.js 18 o posterior

• npm o hilo

• Docker (opcional)

Desarrollo local

Compilación de Docker

Ejemplos

Creando un formulario

Enviar una respuesta

Manejo de errores

El servidor proporciona mensajes de error detallados para problemas comunes:

Licencia

Este proyecto está licenciado bajo la Licencia MIT. Consulte el archivo de LICENCIA para más detalles.