- Visión General
- Qué es MCP
- Quién Puede Acceder
- Cómo Funciona el Acceso
- Autenticación mediante OAuth
- Qué Puede Hacer el MCP
- Limitaciones y lo que NO Hace
- Preguntas Frecuentes (FAQ)
Visión General
El MCP (Model Context Protocol) es un servidor que permite que agentes de IA, como Claude y Cursor, operen directamente en Checklist Fácil. Con el MCP, usted puede ejecutar acciones utilizando comandos en lenguaje natural, sin necesidad de conocimientos técnicos en APIs.
Por ejemplo, en lugar de elaborar una solicitud técnica, usted puede simplemente decir: "cree una unidad llamada XYZ" y la IA identifica la acción, solicita los datos faltantes y confirma antes de ejecutar.
El MCP es diferente de la API REST tradicional: la propia IA interpreta sus comandos en lenguaje natural y ejecuta las acciones de forma segura y confirmada.
El recurso está disponible para los planes Professional y Enterprise.
Qué es MCP
MCP es un protocolo abierto que funciona como un intermediario entre agentes de IA (como Claude) y Checklist Fácil. Permite que la IA ejecute operaciones directamente en el sistema sin que usted tenga que escribir código o solicitudes API.
Principales beneficios:
- Acceso simplificado mediante lenguaje natural
- Sin necesidad de conocimientos técnicos en APIs
- Confirmación automática antes de acciones destructivas
- Autenticación segura mediante OAuth
- Integración directa con herramientas de IA populares
Quién Puede Acceder
El acceso al MCP está restringido por razones de seguridad. Solo los usuarios con permiso de Administración General pueden completar la autenticación y utilizar el MCP.
Si un usuario sin este permiso intenta acceder al MCP, será bloqueado en la pantalla de autorización, antes de que se cree cualquier sesión. La única opción disponible será el botón "Cancelar".
Importante: Solo los administradores generales pueden autenticarse y utilizar el MCP. Verifique sus permisos antes de intentar configurar el acceso.
Cómo Funciona el Acceso
El flujo de acceso al MCP consta de tres etapas principales:
1. Registrar la Dirección del MCP
En el cliente de IA (como Claude Desktop o Cursor), registre la dirección del servidor MCP de Checklist Fácil:
https://mcp.checklistfacil.com.br/mcp
2. Iniciar Sesión y Autorizar
Después de registrar la dirección, será redirigido para iniciar sesión en el navegador. Allí, usted autoriza al cliente de IA a acceder a su cuenta de Checklist Fácil. Este es el paso de autenticación OAuth, que garantiza la seguridad de la conexión.
3. Recibir el Token de Sesión
Tras autorizar con éxito, el servidor emite un token de sesión (JWT). Este token mantiene su sesión activa para los accesos posteriores, sin necesidad de autenticarse nuevamente en cada comando.
Autenticación mediante OAuth
El MCP utiliza OAuth para la autenticación segura. Este es un estándar de seguridad ampliamente adoptado que permite que aplicaciones de terceros accedan a su cuenta de forma controlada.
Cómo funciona:
- Usted inicia sesión en el navegador utilizando sus credenciales de Checklist Fácil
- Usted autoriza al cliente de IA a acceder a su cuenta
- Se genera un token seguro (JWT) que es almacenado por el cliente
- El token permite que el cliente ejecute acciones en su nombre, sin exponer su contraseña
OAuth sustituyó el modelo anterior de Bearer Token/clave de API generada manualmente, ofreciendo mayor seguridad y facilidad de uso.
Qué Puede Hacer el MCP
El MCP le permite ejecutar una variedad de operaciones directamente en Checklist Fácil utilizando lenguaje natural:
Estructura Organizacional
- Crear y listar unidades
- Crear y listar tipos de unidad
- Crear y listar departamentos
- Vincular entidades (por ejemplo: unidad a tipo de unidad, usuario a unidad)
Usuarios
- Listar usuarios y tipos de usuarios existentes
- Invitar nuevos usuarios por correo electrónico
- Vincular usuarios a unidades, checklists y departamentos
Checklists
- Listar checklists existentes
- Consultar la estructura completa de un checklist
- Crear checklists automáticamente mediante IA (generación automática)
- Generar enlaces de aplicación para checklists
- Importar checklists a partir de archivos
- Vincular checklists a unidades y departamentos
Importante: Algunas acciones tienen límites. Por ejemplo, es posible vincular hasta 20 entidades por llamada. Además, la creación de checklists no es granular - la IA crea el checklist completo, no ítem por ítem.
Limitaciones y lo que NO Hace
Aunque el MCP es potente, existen funcionalidades que aún no están disponibles en él. Para esas operaciones, usted puede utilizar la API REST tradicional de Checklist Fácil.
El MCP NO puede:
- Gestionar registros y catálogos
- Crear o gestionar Programaciones
- Crear o gestionar Planes de Acción
- Acceder a evaluaciones ya aplicadas
- Gestionar regiones y grupos
- Configurar webhooks, SSO o IoT
- Acceder a datos de ubicación (país, estado, ciudad)
Para esas funcionalidades, consulte la documentación de la API REST de Checklist Fácil o comuníquese con nuestro soporte.
Preguntas Frecuentes (FAQ)
1. ¿Qué es mejor utilizar: MCP o API REST?
Depende de su caso de uso. Si desea automatizar tareas utilizando un agente de IA (Claude, Cursor), el MCP es más sencillo porque trabaja con lenguaje natural. La API REST es ideal si desea construir integraciones complejas o necesita funcionalidades que el MCP aún no ofrece.
2. ¿Puedo utilizar el MCP sin conocimientos técnicos?
Sí. El MCP fue diseñado para ser accesible. Usted describe lo que desea hacer en lenguaje natural y la IA se encarga del resto. No obstante, necesita tener permiso de Administración General para acceder al MCP.
3. ¿Cuál es la dirección del servidor MCP?
La dirección es https://mcp.checklistfacil.com.br/mcp. Regístrela en su cliente de IA (como Claude Desktop) para comenzar.
4. ¿Mi token de sesión va a expirar?
El token de sesión (JWT) se emite tras la autenticación OAuth exitosa y permanece activo para los accesos posteriores. Si el token expira, deberá iniciar sesión nuevamente en el navegador para obtener un nuevo token.
5. ¿El MCP está disponible en todas las regiones?
Sí, el MCP está disponible para toda la base de usuarios. Puede utilizar la misma dirección de servidor independientemente de su ubicación.
6. ¿Cómo puedo vincular un usuario a múltiples unidades?
Puede hacerlo a través del MCP en lenguaje natural. Por ejemplo, indique a su agente de IA: "vincule a Juan a las unidades A, B y C". El límite es de hasta 20 vínculos por llamada.
7. ¿Puedo crear checklists ítem por ítem con el MCP?
No. La creación de checklists mediante MCP no es granular. La IA crea el checklist completo (con todas las áreas e ítems) de una sola vez. Para crear o editar ítems individuales, puede utilizar la interfaz de Checklist Fácil.
8. ¿Cómo utilizo el MCP en Claude Desktop?
Abra las configuraciones de Claude Desktop, localice la sección de MCPs y registre la dirección https://mcp.checklistfacil.com.br/mcp. Después, inicie sesión en el navegador cuando se le solicite y autorice el acceso. Tras ello, podrá utilizar el MCP normalmente en la conversación con Claude.
❓Tem dúvidas? Entre em contato com nosso time de suporte.