Fillo

Documentación · Guías · Agentes · Registro de cambios

El servidor MCP de Fillo. Le brinda a un agente de codificación el ciclo completo de Fillo — aprovisionar un espacio de trabajo, generar un formulario en el repositorio anfitrión, publicarlo y consultar sus respuestas — sin salir de la sesión, autenticado exactamente como un usuario humano de CLI.

Instalación

Un clic, si tu editor lo admite:

Claude Code:

claude mcp add fillo -- npx -y @usefillo/mcp

Cualquier otro cliente MCP: ejecuta npx -y @usefillo/mcp sobre stdio. Configura FILLO_API para apuntar a un despliegue que no sea de producción.

Credenciales

El servidor lee las mismas credenciales que la CLI escribe en ~/.fillo/config.json, o desde el entorno:

• FILLO_TOKEN — un token de inicio de sesión de fcli_… (de npx @usefillo/cli login). Herramientas autenticadas (fillo_list_forms, fillo_publish_form y envíos confiables a un espacio de trabajo reclamado), además de la selección local de proyectos con un inicio de sesión ordinario. Los envíos de solicitudes de archivos permanecen en borrador/en etapa de revisión.
• FILLO_PK — una clave publicable de pk_…. fillo_provision_workspace genera una y la guarda por ti.
• FILLO_API_KEY — una clave de API de proyecto de fsk_…, generada en Configuración → Conexiones de un espacio de trabajo reclamado. Requerida por las herramientas de respuestas.
• FILLO_API — anula el origen (por defecto https://fillo.so).
• FILLO_CONFIG_DIR — anula el directorio de configuración (por defecto ~/.fillo).

El servidor nunca imprime tokens de inicio de sesión, claves de API o tokens de reclamo en la transcripción. La clave publicable pk_ es segura de mostrar (vive en el código del navegador), por lo que fillo_provision_workspace la devuelve para que la conectes al entorno público de la aplicación. El aprovisionamiento también convierte ese proyecto temporal en el contexto MCP local activo, por lo que un inicio de sesión de cuenta guardado más antiguo no puede recibir el siguiente envío. Seleccionar un proyecto cambia el contexto de vuelta a la cuenta.

Herramientas

Herramienta	Autenticación	Qué hace
fillo_provision_workspace	ninguna (necesita un correo electrónico)	Crea un espacio de trabajo de vista previa no reclamado, devuelve su clave pk_ y límites, y envía por correo su enlace de reclamo.
fillo_whoami	token de inicio de sesión o pk_	Informa la credencial, el espacio de trabajo y el proyecto activos.
fillo_list_projects	token de inicio de sesión ordinario	Lista los proyectos en el espacio de trabajo actual y marca la selección actual.
fillo_create_project	token de inicio de sesión ordinario	Crea y selecciona un proyecto aislado y guarda su clave pk_.
fillo_select_project	token de inicio de sesión ordinario	Selecciona por id, slug o nombre exacto único y actualiza el estado local del proyecto.
fillo_push_form	token de inicio de sesión o pk_	Crea o actualiza un formulario a partir de un esquema + identificador; las solicitudes de archivos permanecen en borrador/en etapa de revisión hasta la publicación explícita.
fillo_publish_form	token de inicio de sesión	Lleva los cambios en borrador o en etapa de revisión a producción después de la revisión; devuelve el enlace exacto de configuración de almacenamiento cuando está bloqueado.
fillo_list_forms	token de inicio de sesión	Lista los formularios del proyecto.
fillo_get_form	ninguna (publicado)	Obtiene el esquema, el tema y las capacidades de un formulario publicado.
fillo_search_examples	ninguna	Busca en la biblioteca de ejemplos curada de Fillo.
fillo_docs	ninguna	Obtiene una página de documentación de Fillo como Markdown por tema.
fillo_list_responses	clave de API de fsk_	Lista las respuestas de un formulario (solo espacios de trabajo reclamados).
fillo_get_response	clave de API de fsk_	Obtiene una respuesta (solo espacios de trabajo reclamados).
fillo_response_summary	clave de API de fsk_	Resume las respuestas de un formulario sin leer cada fila (solo espacios de trabajo reclamados).
fillo_claim_status	pk_	Informa los límites del espacio de trabajo aprovisionado y la fecha límite de reclamo.

No hay herramientas de eliminación. Las anotaciones de escritura aún usan la sugerencia conservadora del peor caso porque un envío puede reemplazar el estado de borrador y una publicación puede reemplazar el esquema público. Cada herramienta es un envoltorio delgado sobre la API HTTP pública de Fillo — el servidor nunca toca la base de datos ni importa código de la aplicación, por lo que el alcance del espacio de trabajo, los límites de velocidad y la validación permanecen en un solo lugar.

Las tres herramientas de proyecto son solo locales y requieren el token general generado por fillo login. Una transferencia específica del proyecto y una concesión OAuth remota alojada de MCP permanecen vinculadas al proyecto que un humano aprobó. Seleccionar localmente también limpia el estado de vista previa en caché y de fsk_ del proyecto anterior; reemplaza cualquier anulación de entorno de FILLO_PK o FILLO_API_KEY tú mismo.

Los proyectos son sitios/aplicaciones bajo un espacio de trabajo facturado. Aíslan formularios, claves publicables/API, orígenes permitidos, identidades de encuestados y autoridad del agente. La membresía del espacio de trabajo, la facturación, las conexiones de almacenamiento y los totales de uso permanecen compartidos.

Enlaces

• Documentación: fillo.so/docs
• Sitio web: fillo.so

Licencia MIT.