Productboard MCP Server

Se integra con la API de Productboard, ofreciendo 49 herramientas especializadas para gestionar todas las funcionalidades principales de Productboard.

GitHub

Prueba este MCPPatrocinado

Documentación

productboard-mcp

Un servidor MCP (Model Context Protocol) para la API de Productboard. Permite que los asistentes de IA (Claude, Cursor, etc.) interactúen con tu espacio de trabajo de Productboard.

Herramientas

Herramienta	Descripción
`pb_feature_list`	Listar funcionalidades con filtrado
`pb_feature_get`	Obtener una funcionalidad por ID
`pb_feature_create`	Crear una nueva funcionalidad
`pb_feature_update`	Actualizar una funcionalidad existente
`pb_feature_delete`	Eliminar una funcionalidad
`pb_product_list`	Listar productos
`pb_product_create`	Crear un producto
`pb_product_hierarchy`	Obtener la jerarquía completa de productos
`pb_note_list`	Listar notas de clientes
`pb_note_create`	Crear una nota de cliente
`pb_objective_list`	Listar objetivos
`pb_objective_create`	Crear un objetivo
`pb_objective_update`	Actualizar un objetivo
`pb_keyresult_list`	Listar resultados clave
`pb_keyresult_create`	Crear un resultado clave
`pb_keyresult_update`	Actualizar un resultado clave
`pb_release_list`	Listar lanzamientos
`pb_release_create`	Crear un lanzamiento
`pb_release_update`	Actualizar un lanzamiento
`pb_release_status_update`	Actualizar el estado del lanzamiento
`pb_release_timeline`	Obtener la cronología del lanzamiento

Instalación

Opción 1: Instalación con un clic (paquete .mcpb) — Recomendada

Descarga el archivo .mcpb más reciente desde la página de Releases y arrástralo a Claude Desktop (Developer → Extensions → Install), o haz doble clic en él en un cliente MCP compatible.

El paquete es autónomo: no requiere clonación ni compilación.

Después de instalar, configura tu PRODUCTBOARD_API_TOKEN en la configuración de la extensión.

Opción 2: Instalación local (manual)

# 1. Clone the repo
git clone https://github.com/Enreign/productboard-mcp.git
cd productboard-mcp

# 2. Install dependencies and build
npm install --include=dev
npm run build

Luego añade a tu claude_desktop_config.json:

{
  "mcpServers": {
    "productboard": {
      "command": "node",
      "args": ["/absolute/path/to/productboard-mcp/dist/index.js"],
      "env": {
        "PRODUCTBOARD_API_TOKEN": "your-api-token-here",
        "LOG_LEVEL": "error"
      }
    }
  }
}

Importante: Establece LOG_LEVEL a error (no info). MCP utiliza stdio para la comunicación: los registros de nivel info impresos en stdout interferirán con el protocolo y harán que el servidor se bloquee.

Opción 3: npx

⚠️ Próximamente: aún no publicado en npm. Usa la Opción 1 o 2 anteriores.

{
  "mcpServers": {
    "productboard": {
      "command": "npx",
      "args": ["-y", "@enreign/productboard-mcp"],
      "env": {
        "PRODUCTBOARD_API_TOKEN": "your-api-token-here",
        "LOG_LEVEL": "error"
      }
    }
  }
}

Cómo obtener un token de API de Productboard

Inicia sesión en tu espacio de trabajo de Productboard
Ve a Profile & Settings → API Access
Haz clic en Generate API key y copia el token

Configuración

Requerido

Variable	Descripción
`PRODUCTBOARD_API_TOKEN`	Tu token de API de Productboard (autenticación Bearer)

Opcional

Variable	Por defecto	Descripción
`PRODUCTBOARD_AUTH_TYPE`	`bearer`	Tipo de autenticación: `bearer` o `oauth2`
`PRODUCTBOARD_API_BASE_URL`	`https://api.productboard.com/v2`	URL base de la API
`PRODUCTBOARD_API_TIMEOUT`	`10000`	Tiempo de espera de solicitudes de API (ms)
`API_RETRY_ATTEMPTS`	`3`	Número de intentos de reintento
`API_RETRY_DELAY`	`1000`	Retraso entre reintentos (ms)
`RATE_LIMIT_GLOBAL`	`100`	Máximo de solicitudes por ventana
`RATE_LIMIT_WINDOW_MS`	`60000`	Ventana de límite de tasa (ms)
`CACHE_ENABLED`	`false`	Habilitar caché de respuestas
`CACHE_TTL`	`300`	TTL de caché (segundos)
`LOG_LEVEL`	`info`	Nivel de registro: `trace`, `debug`, `info`, `warn`, `error`, `fatal`

Nota para clientes MCP: Siempre establece LOG_LEVEL=error cuando uses Claude Desktop, Cursor o cualquier cliente MCP basado en stdio. Los niveles de registro más altos escriben en stdout y romperán el protocolo MCP.

OAuth2 (opcional)

Variable	Descripción
`PRODUCTBOARD_OAUTH_CLIENT_ID`	ID de cliente OAuth2
`PRODUCTBOARD_OAUTH_CLIENT_SECRET`	Secreto de cliente OAuth2
`PRODUCTBOARD_OAUTH_REDIRECT_URI`	URI de redirección OAuth2

Solución de problemas

"El servidor MCP se bloquea / produce registros de error" → Añade "LOG_LEVEL": "error" al bloque env en tu configuración de MCP. Los registros de info escritos en stdout interfieren con el transporte stdio.

"npx falla / paquete no encontrado" → El paquete aún no está publicado en npm. Usa el paquete .mcpb o la instalación local anterior.

"comando no encontrado después de la compilación local" → Apunta args a la ruta absoluta completa de dist/index.js, no al envoltorio productboard-mcp.js.

Licencia

MIT