Automação de Shortcut

Automatize as operações de gerenciamento de projetos do seu 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 Rube MCP à sua configuração do Claude Code com o 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 fluxos de trabalho de gerenciamento de projetos com linguagem natural

Fluxos de Trabalho Principais

1. Criar Histórias

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

Ferramenta: SHORTCUT_CREATE_STORY

Create a feature story called "Add dark mode support" in workflow state 500000001 with estimate 5 and label "frontend"

Parâmetros-chave para SHORTCUT_CREATE_STORY:

• name (obrigatório) -- o título da história
• workflow_state_id -- o estado do fluxo de trabalho onde a história será colocada (recomendado em vez de project_id)
• story_type -- "feature", "bug" ou "chore"
• description -- corpo/descrição da história
• estimate -- estimativa de pontos numérica (ou nulo para não estimado)
• epic_id -- associar a uma épica
• iteration_id -- associar a uma iteração
• labels -- array de objetos de rótulo com name (e opcional color, description)
• owner_ids -- array de UUIDs de membros para atribuir
• deadline -- data de vencimento no formato ISO 8601
• tasks -- array de tarefas inline com description e opcional complete, owner_ids
• comments -- array de comentários inline com text
• story_links -- vincular histórias com verb ("blocks", "duplicates", "relates to")

Importante: É necessário fornecer workflow_state_id ou project_id, mas não ambos. workflow_state_id é recomendado, pois os 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

Create 3 bug stories: "Login page 500 error", "Cart total rounding issue", and "Search results empty state broken"

• 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 de histórias 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

List all stories in project 42 with their descriptions

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

4. Gerenciar Tarefas de Histórias

Crie tarefas (listas de verificação) dentro de histórias para rastrear subtrabalhos.

Ferramenta: SHORTCUT_CREATE_TASK

Add a task "Write unit tests for dark mode toggle" to story 12345

Parâmetros-chave:

• story__public__id (obrigatório) -- o ID da história pai
• description (obrigatório) -- a 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 de Histórias

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

Ferramenta: SHORTCUT_CREATE_STORY_COMMENT

Add a comment to story 12345: "Reviewed the implementation -- looks good, but needs accessibility testing"

Parâmetros-chave:

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

6. Descoberta de Fluxo de Trabalho e Projetos

Liste fluxos de trabalho e projetos para resolver IDs para a criação de histórias.

Ferramentas: SHORTCUT_LIST_WORKFLOWS, SHORTCUT_LIST_PROJECTS

Show me all workflows in our Shortcut workspace so I can find the right workflow state ID

• SHORTCUT_LIST_WORKFLOWS retorna todos os fluxos de trabalho 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

Armadilhas Conhecidas

• workflow_state_id vs project_id: SHORTCUT_CREATE_STORY requer exatamente um destes. Fornecer ambos ou nenhum causa uma rejeição. Prefira workflow_state_id, pois os Projetos estão sendo descontinuados.

…