Featuriq

featuriq-mcp

Um servidor MCP (Model Context Protocol) para Featuriq — a ferramenta de feedback de produto e roadmap para PMs.

Conecte seu workspace Featuriq a qualquer cliente de IA compatível com MCP (Claude Desktop, Cursor, etc.) e consulte suas solicitações de recursos, pesquise feedback de clientes, execute priorização por IA, atualize status e notifique usuários — tudo em linguagem natural.

---

Instalação

Opção 1 — execute diretamente com npx (sem necessidade de instalação)

npx featuriq-mcp

Opção 2 — instale globalmente

npm install -g featuriq-mcp
featuriq-mcp

---

Configuração

1. Obtenha sua chave de API

Acesse featuriq.io, vá em Configurações → API e copie sua chave de API.

2. Defina a variável de ambiente

export FEATURIQ_API_KEY=fq_live_xxxxxxxxxxxxxxxxxxxx

Ou copie .env.example para .env e preencha sua chave se o seu cliente suportar arquivos .env.

Variável	Obrigatória	Padrão	Descrição
FEATURIQ_API_KEY	Sim	—	Sua chave de API do Featuriq
FEATURIQ_API_URL	Não	https://featuriq.io/v1	Substituir a URL base da API

3. Adicione ao seu cliente MCP

Claude Desktop

Edite ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ou %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "featuriq": {
      "command": "npx",
      "args": ["featuriq-mcp"],
      "env": {
        "FEATURIQ_API_KEY": "fq_live_xxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Cursor

Adicione às configurações de MCP do Cursor:

{
  "featuriq": {
    "command": "npx featuriq-mcp",
    "env": {
      "FEATURIQ_API_KEY": "fq_live_xxxxxxxxxxxxxxxxxxxx"
    }
  }
}

---

Ferramentas Disponíveis

get_top_requests

Retorna as principais solicitações de recursos ordenadas por contagem de votos ou impacto em receita.

Parâmetros:

• limit (número, padrão 10) — quantos resultados retornar
• sort_by ("votes" | "revenue_impact", padrão "votes") — ordem de classificação

Exemplos de prompts:

• "Quais são os 5 recursos mais solicitados?"
• "Mostre-me as solicitações com maior impacto em receita."

---

search_feedback

Busca semanticamente em todas as postagens de feedback usando linguagem natural — encontra resultados relevantes mesmo quando as palavras exatas não correspondem.

Parâmetros:

• query (string) — o que pesquisar
• limit (número, padrão 10) — máximo de resultados

Exemplos de prompts:

• "Encontre feedback sobre carregamento lento do dashboard."
• "Pesquise solicitações relacionadas à exportação CSV."
• "O que os usuários estão dizendo sobre o desempenho mobile?"

---

get_feature_feedback

Retorna todos os comentários e discussões de uma solicitação de recurso específica.

Parâmetros:

• feature_id (string) — o ID único do recurso

Exemplos de prompts:

• "Mostre-me todo o feedback sobre o recurso feat_01j8k..."
• "O que os usuários estão dizendo sobre a solicitação de limite de taxa da API?"

---

get_prioritization

Retorna uma lista de recursos priorizada por IA, pontuada de acordo com os fatores que você escolher.

Parâmetros:

• factors (array) — um ou mais de: "votes", "revenue", "effort", "strategic_fit"
• limit (número, padrão 10)

Exemplos de prompts:

• "Priorize nosso backlog por votos e impacto em receita."
• "Dê-me os 10 principais recursos classificados por votos, esforço e adequação estratégica."
• "O que devemos construir no próximo trimestre com base em receita e alinhamento estratégico?"

---

update_feature_status

Atualiza o status de uma solicitação de recurso.

Parâmetros:

• feature_id (string) — o ID único do recurso
• status ("planned" | "in_progress" | "shipped" | "closed")

Exemplos de prompts:

• "Marque o recurso feat_01j8k como in_progress."
• "Defina a solicitação de modo escuro como shipped."
• "Feche a solicitação de recurso para suporte legado ao IE."

---

notify_requesters

Envia uma notificação personalizada para cada usuário que votou em um recurso.

Parâmetros:

• feature_id (string) — quais eleitores do recurso notificar
• message (string) — a mensagem a enviar (o Featuriq personaliza por destinatário)

Exemplos de prompts:

• "Notifique todos que solicitaram exportação CSV que agora está disponível."
• "Diga aos usuários que votaram no modo escuro que começaremos o trabalho na próxima sprint."

---

create_post

Cria uma nova postagem de feedback em um board do Featuriq.

Parâmetros:

• board_id (string) — em qual board postar
• title (string) — título curto para a postagem
• description (string) — descrição completa

Exemplos de prompts:

• "Registre uma solicitação de recurso para importação CSV em massa no board de recursos."
• "Crie uma postagem para a ideia de integração com Slack da chamada de cliente de hoje."

---

Recursos Disponíveis

Recursos são fontes de dados que a IA pode ler a qualquer momento para contexto.

featuriq://roadmap

O roadmap atual agrupado por status: Em Andamento, Planejado e Enviados Recentemente.

Exemplos de prompts:

• "O que está no nosso roadmap atual?"
• "Quais recursos estão em andamento agora?"

featuriq://changelog

Os últimos 20 recursos enviados com datas de envio e notas de versão.

Exemplos de prompts:

• "O que enviamos recentemente?"
• "Escreva um resumo das atualizações de produto do último mês."

---

Exemplo de Conversa

Você: Quais são as principais solicitações de recursos que ainda não começamos, e quais devemos priorizar com base em votos e impacto em receita?

Claude: (chama get_top_requests e get_prioritization) Aqui estão suas principais solicitações não iniciadas...

Você: Ótimo. Marque a nº 1 como in_progress e notifique todos que votaram nela.

Claude: (chama update_feature_status e depois notify_requesters) Pronto! Status atualizado e 47 usuários notificados.

---

Desenvolvimento

git clone https://github.com/carlosalvite/featuriq-mcp
cd featuriq-mcp
npm install
npm run build
FEATURIQ_API_KEY=your_key node dist/index.js

Para observar mudanças durante o desenvolvimento:

npm run dev

---

Licença

MIT © Featuriq