Linear MCP

Linear MCP Server

Uma implementação de servidor Model Context Protocol (MCP) para a API GraphQL do Linear que permite que assistentes de IA interajam com os sistemas de gerenciamento de projetos do Linear.

Recursos

• Acesso à API GraphQL do Linear por meio de ferramentas MCP
• Autenticação por meio da chave de API do Linear
• Recuperar e modificar dados relacionados a usuários, times, projetos e issues
• Criar, atualizar e comentar em issues
• Adicionar e remover etiquetas
• Criar projetos
• Documentação abrangente das ferramentas disponíveis

Instalação

Instalação via Smithery (Recomendado)

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

npx -y @smithery/cli install @emmett.deen/linear-mcp-server --client claude

Configuração Manual

Após a instalação, adicione o seguinte ao seu arquivo de configurações MCP:

{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": ["-y", "@emmett.deen/linear-mcp-server"],
      "env": {
        "LINEAR_API_KEY": "your_linear_api_key_here"
      }
    }
  }
}

Locais de Configuração Específicos por Cliente

• Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json
• Extensão VSCode do Claude: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
• GoMCP: ~/.config/gomcp/config.yaml

Instalação Manual

1. Clone o repositório

git clone https://github.com/yourusername/Linear-MCP-Server.git
cd Linear-MCP-Server

2. Instale as dependências

npm install

3. Compile o projeto

npm run build

4. Crie um arquivo .env com sua chave de API do Linear

LINEAR_API_KEY=your_linear_api_key_here

5. Inicie o servidor

npm start

Ferramentas Disponíveis

Consulte TOOLS.md para obter uma lista completa das ferramentas disponíveis e dos recursos planejados.

Visão Geral

O Linear-MCP-Server preenche a lacuna entre o Claude (assistente de IA) e o Linear (ferramenta de gerenciamento de projetos) implementando o protocolo MCP. Isso permite que o Claude:

• Recupere issues, projetos, times e outros dados do Linear
• Crie e atualize issues
• Altere o status das issues
• Atribua issues aos membros do time
• Adicione comentários
• Crie projetos e times

O servidor utiliza a API GraphQL do Linear e autentica por meio de tokens de usuário (não OAuth) para simplificar.

Primeiros Passos

Pré-requisitos

• Node.js (v18+)
• NPM ou Yarn
• Chave de API do Linear

Instalação

# Install globally
npm install -g @emmett.deen/linear-mcp-server

# Or clone and install locally
git clone https://github.com/yourusername/Linear-MCP-Server.git
cd Linear-MCP-Server
npm install
npm link  # Makes the package available globally

Executando o Servidor

Execute o servidor com sua chave de API do Linear:

linear-mcp-server --token YOUR_LINEAR_API_TOKEN

Ou defina a chave em seu ambiente e execute sem argumentos:

export LINEAR_API_TOKEN=YOUR_LINEAR_API_TOKEN
linear-mcp-server

Usando com o Claude Desktop

Para usar este servidor MCP com o Claude Desktop:

1. Ative o Modo Desenvolvedor no Claude Desktop (na barra de menus)
2. Vá em Configurações > Opções de desenvolvedor
3. Clique em "Adicionar Servidor"
4. Configure com as seguintes opções:
   • Nome: Linear MCP Server
   • Tipo: Processo Local
   • Comando: linear-mcp-server
   • Argumentos: --token SUA_CHAVE_DE_API_DO_LINEAR

Como alternativa, edite manualmente o arquivo de configuração:

{
  "mcp": {
    "servers": [
      {
        "name": "Linear MCP Server",
        "transport": {
          "type": "stdio",
          "command": "linear-mcp-server",
          "args": ["--token", "YOUR_LINEAR_API_TOKEN"]
        }
      }
    ]
  }
}

5. Salve a configuração
6. Reinicie o Claude Desktop (saia completamente e reabra)
7. Agora você deve ver o Linear MCP Server disponível como uma ferramenta no Claude

Exemplos de Prompts para o Claude

Depois de conectado ao Claude Desktop, você pode usar prompts como:

• "Mostre-me todas as minhas issues do Linear"
• "Crie uma nova issue intitulada 'Corrigir bug de login' no time Frontend"
• "Altere o status da issue FE-123 para 'Em Andamento'"
• "Atribua a issue BE-456 a João Silva"
• "Adicione um comentário à issue UI-789: 'Isso precisa ser corrigido até sexta-feira'"

Desenvolvimento

Para desenvolver localmente:

# Clone the repository
git clone https://github.com/yourusername/Linear-MCP-Server.git
cd Linear-MCP-Server

# Install dependencies
npm install

# Run in development mode
npm run dev -- --token YOUR_LINEAR_API_TOKEN

Estendendo o Servidor

Para adicionar novas ferramentas ao servidor:

1. Siga o guia de implementação no documento TOOLS.md
2. Certifique-se de seguir a estrutura de código estabelecida no diretório src/
3. Atualize a documentação para refletir suas alterações

Desenvolvendo e Contribuindo

Configurando o Ambiente de Desenvolvimento

1. Clone o repositório

git clone https://github.com/yourusername/Linear-MCP-Server.git
cd Linear-MCP-Server

2. Instale as dependências

npm install

3. Inicie no modo de desenvolvimento

npm run dev

Publicando no npm

Para publicar este pacote no npm:

1. Atualize a versão no package.json

npm version patch  # or minor, or major

2. Compile o projeto

npm run build

3. Certifique-se de já ter feito login no npm

npm login

4. Publique no npm

npm publish --access public

5. Para o registro Smithery, você precisará trabalhar com a equipe do Smithery para que seu servidor seja listado no catálogo deles.

Licença

Este projeto é licenciado sob a Licença MIT - consulte o arquivo LICENSE para obter detalhes.