Integração do Servidor Inoyu MCP Unomi

O que faz o Servidor “Inoyu” MCP?

O Servidor Inoyu MCP Unomi é um servidor Model Context Protocol (MCP) que integra o MCP da Anthropic com a Customer Data Platform (CDP) Apache Unomi. Isso permite que assistentes de IA, como o Claude, interajam e gerenciem perfis de usuários no Unomi, facilitando a consciência contextual e a persistência de dados do usuário entre sessões. O servidor suporta consulta e criação de perfis por e-mail, gerenciamento de propriedades de perfil, tratamento de sessões e gerenciamento de escopos para isolamento de contexto. Ao expor essas capacidades via MCP, o servidor Inoyu permite que agentes de IA realizem operações avançadas com dados de usuários, como recuperar ou atualizar informações, aprimorando fluxos de desenvolvimento que exigem gerenciamento persistente e rico em contexto de dados de usuários.

Lista de Prompts

Não há modelos de prompt listados no repositório ou documentação.

Lista de Recursos

Não há recursos MCP explícitos documentados ou listados nos arquivos disponíveis do repositório.

Lista de Ferramentas

• get_my_profile
  Recupera o perfil do usuário usando variáveis de ambiente. Suporta obtenção de informações de segmento e pontuação e gera um ID de sessão baseado na data atual.

• update_my_profile
  Atualiza propriedades do perfil do usuário. Aceita um objeto de propriedades com pares chave-valor suportando vários tipos de dados (string, número, booleano, nulo).

• get_profile
  Recupera um perfil específico pelo seu ID no Unomi, retornando todos os dados do perfil.

• search_profiles
  Pesquisa perfis com base em uma string de consulta, com parâmetros opcionais de limite e deslocamento. Busca nos campos firstName, lastName e email.

Casos de Uso deste Servidor MCP

• Conversas de IA Personalizadas
  Permite que assistentes de IA relembrem e atualizem informações do usuário (como nome, preferências ou status de assinatura), oferecendo uma experiência mais personalizada entre sessões.
• Gerenciamento de Dados do Cliente
  Facilita a consulta, atualização ou recuperação de perfis de clientes diretamente do Unomi, otimizando o suporte ao cliente e fluxos de trabalho de CRM para desenvolvedores.
• Segmentação e Direcionamento de Usuários
  Fornece acesso a perfis, segmentos e pontuações, permitindo segmentação de usuários e personalização de conteúdos ou ofertas via fluxos integrados à IA.
• Tratamento Contextual de Sessões
  Automatiza o gerenciamento de sessões usando IDs baseados em data, garantindo que o contexto do usuário seja preservado e isolado entre diferentes interações ou sessões.
• Pesquisa e Auditoria de Perfis
  Permite pesquisar perfis para fins de conformidade, auditoria ou análise, facilitando o gerenciamento programático de grandes bases de usuários.

Como configurar

Windsurf

Não há instruções específicas para Windsurf fornecidas.

Claude

1. Certifique-se de que os pré-requisitos foram atendidos (Node.js e npx).
2. Localize o arquivo de configuração:
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%/Claude/claude_desktop_config.json
3. Adicione a configuração do Servidor 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. Salve a configuração.
5. Reinicie o Claude Desktop para aplicar as alterações e verifique se o servidor/ferramentas foram detectados.

Protegendo Chaves de API

Use a seção env na configuração JSON para definir credenciais sensíveis como variáveis de ambiente.

Cursor

Não há instruções específicas para Cursor fornecidas.

Cline

Não há instruções específicas para Cline fornecidas.

Como usar este MCP em fluxos

Usando MCP no FlowHunt

Para integrar servidores MCP ao seu fluxo no FlowHunt, comece adicionando o componente MCP ao seu fluxo e conectando-o ao seu agente de IA:

Clique no componente MCP para abrir o painel de configuração. Na seção de configuração do MCP do sistema, insira os detalhes do seu servidor MCP usando este formato JSON:

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

Depois de configurado, o agente de IA poderá usar este MCP como ferramenta com acesso a todas as suas funções e capacidades. Lembre-se de trocar “inoyu-unomi” pelo nome desejado e substituir a URL pelo endereço do seu servidor MCP.

Visão Geral

Nossa opinião

Este servidor MCP oferece uma integração sólida para gerenciamento de perfis de usuário com o Apache Unomi por meio de um conjunto claro de ferramentas e configuração direta para o Claude Desktop. No entanto, a ausência de modelos de prompt, definições explícitas de recursos e instruções específicas para Windsurf, Cursor e Cline limita sua completude. É mais indicado para experimentação e aprendizado neste estágio.

Pontuação MCP

Avaliação: 6/10
O Servidor Inoyu MCP Unomi é promissor para gerenciamento de perfis Unomi e integração com IA, mas seu estágio inicial, falta de detalhes de recursos/prompts e configuração limitada para múltiplas plataformas reduzem sua utilidade atual para públicos desenvolvedores mais amplos.