Nectar Ideas MCP

Servidor MCP (stdio) para gerenciar as ideias do módulo IDEAS do Nectar Engage. 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 token herda as suas permissões, então o MCP reaproveita 100% da lógica de negócio (status, curadoria IA, merge, validações, guards).

Ferramentas

Leitura

• check_connection — verifica conectividade + auth
• list_boards, list_statuses, list_board_tags
• list_ideas — busca/filtra ideias (board, status, tag, busca, esforço/impacto, nota, paginação)
• get_idea — detalhe completo de uma ideia
• list_triage_inbox — fila de triagem (filtro por nota de IA: com/sem)

Criação / edição

• create_idea, update_idea

Triagem

• set_status, set_effort_impact, set_tags, merge_ideas, delete_idea
• bulk_action — set-status / add-tag / merge / delete em lote (1..100)

Curadoria IA

• analyze_idea — analisa 1 ideia (síncrono)
• start_board_ai_batch, get_board_ai_batch_progress — lote por board

Setup

Via npm (recomendado) — nada para clonar/buildar, roda via npx:

npx -y nectar-ideas-mcp   # só para testar; normalmente vai no config do Claude

Ou a partir do código:

cd mcp
npm install
npm run build

Gere seu token: no Nectar Engage, vá em Perfil → Tokens de API → Criar token. Copie o valor (nctr_…) — ele só aparece uma vez.

Crie um .env (veja .env.example):

| Var | Descrição | |---|---| | NECTAR_API_URL | URL da API (ex.: http://localhost:3080 ou prod) | | NECTAR_API_TOKEN | o token nctr_… gerado no seu perfil |

O token herda as suas permissões. Para as ferramentas de gestão (status, IA, merge…) você precisa ser content manager (editor/admin/owner). Revogue o token a qualquer momento no mesmo lugar.

Registrar no Claude Code / Desktop

No JSON de config dos MCP servers (Claude Desktop/Code):

{
  "mcpServers": {
    "nectar-ideas": {
      "command": "npx",
      "args": ["-y", "nectar-ideas-mcp"],
      "env": {
        "NECTAR_API_URL": "http://localhost:3080",
        "NECTAR_API_TOKEN": "nctr_xxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

A partir do código (sem npm), troque por "command": "node", "args": [".../mcp/dist/index.js"], ou rode a fonte com "command": "npx", "args": ["tsx", ".../mcp/src/index.ts"].

Notas

• Ações de escrita ficam atribuídas ao dono do token (statusHistory, autoria).
• analyze_idea / *_ai_batch exigem ideasAiEnabled no projeto e ai.curationEnabled no board.
• Para apontar pra produção, troque NECTAR_API_URL e gere o token no app de produção.