Linear MCP Server

Gerencie projetos, issues e equipes usando a API Linear.

GitHub
347
Experimente este MCPPatrocinado

Documentação

Linear MCP Server

npm version smithery badge

NOTA IMPORTANTE: Este servidor MCP está descontinuado e não é mais mantido. Recomendo que use o servidor MCP remoto oficial do Linear aqui: https://linear.app/changelog/2025-05-01-mcp (https://mcp.linear.app/sse)

Um servidor Model Context Protocol para a Linear API.

Este servidor fornece integração com o sistema de rastreamento de issues do Linear por meio do MCP, permitindo que LLMs interajam com issues do Linear.

Instalação

Instalação Automática

Para instalar o servidor MCP Linear para o Claude Desktop automaticamente via Smithery:

npx @smithery/cli install linear-mcp-server --client claude

Instalação Manual

  1. Crie ou obtenha uma chave de API Linear para a sua equipe: https://linear.app/YOUR-TEAM/settings/api

  2. Adicione a configuração do servidor ao Claude Desktop:

    • MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": [
        "-y",
        "linear-mcp-server"
      ],
      "env": {
        "LINEAR_API_KEY": "your_linear_api_key_here"
      }
    }
  }
}

Componentes

Ferramentas

  1. linear_create_issue: Criar uma nova issue no Linear

    • Entradas obrigatórias:
      • title (cadeia de caracteres): Título da issue
      • teamId (cadeia de caracteres): ID da equipe onde criar a issue
    • Entradas opcionais:
      • description (cadeia de caracteres): Descrição da issue (suporta markdown)
      • priority (número, 0-4): Nível de prioridade (1=urgente, 4=baixa)
      • status (cadeia de caracteres): Nome do status inicial

  2. linear_update_issue: Atualizar issues existentes

    • Entradas obrigatórias:
      • id (cadeia de caracteres): ID da issue para atualizar
    • Entradas opcionais:
      • title (cadeia de caracteres): Novo título
      • description (cadeia de caracteres): Nova descrição
      • priority (número, 0-4): Nova prioridade
      • status (cadeia de caracteres): Novo nome do status

  3. linear_search_issues: Buscar issues com filtros flexíveis

    • Entradas opcionais:
      • query (cadeia de caracteres): Texto para pesquisa no título/descrição
      • teamId (cadeia de caracteres): Filtrar por equipe
      • status (cadeia de caracteres): Filtrar por status
      • assigneeId (cadeia de caracteres): Filtrar por responsável
      • labels (cadeia de caracteres[]): Filtrar por rótulos
      • priority (número): Filtrar por prioridade
      • limit (número, padrão: 10): Max de resultados

  4. linear_get_user_issues: Obter issues atribuídas a um usuário

    • Entradas opcionais:
      • userId (cadeia de caracteres): ID do usuário (omitir para o usuário autenticado)
      • includeArchived (booleano): Incluir issues arquivadas
      • limit (número, padrão: 50): Max de resultados

  5. linear_add_comment: Adicionar comentários em issues

    • Entradas obrigatórias:
      • issueId (cadeia de caracteres): ID da issue para comentar
      • body (cadeia de caracteres): Texto do comentário (suporta markdown)
    • Entradas opcionais:
      • createAsUser (cadeia de caracteres): Nome de usuário personalizado
      • displayIconUrl (cadeia de caracteres): URL do avatar personalizado

Recursos

  • linear-issue:///{issueId} - Ver detalhes de uma issue individual
  • linear-team:///{teamId}/issues - Ver issues da equipe
  • linear-user:///{userId}/assigned - Ver issues atribuídas ao usuário
  • linear-organization: - Ver informações da organização
  • linear-viewer: - Ver o contexto do usuário atual

Exemplos de uso

Alguns exemplos de prompts que você pode usar com o Claude Desktop para interagir com o Linear:

  1. "Mostre-me todas as minhas issues de prioridade alta" → execute a ferramenta search_issues e/ou linear-user:///{userId}/assigned para encontrar issues atribuídas a você com prioridade 1

  2. "Com base no que eu já falei sobre esse bug, crie um relatório de bug para o sistema de autenticação" → use create_issue para criar uma nova issue de alta prioridade com detalhes apropriados e rastreamento de status

  3. "Encontre todas as tarefas de frontend em andamento" → use search_issues para localizar issues relacionadas ao frontend com tarefa em andamento

  4. "Dê-me um resumo das atualizações recentes nas issues do desenvolvimento do aplicativo móvel" → use search_issues para identificar a(s) issue(s) relevante(s) e depois linear-issue:///{issueId} buscar os detalhes da issue e mostrar atividade recente e comentários

  5. "Qual é a carga de trabalho atual para a equipe móvel?" → combine linear-team:///{teamId}/issues e search_issues para analisar a distribuição e prioridades das issues na equipe móvel

Desenvolvimento

  1. Instale as dependências:
npm install
  1. Configure a chave de API Linear em .env:
LINEAR_API_KEY=your_api_key_here
  1. Compile o servidor:
npm run build

Para desenvolvimento com reconstrução automática:

npm run watch

Licença

Este servidor MCP está licenciado sob a Licença MIT. Isso significa que você é livre para usar, modificar e distribuir o software, sujeito aos termos e condições da Licença MIT. Para mais detalhes, consulte o arquivo LICENSE no repositório do projeto.