Conectar Productboard con Gemini CLI (MCP)

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Productboard, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

Productboard + Gemini

Gestión de producto con Productboard a través de la REST API v2: leer y editar productos, componentes, funcionalidades, iniciativas, objetivos y key results, releases, empresas y usuarios como entidades con campos personalizados y relaciones, registrar y buscar notas de feedback de clientes y vincularlas a funcionalidades, y consultar miembros y equipos.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

PRODUCTBOARD_API_TOKEN

Paso 1 — Obtener credenciales

La configuración lleva unos 2 minutos. Necesitas un workspace de Productboard con el plan Pro o superior.

1. En Productboard abre Settings > Integrations > Public APIs > Access Token y haz clic en + para crear un token. Cópialo enseguida: solo se muestra una vez.
2. Pégalo en PRODUCTBOARD_API_TOKEN, sin el prefijo Bearer. Se envía como Authorization: Bearer <token> y actúa con los permisos del miembro que lo creó, así que el token de un admin o maker del workspace ve más.
3. Instala el conector y ejecuta productboard_list_entity_configurations: confirma el token y lista los tipos de entidad de tu workspace.

Solo API v2: el conector usa la Productboard REST API v2 (https://api.productboard.com/v2). La API v1 quedó obsoleta en abril de 2026 y se retiró el 8 de julio de 2026.

Todo es una entidad: productos, componentes, funcionalidades, subfuncionalidades, iniciativas, objetivos, key results, releases, grupos de releases, usuarios y empresas (y competidores y tareas donde el workspace los tenga) son entidades con un type. El feedback de clientes vive en las notas.

Primero explora el workspace: los campos cambian en cada workspace. productboard_list_entity_configurations y productboard_get_entity_configuration muestran todos los campos de un tipo (los estándar como name, description, status, owner, timeframe, teams, tags y los personalizados con UUID como clave), cuáles son obligatorios y qué operaciones de patch admiten. productboard_list_note_configurations hace lo mismo con las notas y productboard_list_field_values lista las opciones de un campo de selección, etiqueta o estado.

Qué lee:

• El roadmap: productboard_list_entities con types (por ejemplo ["feature"], ["objective", "keyResult"] o ["company"]) y filtros por nombre, owner, estado, equipo, entidad padre o archivado; productboard_search_entities para filtros estructurados por varios ids, fechas, valores de campos (también personalizados), padres y clientes, eligiendo los campos devueltos; productboard_get_entity para un elemento con su URL links.html.
• La jerarquía: productboard_list_entity_relationships muestra padre, hijos, vínculos y bloqueos, por ejemplo todas las funcionalidades de un componente.
• Feedback: productboard_list_notes por fecha, owner, autor, sistema de origen, procesada o archivada; productboard_search_notes para búsqueda de texto completo combinada con etiquetas, cliente y funcionalidades vinculadas; productboard_get_note y productboard_list_note_relationships para una nota, su cliente y sus funcionalidades vinculadas.
• Personas: productboard_list_members y productboard_get_member para los miembros del workspace, productboard_list_teams y productboard_list_team_members para los equipos.

Qué escribe:

• productboard_create_entity crea una funcionalidad, un componente, una iniciativa, un objetivo, un key result, una release, una empresa y más con type y fields; el padre se fija con relationships, por ejemplo [{"type": "parent", "target": {"id": "<component id>"}}].
• productboard_update_entity sobrescribe valores con fields o aplica operaciones patch (set, addItems, removeItems, clear) en listas como etiquetas y equipos.
• productboard_set_entity_parent mueve una entidad bajo otro padre; productboard_create_entity_relationship añade una relación link, isBlockedBy o isBlocking.
• productboard_create_note registra feedback en la bandeja de Insights con título, texto, etiquetas, owner, registro de origen, cliente y funcionalidades vinculadas; productboard_update_note lo modifica (por ejemplo lo marca como procesado); productboard_link_note vincula una nota a una funcionalidad o fija su cliente.

Nada desactivado, nada que borrar: ninguna herramienta está desactivada al instalar porque el conector no tiene ninguna herramienta de borrado. Borrar una entidad en la API v2 borra también todos sus hijos, así que los borrados se quedan en la app de Productboard.

Formatos de datos: las referencias son objetos: owners como {"email": "[email protected]"} o {"id": "<uuid>"}, un estado como {"name": "In progress"}, etiquetas como [{"name": "Q4"}]. timeframe tiene la forma {"startDate": "2026-10-01", "endDate": "2026-12-31", "granularity": "month"}. El content de las notas y los campos de texto enriquecido aceptan HTML sencillo o texto plano. Los listados devuelven data, cada elemento con id, type, fields, links.html, createdAt y updatedAt. Todos los ids son UUID y las fechas ISO 8601 en UTC. Sin el permiso members:pii:read los emails de los owners llegan como [redacted].

Paginación: cuando links.next está presente, la IA toma el valor pageCursor de esa URL y lo pasa como page_cursor; para cuando links.next es null.

Límites y errores frecuentes: 50 peticiones por segundo por token; el 429 llega con Retry-After. 401 significa un token incorrecto o revocado, 403 un token cuyo miembro no tiene permisos sobre esos datos, 400 o 422 un campo o tipo desconocido: el mensaje indica qué acepta el workspace y la IA revisa la configuración.

El conector no borra entidades ni notas, no cambia la configuración, los campos ni los estados del workspace y no usa la API v1 retirada.

Paso 2 — Instalar el adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Paso 3 — Añadir el conector en Gemini

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Gemini CLI lee los servidores MCP de ~/.gemini/settings.json (en Windows, %USERPROFILE%\.gemini\settings.json). Añade:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia gemini.
3. Ejecuta /mcp dentro de Gemini CLI (o gemini mcp list en tu terminal): anythingmcp debería aparecer como conectado.
4. Empieza a escribir prompts: Gemini CLI ya puede llamar a las herramientas de Productboard.

Herramientas disponibles

Ejemplos de prompts

• "Lista las funcionalidades en estado In progress con owner y timeframe, agrupadas por componente."
• "¿Qué notas de feedback sin procesar de las dos últimas semanas mencionan el onboarding? Resume los temas principales."
• "Crea una funcionalidad llamada Modo oscuro para la app móvil bajo el componente Mobile, con owner [email protected] y estado New idea."
• "Registra este ticket de soporte como nota de [email protected] y vincúlala a la funcionalidad Exportación CSV."
• "Muéstrame nuestros objetivos con sus key results de este trimestre, con estado y owner."

FAQ

¿Dónde busca Gemini CLI los servidores MCP? En ~/.gemini/settings.json para tu usuario, o en .gemini/settings.json dentro de un proyecto. gemini mcp list muestra cada servidor y si se conecta.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT
• Conectar a Cursor
• Conectar a Meta Muse
• Conectar a Microsoft Copilot