Integrazione Inoyu MCP Unomi Server

Cosa fa il server “Inoyu” MCP?

Il server Inoyu MCP Unomi è un server Model Context Protocol (MCP) che integra l’MCP di Anthropic con l’Apache Unomi Customer Data Platform (CDP). Questo permette agli assistenti AI, come Claude, di interagire e gestire i profili utente all’interno di Unomi, facilitando la consapevolezza contestuale e la persistenza dei dati utente tra le sessioni. Il server supporta la ricerca e la creazione di profili tramite email, gestione delle proprietà del profilo, gestione delle sessioni e gestione degli scope per l’isolamento del contesto. Esposte queste funzionalità tramite l’MCP, il server Inoyu consente agli agenti AI di eseguire operazioni avanzate sui dati utente, come il recupero o l’aggiornamento delle informazioni, migliorando così i workflow di sviluppo che richiedono gestione dati utente persistenti e ricchi di contesto.

Elenco dei Prompt

Nessun template di prompt è elencato nel repository o nella documentazione.

Elenco delle Risorse

Nessuna risorsa MCP esplicita è documentata o elencata nei file disponibili del repository.

Elenco degli Strumenti

• get_my_profile
  Recupera il profilo dell’utente utilizzando variabili d’ambiente. Supporta il recupero di informazioni su segmenti e punteggi e genera un ID di sessione basato sulla data corrente.

• update_my_profile
  Aggiorna le proprietà del profilo dell’utente. Accetta un oggetto properties con coppie chiave-valore supportando diversi tipi di dati (stringa, numero, booleano, null).

• get_profile
  Recupera un profilo specifico tramite il suo ID da Unomi, restituendo tutti i dati del profilo.

• search_profiles
  Cerca profili in base a una stringa di query, con parametri opzionali di limite e offset. La ricerca avviene tra i campi firstName, lastName ed email.

Casi d’uso di questo MCP Server

• Conversazioni AI Personalizzate
  Permette agli assistenti AI di ricordare e aggiornare informazioni utente (come nome, preferenze o stato abbonamento), offrendo un’esperienza più personalizzata tra le sessioni.
• Gestione Dati Cliente
  Facilita la ricerca, l’aggiornamento o il recupero dei profili cliente direttamente da Unomi, semplificando il supporto e i workflow CRM per gli sviluppatori.
• Segmentazione e Targeting Utente
  Fornisce accesso a profili, segmenti e punteggi, consentendo agli sviluppatori di segmentare gli utenti e personalizzare contenuti o offerte tramite workflow integrati con AI.
• Gestione Contestuale delle Sessioni
  Automatizza la gestione delle sessioni usando ID basati sulla data, assicurando che il contesto utente sia preservato e isolato tra diverse interazioni o sessioni.
• Ricerca e Audit dei Profili
  Permette la ricerca tra i profili per finalità di conformità, audit o analisi, rendendo più facile la gestione di grandi database utenti in modo programmato.

Come configurarlo

Windsurf

Nessuna istruzione specifica per Windsurf è fornita.

Claude

1. Assicurati che i prerequisiti siano soddisfatti (Node.js e npx).
2. Trova il file di configurazione:
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%/Claude/claude_desktop_config.json
3. Aggiungi la configurazione del server 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. Salva la configurazione.
5. Riavvia Claude Desktop per applicare le modifiche e verificare che il server/gli strumenti siano rilevati.

Protezione delle chiavi API

Utilizza la sezione env nella configurazione JSON per impostare le credenziali sensibili come variabili d’ambiente.

Cursor

Nessuna istruzione specifica per Cursor è fornita.

Cline

Nessuna istruzione specifica per Cline è fornita.

Come usare questo MCP nei flussi

Utilizzo di MCP in FlowHunt

Per integrare server MCP nel tuo workflow FlowHunt, inizia aggiungendo il componente MCP al tuo flusso e collegandolo al tuo agente AI:

Clicca sul componente MCP per aprire il pannello di configurazione. Nella sezione di configurazione MCP di sistema, inserisci i dettagli del tuo server MCP usando questo formato JSON:

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

Una volta configurato, l’agente AI potrà usare questo MCP come strumento con accesso a tutte le sue funzioni e capacità. Ricordati di cambiare “inoyu-unomi” con il nome effettivo che desideri utilizzare e sostituire l’URL con l’indirizzo del tuo server MCP.

Panoramica

La nostra opinione

Questo server MCP offre una solida integrazione per la gestione dei profili utente con Apache Unomi tramite una chiara suite di strumenti e una configurazione semplice per Claude Desktop. Tuttavia, l’assenza di template di prompt, definizioni esplicite di risorse e istruzioni specifiche per piattaforme come Windsurf, Cursor e Cline ne limita la completezza. È più indicato per sperimentazione e apprendimento in questa fase.

MCP Score

Valutazione: 6/10
Il server Inoyu MCP Unomi è promettente per la gestione dei profili Unomi e l’integrazione AI, ma la fase iniziale, la mancanza di dettagli su risorse/prompt e le limitazioni nella configurazione multipiattaforma ne riducono attualmente l’utilità per un pubblico di sviluppatori più ampio.