Nectar Insights MCP

Servidor MCP (stdio) para consultar e gerenciar o módulo INSIGHTS do Nectar Engage (analytics de produto, canais, mensagens in-app, contatos, segmentos e mais). Conversa com a API REST do app, autenticando com um Personal API Token que você gera na própria interface — sem segredos do servidor. É o mesmo token do Nectar Ideas MCP; o dono do token precisa ser admin para o Insights.

Ferramentas

Consulta / Analytics (leitura)

• check_connection — verifica conectividade + auth (lista canais)
• analytics_overview, top_events, events_timeseries, list_event_names, top_pages
• health_overview, live_stats
• list_funnels, get_funnel, funnel_report (ad-hoc), retention_report

Mensagens & Canais

• list_channels, get_channel, list_channel_users, list_channel_events
• list_messages, get_message, create_message, send_message, pause_message, resume_message

Contatos & Segmentos

• list_contacts, get_contact, contact_events, contacts_stats, list_companies
• list_cohorts, cohort_users, preview_cohort
• list_segments, segment_count

Avançado

• list_surveys, get_survey, survey_responses
• list_experiments, experiment_results
• list_flags, evaluate_flag
• list_dashboards
• list_insights, generate_insights

Instalação (Claude Code)

claude mcp add nectar-insights \
  -e NECTAR_API_URL=https://engage.nectarcrm.com.br \
  -e NECTAR_API_TOKEN=SEU_TOKEN \
  -- npx -y nectar-insights-mcp

Gere o token em Perfil → Tokens de API no Nectar Engage. Trate como senha.

Desenvolvimento

npm install
cp .env.example .env   # preencha NECTAR_API_TOKEN
npm run dev            # tsx src/index.ts
npm run build          # compila para dist/

Licença

MIT