Featuriq

featuriq-mcp

Un servidor MCP (Model Context Protocol) para Featuriq — la herramienta de feedback de producto y roadmap para product managers.

Conecta tu workspace de Featuriq a cualquier cliente de IA compatible con MCP (Claude Desktop, Cursor, etc.) y consulta tus feature requests, busca feedback de clientes, ejecuta priorización con IA, actualiza estados y notifica a usuarios — todo desde lenguaje natural.

---

Instalación

Opción 1 — ejecutar directamente con npx (sin instalación)

npx featuriq-mcp

Opción 2 — instalar globalmente

npm install -g featuriq-mcp
featuriq-mcp

---

Configuración

1. Obtén tu clave de API

Inicia sesión en featuriq.io, ve a Settings → API y copia tu clave de API.

2. Define la variable de entorno

export FEATURIQ_API_KEY=fq_live_xxxxxxxxxxxxxxxxxxxx

O copia .env.example a .env y completa tu clave si tu cliente admite archivos .env.

Variable	Requerida	Default	Descripción
FEATURIQ_API_KEY	Sí	—	Tu clave de API de Featuriq
FEATURIQ_API_URL	No	https://featuriq.io/v1	Sobrescribe la URL base de la API

3. Añádelo a tu cliente MCP

Claude Desktop

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

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

Cursor

Añádelo a la configuración MCP de Cursor:

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

---

Herramientas disponibles

get_top_requests

Devuelve las feature requests más solicitadas ordenadas por número de votos o impacto en ingresos.

Parámetros:

• limit (number, default 10) — cuántos resultados devolver
• sort_by ("votes" | "revenue_impact", default "votes") — orden de clasificación

Ejemplos de prompts:

• "¿Cuáles son las 5 funciones más solicitadas?"
• "Muéstrame las solicitudes con mayor impacto en ingresos."

---

search_feedback

Busca semánticamente en todas las publicaciones de feedback usando lenguaje natural — encuentra resultados relevantes incluso cuando las palabras exactas no coinciden.

Parámetros:

• query (string) — qué buscar
• limit (number, default 10) — máximo de resultados

Ejemplos de prompts:

• "Encuentra feedback sobre la carga lenta del dashboard."
• "Busca solicitudes relacionadas con exportación CSV."
• "¿Qué dicen los usuarios sobre el rendimiento móvil?"

---

get_feature_feedback

Devuelve todos los comentarios y discusiones de una feature request específica.

Parámetros:

• feature_id (string) — el ID único de la función

Ejemplos de prompts:

• "Muéstrame todo el feedback sobre la función feat_01j8k..."
• "¿Qué dicen los usuarios sobre la solicitud de límite de tasa de API?"

---

get_prioritization

Devuelve una lista de funciones priorizada por IA, puntuada según los factores que elijas.

Parámetros:

• factors (array) — uno o más de: "votes", "revenue", "effort", "strategic_fit"
• limit (number, default 10)

Ejemplos de prompts:

• "Prioriza nuestro backlog por votos e impacto en ingresos."
• "Dame las 10 funciones principales clasificadas por votos, esfuerzo y ajuste estratégico."
• "¿Qué deberíamos construir el próximo trimestre según ingresos y alineación estratégica?"

---

update_feature_status

Actualiza el estado de una feature request.

Parámetros:

• feature_id (string) — el ID único de la función
• status ("planned" | "in_progress" | "shipped" | "closed")

Ejemplos de prompts:

• "Marca la función feat_01j8k como in_progress."
• "Cambia la solicitud de modo oscuro a shipped."
• "Cierra la feature request de soporte para IE heredado."

---

notify_requesters

Envía una notificación personalizada a cada usuario que votó por una función.

Parámetros:

• feature_id (string) — a qué votantes de qué función notificar
• message (string) — el mensaje a enviar (Featuriq lo personaliza por destinatario)

Ejemplos de prompts:

• "Notifica a todos los que solicitaron exportación CSV que ya está disponible."
• "Diles a los usuarios que votaron por el modo oscuro que empezaremos a trabajar en ello el próximo sprint."

---

create_post

Crea una nueva publicación de feedback en un board de Featuriq.

Parámetros:

• board_id (string) — en qué board publicar
• title (string) — título corto para la publicación
• description (string) — descripción completa

Ejemplos de prompts:

• "Registra una feature request para importación CSV masiva en el board de funciones."
• "Crea una publicación para la idea de integración con Slack de la llamada de hoy con el cliente."

---

Recursos disponibles

Los recursos son fuentes de datos que la IA puede leer en cualquier momento para obtener contexto.

featuriq://roadmap

El roadmap actual agrupado por estado: In Progress, Planned y Recently Shipped.

Ejemplos de prompts:

• "¿Qué hay en nuestro roadmap actual?"
• "¿Qué funciones están en progreso ahora mismo?"

featuriq://changelog

Las últimas 20 funciones enviadas con fechas de lanzamiento y notas de versión.

Ejemplos de prompts:

• "¿Qué hemos lanzado recientemente?"
• "Escribe un resumen de las actualizaciones de producto del último mes."

---

Ejemplo de conversación

Tú: ¿Cuáles son las feature requests principales que aún no hemos empezado, y cuáles deberíamos priorizar según votos e impacto en ingresos?

Claude: (llama a get_top_requests y get_prioritization) Aquí están tus solicitudes principales sin empezar...

Tú: Genial. Marca la número 1 como in_progress y notifica a todos los que votaron por ella.

Claude: (llama a update_feature_status y luego a notify_requesters) ¡Listo! Estado actualizado y 47 usuarios notificados.

---

Desarrollo

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 cambios durante el desarrollo:

npm run dev

---

Licencia

MIT © Featuriq