Integracja Inoyu MCP Unomi Server

Co robi serwer „Inoyu” MCP?

Serwer Inoyu MCP Unomi to serwer Model Context Protocol (MCP), który integruje MCP firmy Anthropic z platformą Apache Unomi Customer Data Platform (CDP). Dzięki temu asystenci AI, tacy jak Claude, mogą wchodzić w interakcje i zarządzać profilami użytkowników w Unomi, zapewniając świadomość kontekstu i trwałość danych użytkownika pomiędzy sesjami. Serwer obsługuje wyszukiwanie i tworzenie profili po e-mailu, zarządzanie właściwościami profilu, obsługę sesji oraz zarządzanie scope dla izolacji kontekstu. Udostępniając te możliwości przez MCP, serwer Inoyu pozwala agentom AI wykonywać zaawansowane operacje na danych użytkowników, takie jak pobieranie lub aktualizacja informacji o użytkowniku, co usprawnia tworzenie rozwiązań wymagających trwałego, bogatego w kontekst zarządzania danymi użytkownika.

Lista promptów

W repozytorium ani dokumentacji nie wymieniono szablonów promptów.

Lista zasobów

W dostępnych plikach repozytorium nie udokumentowano ani nie wymieniono żadnych jawnych zasobów MCP.

Lista narzędzi

• get_my_profile
  Pobiera profil użytkownika wykorzystując zmienne środowiskowe. Obsługuje także pobieranie segmentów i punktacji oraz generuje identyfikator sesji na podstawie aktualnej daty.

• update_my_profile
  Aktualizuje właściwości profilu użytkownika. Przyjmuje obiekt properties z parami klucz-wartość obsługującymi różne typy danych (string, number, boolean, null).

• get_profile
  Pobiera konkretny profil po jego ID z Unomi, zwracając pełne dane profilu.

• search_profiles
  Wyszukuje profile na podstawie ciągu zapytania, z opcjonalnymi parametrami limit i offset. Przeszukuje pola firstName, lastName i email.

Przypadki użycia tego serwera MCP

• Spersonalizowane rozmowy AI
  Pozwala asystentom AI zapamiętywać i aktualizować informacje o użytkowniku (np. imię, preferencje, status subskrypcji), oferując bardziej spersonalizowane doświadczenie w kolejnych sesjach.
• Zarządzanie danymi klientów
  Ułatwia szybkie wyszukiwanie, aktualizację lub pobieranie profili klientów bezpośrednio z Unomi, usprawniając wsparcie klienta i procesy CRM u deweloperów.
• Segmentacja i targetowanie użytkowników
  Zapewnia dostęp do profili, segmentów i punktacji, umożliwiając deweloperom segmentację użytkowników i dostosowywanie treści lub ofert w przepływach zintegrowanych z AI.
• Kontekstowa obsługa sesji
  Automatyzuje zarządzanie sesją za pomocą identyfikatorów opartych na dacie, dbając o zachowanie i izolację kontekstu użytkownika przy różnych interakcjach lub sesjach.
• Wyszukiwanie i audyt profili
  Umożliwia wyszukiwanie profili dla celów zgodności, audytów lub analityki, ułatwiając programistyczne zarządzanie dużymi bazami użytkowników.

Jak to skonfigurować

Windsurf

Nie podano szczegółowych instrukcji dla Windsurf.

Claude

1. Upewnij się, że spełnione są wymagania wstępne (Node.js i npx).
2. Zlokalizuj plik konfiguracyjny:
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%/Claude/claude_desktop_config.json
3. Dodaj konfigurację Inoyu MCP Unomi Server:

{
  "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. Zapisz konfigurację.
5. Zrestartuj Claude Desktop, aby zastosować zmiany i sprawdzić wykrycie serwera/narzędzi.

Zabezpieczanie kluczy API

Użyj sekcji env w konfiguracji JSON, aby ustawiać wrażliwe dane jako zmienne środowiskowe.

Cursor

Nie podano szczegółowych instrukcji dla Cursor.

Cline

Nie podano szczegółowych instrukcji dla Cline.

Jak użyć tego MCP w przepływach

Wykorzystanie MCP w FlowHunt

Aby zintegrować serwery MCP w swoim przepływie FlowHunt, zacznij od dodania komponentu MCP do przepływu i połączenia go z agentem AI:

Kliknij komponent MCP, aby otworzyć panel konfiguracji. W sekcji konfiguracji MCP systemu wprowadź dane swojego serwera MCP w poniższym formacie JSON:

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

Po skonfigurowaniu agent AI może korzystać z tego MCP jako narzędzia ze wszystkimi jego funkcjonalnościami. Pamiętaj, aby zmienić “inoyu-unomi” na wybraną nazwę oraz zastąpić URL adresem swojego serwera MCP.

Przegląd

Nasza opinia

Ten serwer MCP zapewnia solidną integrację do zarządzania profilami użytkowników z Apache Unomi poprzez klarowny zestaw narzędzi i prostą konfigurację dla Claude Desktop. Jednak brak szablonów promptów, szczegółowych definicji zasobów oraz instrukcji dla Windsurf, Cursor i Cline ogranicza jego kompletność. Najlepiej sprawdzi się obecnie jako rozwiązanie eksperymentalne i edukacyjne.

Ocena MCP

Ocena: 6/10
Inoyu MCP Unomi Server dobrze rokuje do zarządzania profilami Unomi i integracji AI, jednak jego wczesny etap, brak szczegółów dotyczących zasobów/promptów i ograniczona konfiguracja wieloplatformowa zmniejszają obecnie jego wartość dla szerszego grona deweloperów.