Este artículo también está disponible en:

Como conectar tu asistente de IA al servidor MCP de Flokzu

Resumen

El servidor MCP (Model Context Protocol) de Flokzu permite que asistentes de IA interactúen con tu cuenta de Flokzu mediante lenguaje natural.
Sin abrir la plataforma, puedes crear instancias de procesos, consultar y modificar registros de bases de datos, gestionar usuarios y roles y exportar el historial de instancias.

Antes de empezar

Necesitas contar con los siguientes datos:

API Key: su scope/alcance definirá las acciones que podrás ejecutar desde el asistente de IA. Revisa como crear y administrar API Keys aquí.
Email del usuario: email del usuario administrador en cuyo nombre se ejecutarán las operaciones

Importante: trata la API Key como una contraseña. No la publiques en repositorios públicos ni las compartas por canales inseguros.

Además, necesitas un cliente compatible con MCP, como Claude Desktop, Claude Code, Cursor, VS Code u otro agente que soporte el transporte HTTP de MCP.

Configuración

El servidor MCP de Flokzu se puede utilizar con cualquier cliente compatible que permita configurar credenciales por header. Cada usuario deberá configurar manualmente utilizando autenticando con la API key y usuario de Flokzu.

Ten presente que algunos clientes o agentes no permiten enviar las credenciales en las cabeceras de la llamada REST y no podrán ser utilizados.

Para todos los clientes compatibles , la estructura es la misma: una entrada en el archivo de configuración MCP del cliente, con el endpoint y los encabezados.
En las siguientes secciones se detalla la configuración para Claude Desktop/Code y Cursor.

Si tu cliente usa otra ruta de archivo, sigue su documentación oficial, pero usa el mismo endpoint y los mismos headers mostrados a continuación.

Endpoint del servidor MCP

https://i1gh41m7fi.execute-api.us-east-1.amazonaws.com/mcp

Claude Desktop / Claude Code

Edita el archivo .mcp.json a nivel de proyecto o claude_desktop_config.json a nivel global y agrega:

{
  "mcpServers": {
    "flokzu-openapi": {
      "type": "http",
      "url": "https://imj8y0k282.execute-api.us-east-1.amazonaws.com/mcp",
      "headers": {
        "Authorization": "Bearer <TU_API_KEY>",
        "X-Flokzu-Username": "<TU_EMAIL>"
       }
    }
  }
}

Reinicia Claude para que tome los cambios.

Cursor

Edita .cursor/mcp.json a nivel de proyecto o ~/.cursor/mcp.json a nivel global con la misma estructura del bloque anterior.

Herramientas disponibles

El servidor expone diferentes herramientas, agrupadas por dominio funcional.

Instancias de procesos

Iniciar una nueva instancia de un proceso
Obtener los datos de una instancia de proceso existente
Actualizar valores de campos de una instancia de proceso existente

Bases de datos

Listar registros, incluyendo paginación y filtros
Obtener un registro identificado por su ID
Crear un registro nuevo
Modificar un registro existente

Gestión de usuarios y roles

Enviar invitación a un nuevo usuario
Eliminar un usuario del tenant
Listar los roles asignados a un usuario
Asignar roles a un usuario
Quitar roles a un usuario

Exportación de datos

Historial de una instancia
Historial completo con detalle de campos
Metadata de documentos adjuntos

Ejemplos de uso

Una vez configurado el servidor, puedes interactuar con Flokzu desde el chat de tu cliente de IA usando lenguaje natural.

Por ejemplo:

"Crea una instancia del proceso de Solicitud de Compra con el monto en 5000 USD y proveedor ACME."
"Lista los últimos 20 registros de la base de datos Productos donde el stock sea menor a 10."
"Invita a juan@empresa.com como usuario y asígnale el rol de Aprobador."

El asistente traduce la solicitud a la herramienta correspondiente y devuelve el resultado.

Seguridad

Transporte cifrado: todo el tráfico viaja por HTTPS. Las credenciales se protegen en tránsito.
Sin almacenamiento de credenciales: el servidor MCP no persiste tus API Keys; las usa únicamente para el request en curso.
Aislamiento por tenant: la API Key restringe el acceso a los datos de tu tenant. No hay forma de leer información de otros clientes de Flokzu.
Auditoría: cada operación queda registrada en el historial de Flokzu asociada al email configurado.

Preguntas frecuentes

¿Mis datos viajan al proveedor de IA?

Solo viaja al proveedor de IA lo que tú muestras en el chat: los inputs que escribes y los outputs que el modelo devuelve.
Las llamadas al servidor MCP salen directo de tu cliente local hacia Flokzu, sin pasar por servidores del proveedor de IA.

¿Puedo limitar qué herramientas usa la IA?

La mayoría de los clientes MCP permiten habilitar o deshabilitar herramientas individuales desde su configuración. Revisa la documentación de tu cliente.

¿Qué pasa si rota o vence mi API Key?

Actualiza el valor en el archivo de configuración del cliente y reinicia. No hay sesión persistente.

Actualizado el: 06/07/2026

¿Este artículo te resultó útil?

¡Gracias!