Inoyu MCP Unomi 서버 통합

“Inoyu” MCP 서버란 무엇인가요?

Inoyu MCP Unomi 서버는 Anthropic의 Model Context Protocol(MCP)과 Apache Unomi 고객 데이터 플랫폼(CDP)을 통합하는 MCP 서버입니다. 이를 통해 Claude와 같은 AI 어시스턴트가 Unomi 내 사용자 프로필과 상호작용하고 관리할 수 있어, 세션 간의 컨텍스트 인식 및 지속적인 사용자 데이터 활용이 가능합니다. 이 서버는 이메일을 통한 프로필 조회 및 생성, 프로필 속성 관리, 세션 처리, 컨텍스트 격리를 위한 스코프 관리 등을 지원합니다. MCP를 통해 이러한 기능을 노출함으로써, Inoyu 서버는 AI 에이전트가 사용자 정보를 조회하거나 업데이트하는 등 고급 사용자 데이터 작업을 수행할 수 있도록 하여, 지속적이고 컨텍스트가 풍부한 사용자 데이터 관리가 필요한 개발 워크플로우를 강화합니다.

프롬프트 목록

저장소나 문서에 프롬프트 템플릿이 나열되어 있지 않습니다.

리소스 목록

저장소 파일에 명시적으로 문서화된 MCP 리소스가 없습니다.

도구 목록

• get_my_profile
  환경 변수를 사용하여 사용자의 프로필을 조회합니다. 세그먼트 및 점수 정보 조회를 지원하며, 현재 날짜를 기반으로 세션 ID를 생성합니다.

• update_my_profile
  사용자의 프로필 속성을 업데이트합니다. 다양한 데이터 타입(string, number, boolean, null)을 지원하는 키-값 쌍의 속성 객체를 입력받습니다.

• get_profile
  Unomi에서 특정 프로필 ID로 해당 프로필 전체 데이터를 조회합니다.

• search_profiles
  쿼리 문자열 및 선택적 limit/offset 파라미터로 프로필을 검색합니다. 이름(firstName), 성(lastName), 이메일(email) 필드를 대상으로 검색합니다.

MCP 서버의 활용 사례

• 개인화된 AI 대화
  AI 어시스턴트가 사용자 정보(이름, 선호도, 구독 상태 등)를 기억하고 업데이트하여 세션 간에 더 개인화된 경험을 제공합니다.
• 고객 데이터 관리
  Unomi에서 고객 프로필을 쉽게 조회, 업데이트 또는 검색할 수 있어, 개발자에게 고객 지원 및 CRM 워크플로우를 간소화합니다.
• 사용자 세분화 및 타깃팅
  프로필, 세그먼트, 점수 정보에 접근하여, 개발자가 사용자를 세분화하고 AI 연동 워크플로우를 통해 콘텐츠 또는 제안을 맞춤화할 수 있습니다.
• 컨텍스트 기반 세션 처리
  날짜 기반 ID를 활용한 자동 세션 관리를 통해, 다양한 상호작용이나 세션 간에 사용자 컨텍스트를 보존·격리합니다.
• 프로필 검색 및 감사
  컴플라이언스, 감사, 분석 목적으로 프로필을 검색할 수 있어, 대규모 사용자 데이터베이스를 프로그래밍적으로 효율적으로 관리할 수 있습니다.

설치 방법

Windsurf

Windsurf에 대한 구체적인 설치 안내는 제공되지 않습니다.

Claude

1. 사전 요구사항이 충족되었는지 확인하세요(Node.js 및 npx).
2. 설정 파일 위치를 찾으세요:
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%/Claude/claude_desktop_config.json
3. 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. 설정을 저장하세요.
5. Claude Desktop을 재시작하여 변경사항을 적용하고 서버/도구가 인식되는지 확인하세요.

API 키 보안 설정

민감한 자격 증명은 JSON 설정의 env 섹션에서 환경 변수로 지정해 보안을 강화하세요.

Cursor

Cursor에 대한 구체적인 설치 안내는 제공되지 않습니다.

Cline

Cline에 대한 구체적인 설치 안내는 제공되지 않습니다.

MCP를 플로우 내에서 사용하는 방법

FlowHunt에서 MCP 사용하기

FlowHunt 워크플로우에 MCP 서버를 통합하려면, 플로우에 MCP 컴포넌트를 추가하고 이를 AI 에이전트와 연결하세요:

MCP 컴포넌트를 클릭하여 설정 패널을 여세요. 시스템 MCP 설정 섹션에 아래와 같은 JSON 형식으로 MCP 서버 정보를 입력합니다:

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

설정이 완료되면, AI 에이전트가 해당 MCP의 모든 기능과 도구에 접근할 수 있습니다. “inoyu-unomi"는 실제 사용하고자 하는 이름으로, URL은 본인의 MCP 서버 주소로 변경해 주세요.

개요

의견

이 MCP 서버는 Apache Unomi와 사용자 프로필 관리를 위한 명확한 도구 세트와 Claude Desktop용 간단한 설치 과정을 제공해 통합이 우수합니다. 다만, 프롬프트 템플릿, 명시적 리소스 정의, Windsurf/Cursor/Cline 등 플랫폼별 설명이 부족해 완성도에 제한이 있습니다. 실험 및 학습용으로 가장 적합합니다.

MCP 점수

평가: 6/10
Inoyu MCP Unomi 서버는 Unomi 프로필 관리 및 AI 통합 측면에서 유망하나, 초기 단계 및 리소스/프롬프트 세부 정보 부재, 제한적인 멀티 플랫폼 지원으로 인해 현재로서는 광범위한 개발자에게는 다소 활용도가 낮습니다.