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

Related MCP server: Loxo MCP Server

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

{
 "mcpServers": {
 "fillout": {
 "command": "docker",
 "args": [
 "run",
 "-i",
 "--rm",
 "-e",
 "FILLOUT_API_KEY",
 "mcp/fillout"
 ],
 "env": {
 "FILLOUT_API_KEY": "your-fillout-api-key"
 }
 }
 }
}

Configuración NPX

{
 "mcpServers": {
 "fillout": {
 "command": "npx",
 "args": [
 "-y",
 "@modelcontextprotocol/server-fillout"
 ],
 "env": {
 "FILLOUT_API_KEY": "your-fillout-api-key"
 }
 }
 }
}

Edificio

Prerrequisitos

• Node.js 18 o posterior

• npm o hilo

• Docker (opcional)

Desarrollo local

# Install dependencies
npm install

# Run in development mode
npm run dev

# Build for production
npm run build

Compilación de Docker

# Build image
docker build -t mcp/fillout .

# Run container
docker run -e FILLOUT_API_KEY=your-key mcp/fillout

Ejemplos

Creando un formulario

const form = await client.createForm({
 name: "Customer Feedback",
 description: "Please share your experience",
 questions: [
 {
 type: "ShortAnswer",
 name: "What did you like most?",
 required: true
 },
 {
 type: "MultipleChoice",
 name: "Would you recommend us?",
 required: true,
 choices: ["Yes", "No", "Maybe"]
 }
 ]
});

Enviar una respuesta

const response = await client.submitFormResponse(formId, {
 responses: [
 {
 questionId: "q1",
 value: "Great customer service!"
 },
 {
 questionId: "q2",
 value: "Yes"
 }
 ]
});

Manejo de errores

El servidor proporciona mensajes de error detallados para problemas comunes:

try {
 const forms = await client.listForms();
} catch (error) {
 if (error instanceof AuthenticationError) {
 // Handle invalid API key
 } else if (error instanceof FilloutError) {
 // Handle API-specific errors
 } else {
 // Handle unexpected errors
 }
}

Licencia

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

Resources

• GitHub Repository
Need Help?
• Reddit Discussion
Related Servers