Linear MCP Server

O que é o Servidor Linear MCP?

O Servidor Linear MCP é um servidor leve que atua como uma ponte entre aplicações de IA (como o Claude Desktop) e a API de rastreamento de problemas da Linear. Ao seguir o Protocolo de Contexto de Modelo, ele disponibiliza funcionalidades da Linear—como criação de problemas, atualizações, comentários e pesquisas—como ferramentas e recursos acessíveis por grandes modelos de linguagem. Isso otimiza fluxos de trabalho, automatiza a gestão de projetos e melhora a produtividade, integrando a IA de forma fluida com a Linear.

Como Configurar

1. Obtenha uma chave de API da Linear visitando a página de configurações da API da sua equipe Linear.
2. Para integração com o Claude Desktop, adicione a seguinte configuração no seu claude_desktop_config.json (localizado em ~/Library/Application Support/Claude/ no MacOS):

{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": [
        "-y",
        "linear-mcp-server"
      ],
      "env": {
        "LINEAR_API_KEY": "sua_chave_api_aqui"
      }
    }
  }
}

3. Alternativamente, instale automaticamente via Smithery com:

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

4. Certifique-se de que sua LINEAR_API_KEY está fornecida com segurança através de variáveis de ambiente, como mostrado na configuração.

Como Usar

Após configurar e iniciar o servidor:

• Use sua aplicação de IA (por exemplo, Claude Desktop) para consultar a Linear em linguagem natural. O aplicativo irá descobrir automaticamente as ferramentas e recursos disponíveis na Linear através do MCP.
• Exemplos de ações incluem criar novos problemas, atualizar status de problemas, pesquisar tarefas por palavra-chave ou prioridade, recuperar problemas atribuídos ou adicionar comentários.
• Prompt como "Mostre todos os meus problemas de alta prioridade" ou "Crie um relatório de erro para falhas de login" acionará a invocação da ferramenta MCP apropriada.
• Desenvolvedores podem usar endpoints MCP diretamente, como tools/call, para invocar funções da Linear ou explorar opções disponíveis com tools/list.

Principais Características

• Conectividade fluida entre aplicações de IA e Linear via Protocolo de Contexto de Modelo.
• Sem necessidade de codificação de integração personalizada; todas as operações principais de problemas estão disponíveis como ferramentas padronizadas.
• Ferramentas predefinidas para criação de problemas, atualizações, pesquisas, consultas de usuários e comentários.
• Suporta configuração segura do ambiente local, mantendo chaves de API dentro da sua infraestrutura.
• Endpoints de recursos permitem recuperação ou agregação direta de entidades da Linear, como problemas e listas de tarefas da equipe.
• Código aberto (Licença MIT) para modificação e auto-hospedagem.

Casos de Uso

• Automatizar a criação, triagem e rastreamento de tickets de engenharia a partir de relatórios de erros em linguagem simples ou solicitações de recursos.
• Destacar rapidamente tarefas atribuídas ou problemas de alta prioridade durante as reuniões de equipe.
• Permitir que agentes de IA monitorem, resumam e atualizem o progresso em sprints em andamento diretamente na Linear.
• Pesquisa rápida e filtrada por problemas por equipe, responsável, rótulo ou critérios personalizados usando linguagem natural.
• Adicionar comentários ou esclarecimentos a problemas da Linear como parte de fluxos de trabalho conversacionais.
• Analisar a distribuição de carga de trabalho e backlog entre diferentes equipes ou usuários.

FAQ

Q1: O Servidor Linear MCP ainda é mantido?
A1: Não, este projeto está obsoleto. Para a mais recente integração oficial do Linear MCP, consulte https://linear.app/changelog/2025-05-01-mcp ou https://mcp.linear.app/sse.

Q2: Posso usar o Servidor Linear MCP com outras ferramentas LLM além do Claude Desktop?
A2: Sim, você pode usá-lo com qualquer host compatível com o Protocolo de Contexto de Modelo, embora os exemplos de configuração fornecidos sejam específicos para o Claude Desktop.

Q3: Preciso escrever código para interagir com o Servidor Linear MCP?
A3: Não necessariamente. Se sua aplicação de IA suporta MCP, você pode interagir com a Linear em linguagem natural. Desenvolvedores podem invocar endpoints de ferramentas diretamente, se desejarem.

Q4: Onde devo armazenar minha chave de API da Linear?
A4: Armazene sua chave de API em variáveis de ambiente ou no arquivo de configuração da sua aplicação, conforme mostrado. Não compartilhe ou exponha publicamente.

Q5: O que acontece se minha chave de API expirar ou for revogada?
A5: O servidor MCP perderá acesso à Linear e todas as invocações de ferramentas falharão até que uma chave de API válida seja fornecida.