Automação Shortcut

O que Automação Shortcut faz?

Automatize suas operações de gerenciamento de projetos no Shortcut diretamente do Claude Code. Crie e liste histórias, adicione tarefas e comentários, crie histórias em lote e navegue por fluxos de trabalho — tudo sem sair do seu terminal.

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

---

Configuração

1. Adicione o servidor MCP do Rube à configuração do Claude Code com a URL: https://rube.app/mcp
2. Quando solicitado, autentique sua conta do Shortcut através do link de conexão fornecido
3. Comece a automatizar seus workflows de gerenciamento de projetos com linguagem natural

---

Workflows Principais

1. Criar Histórias

Adicione novas histórias ao seu workspace do Shortcut com configuração completa.

Ferramenta: SHORTCUT_CREATE_STORY

Crie uma história de funcionalidade chamada "Adicionar suporte a modo escuro" no estado de workflow 500000001 com estimativa 5 e etiqueta "frontend"

Parâmetros principais para SHORTCUT_CREATE_STORY:

• name (obrigatório) — o título da história
• workflow_state_id — o estado do workflow onde colocar a história (recomendado em vez de project_id)
• story_type — "feature", "bug" ou "chore"
• description — corpo/descrição da história
• estimate — estimativa numérica em pontos (ou null para não estimada)
• epic_id — associar a um épico
• iteration_id — associar a uma iteração
• labels — array de objetos de etiqueta com name (e opcionais color, description)
• owner_ids — array de UUIDs de membros para atribuição
• deadline — data de vencimento no formato ISO 8601
• tasks — array de tarefas inline com description e opcionais complete, owner_ids
• comments — array de comentários inline com text
• story_links — vincular histórias com verb ("blocks", "duplicates", "relates to")

Importante: Deve ser fornecido workflow_state_id ou project_id, mas não ambos. workflow_state_id é recomendado, pois Projetos estão sendo descontinuados no Shortcut.

2. Criar Histórias em Lote

Crie várias histórias em uma única chamada de API.

Ferramenta: SHORTCUT_CREATE_MULTIPLE_STORIES

Crie 3 histórias de bug: "Erro 500 na página de login", "Problema de arredondamento no carrinho" e "Estado vazio dos resultados de busca quebrado"

• Requer array stories onde cada elemento segue o mesmo esquema de SHORTCUT_CREATE_STORY
• Cada história no array requer name
• Eficiente para importações em massa, planejamento de sprint ou criação baseada em modelos

3. Listar Histórias em um Projeto

Recupere todas as histórias dentro de um projeto específico.

Ferramenta: SHORTCUT_LIST_STORIES

Liste todas as histórias no projeto 42 com suas descrições

• Requer project__public__id (ID do projeto, número inteiro)
• Opcional includes_description: true para incluir descrições das histórias na resposta
• Retorna todas as histórias com seus atributos (status, tipo, estimativa, etc.)

4. Gerenciar Tarefas de Histórias

Crie tarefas (checklists) dentro de histórias para acompanhar sub-trabalhos.

Ferramenta: SHORTCUT_CREATE_TASK

Adicione uma tarefa "Escrever testes unitários para o alternador de modo escuro" à história 12345

Parâmetros principais:

• story__public__id (obrigatório) — ID da história pai
• description (obrigatório) — descrição da tarefa
• complete — booleano, padrão false
• owner_ids — array de UUIDs de membros para atribuir a tarefa
• external_id — ID de uma ferramenta externa, se importado

5. Adicionar Comentários em Histórias

Publique comentários em histórias para discussão e documentação.

Ferramenta: SHORTCUT_CREATE_STORY_COMMENT

Adicione um comentário à história 12345: "Revisei a implementação — parece boa, mas precisa de testes de acessibilidade"

Parâmetros principais:

• story__public__id (obrigatório) — ID da história
• text (obrigatório) — corpo do comentário
• author_id — UUID do membro (padrão é o dono do token da API)
• parent_id — ID do comentário pai para respostas encadeadas

6. Descoberta de Workflows e Projetos

Liste workflows e projetos para resolver IDs na criação de histórias.

Ferramentas: SHORTCUT_LIST_WORKFLOWS, SHORTCUT_LIST_PROJECTS

Mostre-me todos os workflows no nosso workspace do Shortcut para que eu encontre o ID correto do estado do workflow

• SHORTCUT_LIST_WORKFLOWS retorna todos os workflows com seus estados (IDs, nomes, tipos)
• SHORTCUT_LIST_PROJECTS retorna todos os projetos com seus atributos
• Use estes para descobrir valores válidos de workflow_state_id e project_id antes de criar histórias

---

Problemas Conhecidos

• workflow_state_id vs project_id: SHORTCUT_CREATE_STORY requer exatamente um destes. Fornecer ambos ou nenhum causa rejeição. Prefira workflow_state_id, pois Projetos estão sendo descontinuados.
• Projetos estão sendo descontinuados: O Shortcut está deprecando Projetos em favor da organização baseada em workflow. Use workflow_state_id para novas histórias.
• Criação de etiquetas é inline: Etiquetas no array labels são criadas dinamicamente se não existirem. O campo name é obrigatório para cada objeto de etiqueta.
• Padrão do tipo de história: Se story_type for omitido, o padrão é "feature". Sempre defina explicitamente para bugs e chores.
• Limites de lote: SHORTCUT_CREATE_MULTIPLE_STORIES processa todas as histórias em uma única requisição. Lotes muito grandes podem expirar — mantenha lotes com menos de 25 histórias.
• IDs inteiros para histórias/projetos: IDs de histórias e projetos são números inteiros, não UUIDs. IDs de membros e grupos são UUIDs. Misturar esses formatos causa erros.
• Posicionamento move_to: O campo move_to ("first" ou "last") move a história dentro do seu estado de workflow, não entre estados.

---

Referência Rápida

Slug da Ferramenta	Descrição
SHORTCUT_CREATE_STORY	Criar uma única história (requer name + workflow_state_id ou project_id)
SHORTCUT_CREATE_MULTIPLE_STORIES	Criar várias histórias em lote (requer array stories)
SHORTCUT_LIST_STORIES	Listar histórias em um projeto (requer project__public__id)
SHORTCUT_CREATE_TASK	Criar uma tarefa em uma história (requer story__public__id, description)
SHORTCUT_CREATE_STORY_COMMENT	Adicionar um comentário a uma história (requer story__public__id, text)
SHORTCUT_CREATE_STORY_FROM_TEMPLATE	Criar uma história a partir de um modelo
SHORTCUT_LIST_WORKFLOWS	Listar todos os workflows e seus estados
SHORTCUT_LIST_PROJECTS	Listar todos os projetos

---

Fornecido por Composio