Servidor MCP de Flowlu

El servidor MCP de Flowlu permite que los asistentes de IA como Claude, Cursor y Windsurf trabajen directamente con sus datos de Flowlu: creando oportunidades, consultando proyectos, actualizando tareas, obteniendo resúmenes financieros y más, todo desde una única conversación.

El Model Context Protocol (MCP) es un estándar abierto que permite a los asistentes de IA interactuar de forma fluida con servicios externos a través de una interfaz unificada. En lugar de transferir datos manualmente, puede describir su tarea en lenguaje natural y la IA se encargará de la interacción con la herramienta adecuada para completarla.

Capacidades y módulos disponibles

El servidor MCP de Flowlu funciona a través de la API de la plataforma, realizando todas las acciones en nombre del usuario asociado a la clave API proporcionada. Esto garantiza que los permisos, el acceso a los datos y las restricciones sigan estrictamente la configuración de su cuenta.

El MCP proporciona acceso a todos los módulos clave de la plataforma. Para los módulos de CRM, Proyectos, Tareas, Agile y Control de tiempo, el servidor MCP de Flowlu tiene acceso tanto de lectura como de escritura. Para los módulos de Finanzas, Productos, Calendario y Campos personalizados, tiene acceso de solo lectura.

Modo de vista previa: seguridad integrada para cada escritura

Antes de crear o actualizar cualquier registro en Flowlu, la IA le muestra una vista previa completa de exactamente qué planea escribir, campo por campo. No se ejecuta nada hasta que usted lo confirme explícitamente. Esto se aplica a todas las operaciones de escritura: creación de registros, actualización de registros y adición de comentarios. Sin su confirmación, no se modifica ningún dato. Si algo parece incorrecto en la vista previa, puede corregir su instrucción y volver a intentarlo antes de que se guarde nada.

Herramientas de IA disponibles

El servidor MCP de Flowlu proporciona 11 herramientas especializadas que la IA utiliza para interactuar con sus datos:

Navegación de la estructura de datos

1. describe_modules: Proporciona una visión general de todos los módulos y sus entidades. La IA llama a esto para entender qué está disponible en su espacio de trabajo de Flowlu antes de realizar cualquier acción.
2. describe_entity: Revela el esquema de una entidad específica, incluyendo campos, tipos, descripciones, claves foráneas y listas relacionadas disponibles. La IA usa esto antes de crear o actualizar un registro para asegurarse de que los nombres y formatos de los campos sean correctos.

Recuperación de datos

1. list_records: Recupera una lista de registros para cualquier entidad con soporte para búsqueda y paginación (hasta 100 por solicitud). Esto es lo que se ejecuta cuando pregunta algo como "muéstrame todas las oportunidades abiertas".
2. get_record: Recupera un único registro por su ID único. Se utiliza cuando solicita detalles sobre una oportunidad, tarea o contacto específico.
3. list_related: Obtiene registros vinculados a través de alias, por ejemplo, subtareas de una tarea o conceptos de una factura.
4. list_comments: Recupera los comentarios adjuntos a un registro específico. Se utiliza cuando pregunta "¿cuál es la última actualización de esta oportunidad?".
5. list_files: Enumera los archivos adjuntos a un registro específico. Se utiliza cuando pregunta "¿hay algún documento en esta tarea?".
6. list_users: Muestra una lista de los usuarios de la cuenta. La IA necesita esto para encontrar a la persona adecuada cuando dice "asigna esto a María" o "¿quién es el responsable de esta tarea?".

Entrada de datos

1. create_record: Crea un nuevo registro. Utiliza el modo de vista previa: sin confirmación, la IA muestra lo que pretende crear. Solo guarda los datos cuando usted confirma.
2. update_record: Actualiza un registro existente por ID, también utilizando el modo de vista previa.
3. create_comment: Añade un comentario a un registro, con vista previa antes de publicar.

Limitaciones y restricciones estrictas

El servidor MCP de Flowlu opera dentro del alcance de los métodos estándar de la API (list, get, create y update) y se rige estrictamente por los permisos asignados a la clave API del propietario. Aunque es una herramienta potente para la gestión de datos, tiene varios límites técnicos:

• Los módulos de Finanzas, Productos, Calendario y Campos personalizados son de solo lectura. Puede consultar datos de estos módulos pero no puede crear ni actualizar registros en ellos.
• El MCP no activa procesos de negocio internos no estándar ni inicia automáticamente las reglas de automatización de flujo de trabajo de Flowlu.
• No hay una herramienta de eliminación disponible; toda eliminación de datos debe realizarse manualmente dentro de la interfaz de usuario de Flowlu.
• Aunque puede enumerar archivos y ver sus metadatos, la IA no puede subir nuevos archivos ni leer el contenido real de los documentos.
• El MCP no puede utilizarse para enviar correos electrónicos ni para exportar datos a formatos CSV, Excel o PDF.
• No proporciona acceso a la Configuración del sistema, configuraciones de la cuenta ni a la configuración de webhooks salientes.
• Puede listar usuarios, pero no puede crear, actualizar ni desactivar cuentas de usuario.
• La gestión de filtros complejos y ajustes de todo el sistema sigue siendo mejor directamente a través de la interfaz de Flowlu.
• Su uso requiere un cliente de IA externo que sea compatible específicamente con el Model Context Protocol.

Configuración de la conexión

Para conectarse al MCP de Flowlu, primero debe crear una clave API. Puede hacerlo accediendo a la configuración de la cuenta.

A continuación, vaya a la sección de Configuración de API.

Y haga clic en el botón Añadir.

Introduzca el nombre de la clave API, seleccione las aplicaciones requeridas y luego haga clic en el botón Guardar.

Guarde su clave API.

Nota: No podrá volver a ver la clave API.

Para configurar MCP, también necesitará el código de cuenta, que puede encontrar en la barra de direcciones de su navegador. Por ejemplo, si su barra de direcciones muestra https://mycompany.flowlu.com, su código de cuenta es mycompany.

Después de eso, puede añadir la configuración del MCP de Flowlu en los ajustes de su herramienta de IA. Pegue su clave API y el código de cuenta en la configuración.

{
  "mcpServers": {
    "flowlu": {
      "url": "https://mcp.flowlu.com/mcp",
      "headers": {
        "x-account-code": "<your-account-code>",
        "Authorization": "Bearer <your-api-key>"
      }
    }
  }
}

A continuación se ofrece una lista de herramientas compatibles y enlaces a la documentación de configuración del servidor MCP.

Herramientas de IA compatibles

El MCP de Flowlu se basa en la autorización mediante encabezados estáticos, un enfoque comúnmente admitido. Las siguientes herramientas de IA están listas para usar sin configuración adicional.

Nota: La versión web de Claude (Claude.ai) no admite actualmente MCP. Debe utilizar la aplicación Claude Desktop.

Preguntas frecuentes (FAQ)

¿Qué pasa si la IA comete un error?

Cada acción de creación y actualización pasa primero por un paso de vista previa. La IA presenta lo que está a punto de escribir y no sucede nada hasta que usted confirma. Si algo parece incorrecto, simplemente no confirma y corrige la instrucción en su lugar.

¿Funciona esto con Claude en la web (claude.ai)?

No por el momento. La versión web de Claude no admite conexiones MCP. Necesitará Claude Desktop (la app) o Claude Code (CLI). Cursor, Windsurf, VS Code Copilot y los demás clientes enumerados también funcionan.

¿Existen límites de velocidad (rate limits)?

El servidor MCP funciona a través de la API de Flowlu, por lo que se aplican los límites de velocidad estándar de la API. Para un uso típico (crear registros, realizar consultas, obtener informes), es poco probable que los alcance.

¿Puedo usar MCP y la interfaz web de Flowlu al mismo tiempo?

Sí. La conexión MCP no bloquea nada. Puede tener la interfaz de Flowlu abierta en su navegador mientras su asistente de IA trabaja a través de MCP. Los cambios realizados a través de cualquier canal aparecen inmediatamente.

¿Funcionará el MCP con ChatGPT?

El MCP funciona con cualquier cliente de IA que admita el protocolo. Hasta ahora, los clientes probados incluyen Claude Desktop, Claude Code, Cursor, Windsurf, VS Code Copilot, Codex (OpenAI), Continue y Cline. Si ChatGPT u otras herramientas añaden soporte para MCP, el servidor de Flowlu funcionará con ellas automáticamente.

Si tiene algún problema o duda, póngase en contacto con nuestro equipo de soporte a través del chat de la aplicación o envíenos un correo electrónico a [email protected]