Automação Linear via Rube MCP

Automatize operações do Linear através do toolkit Linear da Composio via Rube MCP.

Pré-requisitos

• O Rube MCP deve estar conectado (RUBE_SEARCH_TOOLS disponível)
• Conexão Linear ativa via RUBE_MANAGE_CONNECTIONS com o toolkit linear
• Sempre chame RUBE_SEARCH_TOOLS primeiro para obter os esquemas de ferramentas atuais

Configuração

Obtenha o Rube MCP: Adicione https://rube.app/mcp como um servidor MCP na configuração do seu cliente. Nenhuma chave de API é necessária — basta adicionar o endpoint e funciona.

1. Verifique se o Rube MCP está disponível confirmando que RUBE_SEARCH_TOOLS responde
2. Chame RUBE_MANAGE_CONNECTIONS com o toolkit linear
3. Se a conexão não estiver ATIVA, siga o link de autenticação retornado para completar o OAuth do Linear
4. Confirme se o status da conexão mostra ATIVO antes de executar quaisquer fluxos de trabalho

Fluxos de Trabalho Principais

1. Gerenciar Issues

Quando usar: O usuário deseja criar, pesquisar, atualizar ou listar issues do Linear.

Sequência de ferramentas:

1. LINEAR_GET_ALL_LINEAR_TEAMS - Obter IDs de equipe [Pré-requisito]
2. LINEAR_LIST_LINEAR_STATES - Obter estados de fluxo de trabalho para uma equipe [Pré-requisito]
3. LINEAR_CREATE_LINEAR_ISSUE - Criar uma nova issue [Opcional]
4. LINEAR_SEARCH_ISSUES / LINEAR_LIST_LINEAR_ISSUES - Encontrar issues [Opcional]
5. LINEAR_GET_LINEAR_ISSUE - Obter detalhes da issue [Opcional]
6. LINEAR_UPDATE_ISSUE - Atualizar propriedades da issue [Opcional]

Parâmetros chave:

• team_id: ID da equipe (obrigatório para criação)
• title: Título da issue
• description: Descrição da issue (Markdown suportado)
• state_id: ID do estado do fluxo de trabalho
• assignee_id: ID do usuário atribuído
• priority: 0 (nenhuma), 1 (urgente), 2 (alta), 3 (média), 4 (baixa)
• label_ids: Array de IDs de rótulos

Armadilhas:

• O ID da equipe é obrigatório ao criar issues; use GET_ALL_LINEAR_TEAMS primeiro
• Os IDs de estado são específicos da equipe; use LIST_LINEAR_STATES com a equipe correta
• Prioridade usa valores inteiros de 0 a 4, não nomes de string

2. Gerenciar Projetos

Quando usar: O usuário deseja criar ou atualizar projetos do Linear.

Sequência de ferramentas:

1. LINEAR_LIST_LINEAR_PROJECTS - Listar projetos existentes [Opcional]
2. LINEAR_CREATE_LINEAR_PROJECT - Criar um novo projeto [Opcional]
3. LINEAR_UPDATE_LINEAR_PROJECT - Atualizar detalhes do projeto [Opcional]

Parâmetros chave:

• name: Nome do projeto
• description: Descrição do projeto
• team_ids: Array de IDs de equipe associados ao projeto
• state: Estado do projeto (por exemplo, 'planejado', 'iniciado', 'concluído')

Armadilhas:

• Projetos abrangem equipes; eles podem ser associados a várias equipes

3. Gerenciar Ciclos

Quando usar: O usuário deseja trabalhar com ciclos do Linear (sprints).

Sequência de ferramentas:

1. LINEAR_GET_ALL_LINEAR_TEAMS - Obter ID da equipe [Pré-requisito]
2. LINEAR_GET_CYCLES_BY_TEAM_ID / LINEAR_LIST_LINEAR_CYCLES - Listar ciclos [Obrigatório]

Parâmetros chave:

• team_id: ID da equipe para operações de ciclo
• number: Número do ciclo

Armadilhas:

• Ciclos são específicos da equipe; sempre escopo por team_id

4. Gerenciar Rótulos e Comentários

Quando usar: O usuário deseja criar rótulos ou comentar em issues.

Sequência de ferramentas:

1. LINEAR_CREATE_LINEAR_LABEL - Criar um novo rótulo [Opcional]
2. LINEAR_CREATE_LINEAR_COMMENT - Comentar em uma issue [Opcional]
3. LINEAR_UPDATE_LINEAR_COMMENT - Editar um comentário [Opcional]

Parâmetros chave:

• name: Nome do rótulo
• color: Cor do rótulo (hex)
• issue_id: ID da issue para comentários
• body: Corpo do comentário (Markdown)

Armadilhas:

• Rótulos podem ter escopo de equipe ou de espaço de trabalho
• O corpo do comentário suporta formatação Markdown

5. Consultas GraphQL Personalizadas

Quando usar: O usuário precisa de consultas avançadas não cobertas por ferramentas padrão.

Sequência de ferramentas:

1. LINEAR_RUN_QUERY_OR_MUTATION - Executar GraphQL personalizado [Obrigatório]

Parâmetros chave:

• query: String de consulta ou mutação GraphQL
• variables: Variáveis para a consulta

Armadilhas:

• Requer conhecimento do esquema GraphQL do Linear
• Limites de taxa se aplicam a consultas GraphQL

Padrões Comuns

Resolução de ID

Nome da equipe -> ID da equipe:

1. Call LINEAR_GET_ALL_LINEAR_TEAMS
2. Find team by name in response
3. Extract id field

Nome do estado -> ID do estado:

1. Call LINEAR_LIST_LINEAR_STATES with team_id
2. Find state by name
3. Extract id field

Paginação

• As ferramentas do Linear retornam resultados paginados
• Verifique os cursores de paginação nas respostas
• Passe o cursor para a próxima solicitação para páginas adicionais

Armadilhas Conhecidas

Escopo de Equipe:

• Issues, estados e ciclos são específicos da equipe
• Sempre resolva o team_id antes de criar issues

Valores de Prioridade:

…