remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

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

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
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
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

"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
"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
"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

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
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

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
get_form
- Obtenga información detallada del formulario
- Parámetros:
  - formId (cadena): identificador del formulario
- Devoluciones: Detalles del formulario, incluidas preguntas y configuraciones
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
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
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.

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

Permite la gestión de formularios, el manejo de respuestas y el análisis a través de la API de Fillout.io para mejorar las interacciones y la información de los formularios.

Related Resources

Reddit Discussion about this server

Fillout.io MCP Server