Inoyu MCP Unomi Server-integratie

Wat doet de “Inoyu” MCP Server?

De Inoyu MCP Unomi Server is een Model Context Protocol (MCP) server die Anthropic’s MCP integreert met het Apache Unomi Customer Data Platform (CDP). Hierdoor kunnen AI-assistenten, zoals Claude, gebruikersprofielen binnen Unomi beheren en ermee interageren, wat zorgt voor contextbewustzijn en persistente gebruikersdata over sessies heen. De server ondersteunt profielopzoeking en -creatie via e-mail, profielpropertybeheer, sessiebehandeling en scopebeheer voor contextisolatie. Door deze mogelijkheden via MCP beschikbaar te stellen, stelt de Inoyu-server AI-agenten in staat geavanceerde gebruikersdata-operaties uit te voeren, zoals het ophalen of bijwerken van gebruikersinformatie, en verbetert zo ontwikkelworkflows die persistente, contextrijke gebruikersdatabeheer vereisen.

Lijst met prompts

Er zijn geen prompt-templates vermeld in de repository of documentatie.

Lijst met bronnen

Er zijn geen expliciete MCP-bronnen gedocumenteerd of vermeld in de beschikbare repositorybestanden.

Lijst met tools

• get_my_profile
  Haalt het gebruikersprofiel op via omgevingsvariabelen. Ondersteunt het ophalen van segment- en score-informatie en genereert een sessie-ID op basis van de huidige datum.

• update_my_profile
  Werkt eigenschappen van het gebruikersprofiel bij. Accepteert een properties-object met key-value paren die verschillende datatypes ondersteunen (string, getal, boolean, null).

• get_profile
  Haalt een specifiek profiel op via het ID uit Unomi en retourneert de volledige profielgegevens.

• search_profiles
  Zoekt naar profielen op basis van een querystring, met optionele limiet- en offsetparameters. Zoekt in de velden voornaam, achternaam en e-mail.

Gebruiksscenario’s van deze MCP Server

• Gepersonaliseerde AI-gesprekken
  Maakt het AI-assistenten mogelijk om gebruikersinformatie (zoals naam, voorkeuren of abonnementsstatus) te onthouden en bij te werken, wat zorgt voor een meer gepersonaliseerde gebruikerservaring over meerdere sessies.
• Klantgegevensbeheer
  Maakt het eenvoudig om klantprofielen rechtstreeks uit Unomi op te zoeken, bij te werken of op te halen, waardoor klantenservice- en CRM-workflows voor ontwikkelaars worden gestroomlijnd.
• Gebruikerssegmentatie en targeting
  Biedt toegang tot profielen, segmenten en scores, zodat ontwikkelaars gebruikers kunnen segmenteren en content of aanbiedingen kunnen afstemmen via AI-geïntegreerde workflows.
• Contextuele sessiebehandeling
  Automatiseert het sessiebeheer via datumgebaseerde ID’s, waardoor gebruikerscontext behouden en geïsoleerd blijft over verschillende interacties of sessies.
• Profielzoekopdrachten en auditing
  Maakt zoeken binnen profielen mogelijk voor compliance, auditing of analysetoepassingen, zodat grote gebruikersdatabases eenvoudiger programmatic beheerd kunnen worden.

Hoe stel je het in

Windsurf

Er zijn geen specifieke Windsurf-instructies beschikbaar.

Claude

1. Zorg dat aan de vereisten is voldaan (Node.js en npx).
2. Zoek het configuratiebestand:
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%/Claude/claude_desktop_config.json
3. Voeg de Inoyu MCP Unomi Server-configuratie toe:

{
  "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. Sla de configuratie op.
5. Herstart Claude Desktop om de wijzigingen toe te passen en controleer of de server/tools worden herkend.

Beveiligen van API-sleutels

Gebruik de env-sectie in de JSON-configuratie om gevoelige gegevens als omgevingsvariabelen vast te leggen.

Cursor

Er zijn geen specifieke Cursor-instructies beschikbaar.

Cline

Er zijn geen specifieke Cline-instructies beschikbaar.

Hoe gebruik je deze MCP in flows

MCP gebruiken in FlowHunt

Om MCP-servers in je FlowHunt-workflow te integreren, begin je met het toevoegen van het MCP-component aan je flow en verbind je deze met je AI-agent:

Klik op het MCP-component om het configuratiepaneel te openen. Voeg in het systeem-MCP-configuratiegedeelte je MCP-serverdetails toe met dit JSON-formaat:

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

Zodra geconfigureerd, kan de AI-agent deze MCP nu als tool gebruiken met toegang tot alle functies en mogelijkheden. Vergeet niet “inoyu-unomi” te wijzigen naar de gewenste naam en de URL te vervangen door het adres van je MCP-server.

Overzicht

Onze mening

Deze MCP-server biedt een degelijke integratie voor profielbeheer met Apache Unomi via een duidelijke set tools en eenvoudige setup voor Claude Desktop. Het ontbreken van prompt-templates, expliciete resource-definities en platformspecifieke instructies voor Windsurf, Cursor en Cline beperkt echter de volledigheid. Het is op dit moment vooral geschikt voor experimentatie en leren.

MCP-score

Beoordeling: 6/10
De Inoyu MCP Unomi Server is veelbelovend voor Unomi-profielbeheer en AI-integratie, maar het vroege stadium, het ontbreken van resource/promptdetails en beperkte multi-platform setup verminderen momenteel de bruikbaarheid voor bredere ontwikkelaarsdoelgroepen.