Intégration Inoyu MCP Unomi Server

À quoi sert le serveur MCP « Inoyu » ?

Le serveur Inoyu MCP Unomi est un serveur Model Context Protocol (MCP) qui intègre le MCP d’Anthropic à la Customer Data Platform (CDP) Apache Unomi. Cela permet aux assistants IA, comme Claude, d’interagir avec et de gérer les profils utilisateurs dans Unomi, facilitant la conscience contextuelle et la persistance des données utilisateurs entre les sessions. Le serveur prend en charge la recherche et la création de profils via l’email, la gestion des propriétés de profil, la gestion de session et la gestion des « scopes » pour l’isolation contextuelle. En exposant ces capacités via MCP, le serveur Inoyu permet aux agents IA d’effectuer des opérations avancées sur les données utilisateurs (récupération, mise à jour…) et d’améliorer ainsi les workflows de développement nécessitant une gestion persistante et contextuelle des données utilisateurs.

Liste des prompts

Aucun modèle de prompt n’est listé dans le dépôt ou la documentation.

Liste des ressources

Aucune ressource MCP explicite n’est documentée ou listée dans les fichiers du dépôt disponible.

Liste des outils

• get_my_profile
  Récupère le profil de l’utilisateur à partir des variables d’environnement. Permet d’obtenir les informations de segments et de scores, et génère un ID de session basé sur la date actuelle.

• update_my_profile
  Met à jour les propriétés du profil utilisateur. Accepte un objet de propriétés avec des paires clé-valeur supportant différents types (chaîne, nombre, booléen, null).

• get_profile
  Récupère un profil spécifique par son ID depuis Unomi, renvoyant l’ensemble des données du profil.

• search_profiles
  Recherche des profils selon une chaîne de requête, avec paramètres optionnels de limite et d’offset. Recherche dans les champs firstName, lastName et email.

Cas d’usage de ce serveur MCP

• Conversations IA personnalisées
  Permet aux assistants IA de mémoriser et de mettre à jour les informations de l’utilisateur (nom, préférences, statut d’abonnement, etc.), pour une expérience utilisateur plus personnalisée d’une session à l’autre.
• Gestion des données clients
  Facilite la recherche, la mise à jour ou la récupération de profils clients directement depuis Unomi, optimisant le support client et les workflows CRM côté développeurs.
• Segmentation et ciblage utilisateur
  Donne accès aux profils, segments et scores pour segmenter les utilisateurs et adapter le contenu ou les offres via des workflows IA.
• Gestion contextuelle des sessions
  Automatise la gestion des sessions via des IDs basés sur la date, assurant la préservation et l’isolation du contexte utilisateur entre différentes interactions ou sessions.
• Recherche et audit de profils
  Permet de rechercher parmi les profils pour des besoins de conformité, d’audit ou d’analytique, facilitant la gestion de grandes bases utilisateurs de manière automatisée.

Comment le configurer

Windsurf

Aucune instruction spécifique pour Windsurf n’est fournie.

Claude

1. Vérifiez que les prérequis sont remplis (Node.js et npx).
2. Localisez le fichier de configuration :
   • macOS : ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows : %APPDATA%/Claude/claude_desktop_config.json
3. Ajoutez la configuration du serveur 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. Enregistrez la configuration.
5. Redémarrez Claude Desktop pour appliquer les modifications et vérifier la détection du serveur/outils.

Sécurisation des clés API

Utilisez la section env dans la configuration JSON pour définir les identifiants sensibles comme variables d’environnement.

Cursor

Aucune instruction spécifique pour Cursor n’est fournie.

Cline

Aucune instruction spécifique pour Cline n’est fournie.

Comment utiliser ce MCP dans vos flux

Utilisation de MCP dans FlowHunt

Pour intégrer des serveurs MCP à votre workflow FlowHunt, commencez par ajouter le composant MCP à votre flux et reliez-le à votre agent IA :

Cliquez sur le composant MCP pour ouvrir le panneau de configuration. Dans la section de configuration système MCP, insérez les informations de votre serveur MCP avec le format JSON suivant :

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

Une fois configuré, l’agent IA pourra utiliser ce MCP comme outil avec accès à toutes ses fonctions. N’oubliez pas de remplacer « inoyu-unomi » par le nom effectif souhaité et l’URL par l’adresse de votre serveur MCP.

Vue d’ensemble

Notre avis

Ce serveur MCP propose une intégration solide pour la gestion de profils utilisateurs avec Apache Unomi, via un ensemble d’outils clair et une configuration simple pour Claude Desktop. Cependant, l’absence de modèles de prompts, de définitions explicites de ressources et d’instructions spécifiques pour Windsurf, Cursor et Cline limite sa complétude. Il est pour l’instant surtout adapté à l’expérimentation et à l’apprentissage.

Score MCP

Note : 6/10
Le serveur Inoyu MCP Unomi est prometteur pour la gestion des profils Unomi et l’intégration IA, mais son stade précoce, l’absence de détails sur les ressources/prompts et le support multi-plateforme limité réduisent son utilité actuelle pour un public de développeurs plus large.