ComposioHQ/Productboard-Automation

Automação do Productboard

Automatize suas operações de gerenciamento de produtos no Productboard diretamente do Claude Code. Crie anotações a partir de feedback de clientes, navegue por funcionalidades e objetivos, vincule entidades e acompanhe versões — tudo sem sair do terminal.

Documentação do toolkit: composio.dev/toolkits/productboard

---

Configuração

1. Adicione o servidor MCP Rube à configuração do seu Claude Code com a URL: https://rube.app/mcp
2. Quando solicitado, autentique sua conta Productboard por meio do link de conexão fornecido
3. Comece a automatizar seus fluxos de trabalho de gerenciamento de produtos com linguagem natural

---

Fluxos de Trabalho Principais

1. Gerenciar Anotações de Clientes

Crie anotações a partir de feedback de clientes e organize-as com tags, links e seguidores.

Ferramentas: PRODUCTBOARD_CREATE_NOTE, PRODUCTBOARD_LIST_NOTES, PRODUCTBOARD_ADD_NOTE_TAG, PRODUCTBOARD_ADD_NOTE_FOLLOWERS, PRODUCTBOARD_CREATE_NOTE_LINK

Crie uma anotação intitulada "Relatório de falha do aplicativo móvel" com conteúdo do feedback do cliente, marcada como "bug" e vinculada à funcionalidade abc-123

Parâmetros chave para PRODUCTBOARD_CREATE_NOTE:

• title (obrigatório) e content (obrigatório) — título e corpo da anotação
• customer_email ou user.email — atribuir a um cliente/usuário
• tags — array de strings de tags para categorização
• display_url — URL vinculada ao título da anotação
• source — sistema de origem com origin e record_id
• company — associar a uma empresa

Parâmetros chave para PRODUCTBOARD_LIST_NOTES:

• createdFrom / createdTo — intervalo de datas no formato ISO 8601
• last — janela de tempo relativa (ex.: "6m", "10d", "24h")
• term — pesquisa de texto completo por título ou conteúdo
• allTags / anyTag — filtrar por tags (não podem ser combinados)
• featureId, companyId, ownerEmail, source — filtros de entidade
• pageLimit (máx. 100) / pageCursor — paginação

2. Navegar e Recuperar Funcionalidades

Liste todas as funcionalidades/subfuncionalidades e recupere informações detalhadas.

Ferramentas: PRODUCTBOARD_LIST_FEATURES, PRODUCTBOARD_RETRIEVE_FEATURE

Liste as primeiras 50 funcionalidades no Productboard e, em seguida, obtenha detalhes sobre a funcionalidade abc-def-123

• PRODUCTBOARD_LIST_FEATURES oferece suporte a pageLimit (padrão 100) e pageOffset para paginação
• PRODUCTBOARD_RETRIEVE_FEATURE requer o id da funcionalidade (UUID) para obter detalhes completos

3. Objetivos e Resultados-Chave (OKRs)

Liste objetivos, visualize vínculos entre funcionalidades e objetivos e navegue pelos resultados-chave.

Ferramentas: PRODUCTBOARD_LIST_OBJECTIVES, PRODUCTBOARD_LIST_FEATURE_OBJECTIVES, PRODUCTBOARD_LIST_KEY_RESULTS

Mostre todos os objetivos em andamento de propriedade de [email protected]

Parâmetros chave para PRODUCTBOARD_LIST_OBJECTIVES:

• status.name — filtrar por status (ex.: "Em Andamento")
• owner.email — filtrar por e-mail do proprietário
• parent.id — filtrar por objetivo pai
• archived — filtrar por estado de arquivamento

PRODUCTBOARD_LIST_FEATURE_OBJECTIVES:

• Requer id (UUID) de uma funcionalidade de nível superior (não subfuncionalidades)
• Oferece suporte a pageCursor para paginação

4. Gerenciamento de Componentes

Liste componentes do produto para organizar funcionalidades e a hierarquia do produto.

Ferramenta: PRODUCTBOARD_LIST_COMPONENTS

Liste todos os componentes em nosso espaço de trabalho Productboard

• Oferece suporte a page_limit e page_offset para paginação
• Siga links.next para páginas adicionais

5. Acompanhamento de Versões

Visualize atribuições de funcionalidades a versões com filtros de estado e data.

Ferramenta: PRODUCTBOARD_LIST_FEATURE_RELEASE_ASSIGNMENTS

Mostre todas as atribuições de versão ativas para a funcionalidade abc-123

• Filtrar por feature.id, release.id, release.state (planned, active, closed)
• Filtros de intervalo de datas: release.timeframe.endDate.from e release.timeframe.endDate.to (AAAA-MM-DD)

6. Vincular Anotações a Funcionalidades

Conecte anotações de feedback de clientes a funcionalidades do produto para agregação de insights.

Ferramenta: PRODUCTBOARD_CREATE_NOTE_LINK

Vincule a anotação 3fa85f64-5717 à funcionalidade 1b6c8c76-8f5d para rastreamento

• Requer noteId (UUID) e entityId (UUID da funcionalidade, componente ou produto)
• Use após criar anotações para garantir que o feedback esteja conectado às áreas corretas do produto

---

Armadilhas Conhecidas

• Apenas funcionalidades de nível superior para objetivos: PRODUCTBOARD_LIST_FEATURE_OBJECTIVES funciona apenas com IDs de funcionalidades de nível superior, não com IDs de subfuncionalidades. Use PRODUCTBOARD_LIST_FEATURES para identificar quais funcionalidades são de nível superior.
• Exclusividade de filtro de tags: allTags e anyTag não podem ser combinados em PRODUCTBOARD_LIST_NOTES. Escolha uma estratégia de filtro por consulta.
• Datas relativas vs. absolutas: O parâmetro last (ex.: "24h") não pode ser combinado com createdFrom/createdTo em PRODUCTBOARD_LIST_NOTES. Use uma abordagem, não ambas.
• Paginação baseada em cursor: Siga links.next ou use pageCursor das respostas para resultados de várias páginas. Paginação baseada em deslocamento e baseada em cursor são usadas em endpoints diferentes — verifique cada ferramenta.
• Atribuição de anotações: É necessário fornecer user.email ou customer_email em PRODUCTBOARD_CREATE_NOTE para atribuir o feedback. Sem isso, a anotação não terá associação com o cliente.
• Formato UUID obrigatório: Todos os IDs de entidade (funcionalidades, anotações, componentes) devem ser UUIDs válidos. Passar IDs malformados causa erros 400.

---

Referência Rápida

Slug da Ferramenta	Descrição
PRODUCTBOARD_CREATE_NOTE	Criar uma anotação de feedback do cliente (requer title, content)
PRODUCTBOARD_LIST_NOTES	Listar anotações com pesquisa, data e filtros de tags
PRODUCTBOARD_ADD_NOTE_TAG	Adicionar uma tag a uma anotação
PRODUCTBOARD_ADD_NOTE_FOLLOWERS	Adicionar seguidores a uma anotação por e-mail
PRODUCTBOARD_CREATE_NOTE_LINK	Vincular uma anotação a uma funcionalidade/componente (requer noteId, entityId)
PRODUCTBOARD_LIST_FEATURES	Listar todas as funcionalidades com paginação
PRODUCTBOARD_RETRIEVE_FEATURE	Obter informações detalhadas da funcionalidade por UUID
PRODUCTBOARD_LIST_OBJECTIVES	Listar objetivos com filtros de status/proprietário
PRODUCTBOARD_LIST_FEATURE_OBJECTIVES	Listar objetivos vinculados a uma funcionalidade de nível superior
PRODUCTBOARD_LIST_KEY_RESULTS	Listar resultados-chave para objetivos
PRODUCTBOARD_LIST_COMPONENTS	Listar componentes do produto com paginação
PRODUCTBOARD_LIST_FEATURE_RELEASE_ASSIGNMENTS	Listar atribuições de funcionalidades a versões com filtros

---

Desenvolvido por Composio