Integración del Servidor Inoyu MCP Unomi

¿Qué hace el Servidor “Inoyu” MCP?

El Servidor Inoyu MCP Unomi es un servidor Model Context Protocol (MCP) que integra el MCP de Anthropic con la Plataforma de Datos de Cliente (CDP) Apache Unomi. Esto permite que asistentes de IA, como Claude, interactúen y gestionen perfiles de usuario dentro de Unomi, facilitando la conciencia contextual y la persistencia de datos de usuario entre sesiones. El servidor soporta la búsqueda y creación de perfiles usando email, gestión de propiedades de perfil, manejo de sesiones y administración de ámbitos para el aislamiento de contexto. Al exponer estas capacidades vía MCP, el servidor Inoyu permite que los agentes de IA realicen operaciones avanzadas de datos de usuario, como recuperar o actualizar información, mejorando así los flujos de desarrollo que requieren una gestión persistente y rica en contexto de datos de usuario.

Lista de Prompts

No se listan plantillas de prompts en el repositorio o la documentación.

Lista de Recursos

No se documentan ni listan recursos MCP explícitos en los archivos del repositorio disponibles.

Lista de Herramientas

• get_my_profile
  Recupera el perfil del usuario usando variables de entorno. Soporta recuperar información de segmentos y puntuaciones, y genera un ID de sesión basado en la fecha actual.

• update_my_profile
  Actualiza propiedades del perfil del usuario. Acepta un objeto de propiedades con pares clave-valor que soportan varios tipos de datos (string, number, boolean, null).

• get_profile
  Recupera un perfil específico por su ID desde Unomi, devolviendo todos los datos del perfil.

• search_profiles
  Busca perfiles con base en una cadena de consulta, con parámetros opcionales de límite y desplazamiento. Busca entre los campos firstName, lastName y email.

Casos de Uso de este Servidor MCP

• Conversaciones de IA Personalizadas
  Permite a los asistentes de IA recordar y actualizar información de usuario (como nombre, preferencias o estado de suscripción), ofreciendo una experiencia más personalizada a lo largo de las sesiones.
• Gestión de Datos de Clientes
  Facilita la búsqueda, actualización o recuperación sencilla de perfiles de clientes directamente desde Unomi, optimizando la atención al cliente y los flujos de trabajo CRM para desarrolladores.
• Segmentación y Enfoque de Usuarios
  Proporciona acceso a perfiles, segmentos y puntuaciones, permitiendo segmentar usuarios y personalizar contenidos u ofertas mediante flujos integrados con IA.
• Manejo Contextual de Sesiones
  Automatiza la gestión de sesiones usando IDs basados en la fecha, asegurando que el contexto de usuario se preserve y aísle entre diferentes interacciones o sesiones.
• Búsqueda y Auditoría de Perfiles
  Permite buscar entre perfiles para fines de cumplimiento, auditoría o análisis, facilitando la gestión programática de grandes bases de usuarios.

Cómo configurarlo

Windsurf

No se proporcionan instrucciones específicas para Windsurf.

Claude

1. Asegúrate de cumplir los requisitos previos (Node.js y npx).
2. Localiza el archivo de configuración:
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%/Claude/claude_desktop_config.json
3. Añade la configuración del Servidor Inoyu MCP Unomi:

{
  "mcpServers": {
    "unomi-server": {
      "command": "npx",
      "args": ["@inoyu/mcp-unomi-server"],
      "env": {
        "UNOMI_BASE_URL": "http://your-unomi-server:8181",
        "UNOMI_USERNAME": "your-username",
        "UNOMI_PASSWORD": "your-password",
        "UNOMI_PROFILE_ID": "your-profile-id",
        "UNOMI_KEY": "your-unomi-key",
        "UNOMI_EMAIL": "your-email@example.com",
        "UNOMI_SOURCE_ID": "claude-desktop"
      }
    }
  }
}

4. Guarda la configuración.
5. Reinicia Claude Desktop para aplicar los cambios y verificar que el servidor/herramientas hayan sido detectados.

Protección de las Claves API

Utiliza la sección env en la configuración JSON para establecer las credenciales sensibles como variables de entorno.

Cursor

No se proporcionan instrucciones específicas para Cursor.

Cline

No se proporcionan instrucciones específicas para Cline.

Cómo usar este MCP dentro de flujos

Uso de MCP en FlowHunt

Para integrar servidores MCP en tu flujo de trabajo de FlowHunt, comienza añadiendo el componente MCP a tu flujo y conectándolo a tu agente de IA:

Haz clic en el componente MCP para abrir el panel de configuración. En la sección de configuración MCP del sistema, inserta los detalles de tu servidor MCP usando este formato JSON:

{
  "inoyu-unomi": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Una vez configurado, el agente de IA podrá usar este MCP como una herramienta con acceso a todas sus funciones y capacidades. Recuerda cambiar “inoyu-unomi” por el nombre real que desees utilizar y reemplazar la URL por la dirección de tu servidor MCP.

Resumen

Nuestra opinión

Este servidor MCP ofrece una integración sólida para la gestión de perfiles de usuario con Apache Unomi a través de un conjunto claro de herramientas y una configuración sencilla para Claude Desktop. Sin embargo, la ausencia de plantillas de prompt, definiciones explícitas de recursos e instrucciones específicas para Windsurf, Cursor y Cline limita su completitud. Actualmente es más adecuado para experimentación y aprendizaje.

Puntuación MCP

Calificación: 6/10
El Servidor Inoyu MCP Unomi es prometedor para la gestión de perfiles en Unomi y la integración con IA, pero su estado temprano, la falta de detalles de recursos/prompts y la configuración limitada multiplataforma reducen su utilidad actual para audiencias de desarrolladores más amplias.