Linear MCP Server

Linear MCP Server

Um servidor Model Context Protocol para a Linear API.

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

Instalação

Instalando via Smithery

Para instalar o Linear Integration Server para Claude Desktop automaticamente via Smithery:

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

Instalação Manual

1. Crie ou obtenha uma chave de API do Linear para 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",
        "@modelcontextprotocol/server-linear"
      ],
      "env": {
        "LINEAR_API_KEY": "your_linear_api_key_here"
      }
    }
  }
}

Componentes

Ferramentas

1. linear_create_issue: Criar novas issues no Linear

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

2. linear_update_issue: Atualizar issues existentes

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

3. linear_search_issues: Buscar issues com filtros flexíveis

   • Entradas opcionais:
     • query (string): Texto para buscar no título/descrição
     • teamId (string): Filtrar por equipe
     • status (string): Filtrar por status
     • assigneeId (string): Filtrar por responsável
     • labels (string[]): Filtrar por etiquetas
     • priority (número): Filtrar por prioridade
     • limit (número, padrão: 10): Máximo de resultados

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

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

5. linear_add_comment: Adicionar comentários a issues

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

Recursos

• linear-issue:///{issueId} - Visualizar detalhes de uma issue individual
• linear-team:///{teamId}/issues - Visualizar issues da equipe
• linear-user:///{userId}/assigned - Visualizar issues atribuídas ao usuário
• linear-organization: - Visualizar informações da organização
• linear-viewer: - Visualizar 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 alta prioridade" → 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 te contei 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 a 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), depois linear-issue:///{issueId} busque os detalhes da issue e mostre a atividade recente e comentários

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

Desenvolvimento

1. Instale as dependências:

npm install

1. Configure a chave de API do Linear em .env:

LINEAR_API_KEY=your_api_key_here

1. Compile o servidor:

npm run build

Para desenvolvimento com recompilação automática:

npm run watch

Licença

Este servidor MCP é 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.