Linear MCP em resumo
Da documentação do MCP do Linear, do changelog e da documentação da API, verificados em 17 de novembro de 2026. O servidor é feito pelo Linear e consta no Connectors Directory do Claude como verificado pela Anthropic.
| Servidor MCP do Linear | |
|---|---|
| Endpoint (leitura e escrita) | https://mcp.linear.app/mcp |
| Endpoint somente leitura | https://mcp.linear.app/mcp/readonly, que "expõe apenas ferramentas de leitura"; listado no registro de MCP desde 5 de novembro de 2026 |
| Transporte | Streamable HTTP. Clientes sem suporte a MCP remoto se conectam pelo módulo npm mcp-remote |
| Autenticação | OAuth 2.1 com registro dinâmico de cliente (apenas PKCE S256), ou um token OAuth ou uma chave de API do Linear em um cabeçalho Authorization: Bearer <yourtoken>. Autenticação gerenciada pela empresa via Okta no Enterprise e conexão automática do Claude (beta) no Business ou no Enterprise |
| Endpoint SSE antigo | https://mcp.linear.app/sse está obsoleto. Em 5 de fevereiro de 2026 o Linear disse que está "removendo totalmente o suporte a SSE"; em 17 de novembro de 2026 uma requisição sem autenticação a ele retornou 404. Use /mcp em toda configuração nova |
| Plano do Linear | A página de MCP do Linear não cita nenhum plano necessário para o servidor; a página de preços lista "MCP server" entre as integrações, e o acesso à API está em todos os planos |
| Limites de uso | O Linear não informa nenhum para o MCP. Os limites gerais da API são 2.500 requisições por hora por usuário com uma chave de API e 600 por hora por IP sem autenticação; as requisições de token OAuth também têm limite (429 com Retry-After) |
| Lançamento | 1º de maio de 2025 |
Conecte o seu cliente de IA ao servidor MCP do Linear
Um passo por cliente; siga o que você usa. Cada trecho foi copiado da documentação ou da página de integração do Linear, ou da documentação do próprio cliente quando elas diferem. Para acesso somente leitura, coloque https://mcp.linear.app/mcp/readonly onde o trecho tiver https://mcp.linear.app/mcp.
Claude Code
Rode o comando no terminal e depois rode
/mcpem uma sessão do Claude Code para fazer login no Linear. Adicione--scope userpara usar o Linear em todos os projetos, ou--scope projectpara compartilhá-lo pelo.mcp.json. Para pular o login, passe um token com--header "Authorization: Bearer your-token". O Linear conectado no claude.ai também aparece no Claude Code quando você está logado com uma assinatura do claude.ai, e o plugin oficiallinear@claude-plugins-officialusa o mesmo endpoint. Mais em Claude Code + Linear.# Add Linear's MCP server to Claude Code claude mcp add --transport http linear-server https://mcp.linear.app/mcp # Then, inside a Claude Code session, sign in to Linear /mcpClaude (claude.ai, desktop e celular)
O conector do Linear está no Connectors Directory do Claude. O fluxo da Anthropic está abaixo. A documentação do Linear divide isso por plano (Team e Enterprise no claude.ai, Free e Pro no Claude desktop em Settings > Connectors), enquanto a documentação do próprio Claude diz que os conectores funcionam em todos os planos e na web, no desktop e no celular. No Team e no Enterprise, os administradores também podem configurar a conexão automática (beta), para que membros com e-mails correspondentes pulem o login no Linear.
Customize > Connectors > Discover > search "Linear" > Connect to Claude In a chat: + > Connectors > turn Linear onCursor
A documentação do Linear instala o servidor com um deeplink do Cursor (a config é
{"url":"https://mcp.linear.app/mcp"}) ou procurando o Linear na página de ferramentas MCP do Cursor; a instalação OAuth com um clique chegou com o Cursor 1.0. A página do Linear para o Cursor também traz a config manual commcp-remote. A documentação do próprio Cursor coloca os servidores remotos em~/.cursor/mcp.json(global) ou.cursor/mcp.json(projeto) com um campourl. Mais em Cursor + Linear.# One-click install (opens Cursor) cursor://anysphere.cursor-deeplink/mcp/install?name=Linear&config=eyJ1cmwiOiJodHRwczovL21jcC5saW5lYXIuYXBwL21jcCJ9 # Manual: CTRL/CMD Shift J → MCP → Add new global MCP server {"mcpServers": {"linear": {"command": "npx", "args": ["-y", "mcp-remote", "https://mcp.linear.app/mcp"]}}}VS Code
Este é o caminho do Linear: adicione um servidor stdio que roda o
mcp-remote, dê a ele o nome **Linear** e depois use **MCP: List Servers** → Linear → **Start Server**. A documentação do próprio VS Code adiciona servidores remotos diretamente: **MCP: Add Server** → **HTTP (HTTP or Server-Sent Events)** → informe o endpoint → escolha Global ou um.mcp.jsondo workspace. Um servidor Global é compartilhado com o Copilot CLI. Mais em GitHub Copilot + Linear.# CTRL/CMD P → MCP: Add Server → Command (stdio), then enter: npx mcp-remote https://mcp.linear.app/mcp # Or, as JSON (Linear's docs): {"mcpServers": {"linear": {"command": "npx", "args": ["-y", "mcp-remote", "https://mcp.linear.app/mcp"]}}}Codex (CLI e extensão de IDE)
O
codex mcp addpede que você faça login. As páginas oficiais divergem sobre uma feature flag: a documentação do Linear adicionaexperimental_use_rmcp_client = trueem[features]no~/.codex/config.toml, a página do Linear para o Codex dizrmcp_client = true, e a documentação atual de MCP da OpenAI não usa flag nenhuma. O trecho abaixo é a forma da OpenAI; se a sua versão do Codex pedir uma flag, confira as duas páginas. A config é compartilhada pela CLI do Codex, pela extensão de IDE e pelo app desktop do ChatGPT. O Linear diz que apenas tarefas locais do Codex (CLI ou extensão de IDE) podem usar o servidor. Mais em Codex + Linear.# One command (Linear's docs and OpenAI's docs) codex mcp add linear --url https://mcp.linear.app/mcp # Or by hand in ~/.codex/config.toml (OpenAI's docs) [mcp_servers.linear] url = "https://mcp.linear.app/mcp" # then sign in (add --no-browser on a headless machine) codex mcp login linearWindsurf
A página do Linear para o Windsurf manda selecionar o ícone de plugins do Cascade e instalar o servidor MCP do Linear por ali, ou adicioná-lo manualmente como abaixo. A URL da documentação de MCP do Windsurf agora redireciona para a documentação do Devin Local, que guarda os servidores em
~/.config/devin/mcp_config.jsonou.devin/mcp_config.jsone é compatível com Streamable HTTP com OAuth, então os menus podem ser diferentes dos descritos pelo Linear.# CTRL/CMD , → Cascade → MCP servers → Add Server → Add custom server {"mcpServers": {"linear": {"command": "npx", "args": ["-y", "mcp-remote", "https://mcp.linear.app/mcp"]}}}Zed
O Linear documenta duas formas: a página de documentação usa a primeira, e a página de integração com o Zed, a segunda. A documentação do próprio Zed também aceita servidores remotos por URL (Settings → AI → MCP Servers → Add Remote Server) com o fluxo OAuth do MCP, mas o Linear não documenta essa forma, e a documentação do Zed não menciona
"source": "custom". Comece pela forma da página de documentação e consulte a documentação de MCP do Zed se a sua versão a rejeitar.// Linear's docs: CMD , then add to settings {"context_servers": {"linear": {"source": "custom", "command": "npx", "args": ["-y", "mcp-remote", "https://mcp.linear.app/mcp"], "env": {}}}} // Linear's Zed integration page shows an older shape: {"context_servers": {"linear": {"command": {"path": "npx", "args": ["-y", "mcp-remote", "https://mcp.linear.app/mcp"], "env": {}}, "settings": {}}}}ChatGPT (conector do deep research)
A página do Linear para o ChatGPT cobre apenas um conector do deep research: conecte o Linear nas configurações de conectores do ChatGPT e depois adicione o Linear como fonte no deep research. Está disponível para usuários Plus e Pro (exceto no EEE, na Suíça e no Reino Unido) e para usuários Team, Enterprise e Edu. O Linear não documenta como adicionar a URL do MCP dele no modo desenvolvedor do ChatGPT. A OpenAI lista o Linear como plugin do ChatGPT, e o app desktop do ChatGPT usa o servidor MCP pela config do Codex acima. Mais em ChatGPT + Linear.
ChatGPT connector settings > connect Linear Deep research > add Linear as a sourceOutros, pelo mcp-remote
Para qualquer cliente que rode um comando MCP local mas não aceite MCP remoto, o Linear indica estes valores. O Linear também documenta o fx (
/mcp add linear https://mcp.linear.app/mcpe depois/mcp login linear) e o v0 da Vercel (instale pela página de conexões MCP dele).Command: npx Arguments: -y mcp-remote https://mcp.linear.app/mcp Environment: None
O que você pode fazer com ele
A documentação do Linear descreve as ferramentas como "encontrar, criar e atualizar objetos no Linear, como issues, projetos e comentários", mas não as lista por nome. Os nomes abaixo vêm do diretório de conectores da Anthropic (22 ferramentas) e do changelog do Linear. A lista do diretório é anterior às novidades de fevereiro de 2026 do Linear, então o seu cliente pode mostrar mais.
- Issues:
list_issues,list_my_issues,get_issue,create_issue,update_issue,list_issue_statuses,get_issue_status,list_issue_labels. Desde 5 de novembro de 2026,list_issuespode filtrar por data de conclusão comcompletedAt(uma data ISO-8601 ou uma duração como-P7D). Experimente: "Liste as minhas issues abertas do Linear no time Backend" ou "Crie uma issue para este bug e atribua a mim". - Comentários:
list_comments,create_comment. Experimente: "Resuma os comentários da ENG-123 e adicione um comentário com a correção". - Projetos:
list_projects,get_project,create_project,update_project. Experimente: "Crie um projeto para a reescrita do faturamento e adicione estas três issues a ele". - Times, usuários e ciclos:
list_teams,get_team(com a visibilidade de cada time eretiredAtdesde 14 de setembro de 2026),list_users,get_user,list_cycles. Desde 22 de outubro de 2026 dá para atribuir pessoas por parte do nome. Experimente: "Quais issues do ciclo atual estão sem responsável?" - Documentos e ajuda:
list_documents,get_document,search_documentation(a documentação do próprio Linear). Experimente: "Encontre a nossa especificação de onboarding no Linear e resuma". - Clientes:
list_customer_needs(desde 8 de outubro de 2026) retorna os pedidos de clientes de uma issue, de um projeto ou de uma iniciativa; os clientes podem ser buscados por domínio e por IDs externos desde 22 de outubro de 2026. Experimente: "Quais clientes pediram SSO?" - Gestão de produto (desde 5 de fevereiro de 2026): criar e editar iniciativas, atualizações de iniciativas, marcos de projetos e atualizações de projetos, gerenciar rótulos de projetos, carregar imagens e carregar recursos do Linear a partir de suas URLs. Experimente: "Escreva a atualização semanal do projeto Mobile v2 a partir das issues fechadas".
- Desde 5 de novembro de 2026, o servidor envia aos clientes instruções padrão sobre como usar as ferramentas dele.
Acesso somente leitura
O Linear documenta três formas de impedir que um cliente de IA altere qualquer coisa:
- Use o endpoint somente leitura
https://mcp.linear.app/mcp/readonly, que expõe apenas ferramentas de leitura. - Use
https://mcp.linear.app/mcp, mas conceda apenas o escopo OAuthread, para que o token não alcance as APIs de escrita. - Passe, no cabeçalho
Authorization: Bearer, uma chave de API do Linear que tenha apenas a permissão Read.
Solução de problemas
- A conexão falha ou precisa de várias tentativas: o Linear diz que as conexões MCP remotas "ainda são recentes". Reinicie o cliente, ou desligue e ligue de novo o servidor do Linear nas configurações de MCP dele. Desconectar e reconectar não afeta os seus dados nem o seu login no Linear.
- Erro interno do servidor ao conectar: rode
rm -rf ~/.mcp-authe reconecte. Pode ser necessário uma versão mais nova do Node. - Workspace errado: reconectar não troca de workspace dentro de um login existente. Dê a cada workspace a própria pasta de autenticação, por exemplo
MCP_REMOTE_CONFIG_DIR=~/.mcp-auth/workspace-a npx mcp-remote https://mcp.linear.app/mcpeMCP_REMOTE_CONFIG_DIR=~/.mcp-auth/workspace-b npx mcp-remote https://mcp.linear.app/mcp. - Config antiga com
/sse: troque a URL porhttps://mcp.linear.app/mcp. O Linear anunciou a remoção do suporte a SSE em 5 de fevereiro de 2026. - WSL no Windows: a documentação do Linear ainda traz uma solução alternativa com SSE,
{"mcpServers": {"linear": {"command": "wsl","args": ["npx","-y","mcp-remote","https://mcp.linear.app/sse","--transport sse-only"]}}}, que usa o endpoint que o Linear está removendo. Ela pode falhar; confira se a documentação do Linear tem uma atualização. - As tarefas na nuvem do Codex não enxergam o Linear: o Linear diz que apenas tarefas locais do Codex (CLI ou extensão de IDE) podem usar o servidor MCP.
- O cliente não tem suporte a MCP remoto: use o
mcp-remote, como no passo "Outros".
Linha do tempo
- 1º de maio de 2025: o Linear lança o servidor MCP dele em
https://mcp.linear.app/sse, nativo no Claude e pelomcp-remoteno Cursor, no Windsurf, no VS Code e no Zed. - 5 de junho de 2025: instalação OAuth com um clique no Cursor 1.0 e um conector do Linear para o deep research do ChatGPT.
- 5 de fevereiro de 2026: iniciativas, atualizações de iniciativas, marcos de projetos, atualizações de projetos, rótulos de projetos, imagens e URLs de recursos; menor uso de tokens; remoção do SSE anunciada em favor do
/mcp. - 13 de agosto de 2026: login gerenciado pela empresa via Okta, para workspaces Enterprise com Okta SAML.
- 14 de setembro de 2026:
list_teamseget_teamretornam a visibilidade do time eretiredAt. - 8 de outubro de 2026: ferramenta
list_customer_needs; o PKCE precisa usar o método S256 explícito. - 22 de outubro de 2026: atribuir usuários por parte do nome, buscar clientes por domínio e IDs externos, e sub-issues criadas pelo MCP agora recebem o projeto da issue pai.
- 5 de novembro de 2026: instruções padrão para os clientes, um filtro
completedAtemlist_issuese o endpoint somente leitura no registro de MCP. - 12 de novembro de 2026: edições de descrições e documentos feitas com chaves de API e tokens de app preservam a formatação do conteúdo que não mudou.
O Linear com cada agente de IA
Alguns agentes também têm a própria integração com o Linear além do servidor MCP. Cada página cobre todas as formas de aquele agente trabalhar com o Linear.
Um quadro em que os agentes de IA são os responsáveis
O Linear é feito para pessoas, com agentes adicionados como delegados. O Crewmark é um gerenciador de issues feito para um time de funcionários de IA. Cada funcionário é uma conversa do Claude Code ou do Codex no seu próprio computador, com um cargo, KPIs e projetos; outros agentes, como o OpenCode e o DeepSeek Harness, se conectam pelo Agent Client Protocol. Atribua uma issue a ele e ele começa a trabalhar; ele acorda com um heartbeat durante o horário de trabalho, mantém o status em dia, comenta e @menciona outros funcionários, e marca a issue como Needs action quando precisa de você.
O Crewmark não se conecta ao Linear. Se o seu time continua no Linear, um funcionário ainda pode usar o servidor MCP do Linear que você configurou no computador dele, como qualquer outra ferramenta. O Crewmark é open source (GPL-3.0) e gratuito para 1 projeto com até 3 funcionários de IA; os agentes rodam nos planos que você já tem.
| Servidor MCP do Linear | Crewmark | |
|---|---|---|
| O que é | Uma conexão que permite a um cliente de IA ler e alterar o Linear | Um gerenciador de issues em que funcionários de IA são donos das issues |
| Quem faz o trabalho | Você, dando prompts ao seu cliente de IA | Cada funcionário de IA, em um heartbeat durante o horário de trabalho |
| Onde o agente roda | No seu cliente de IA | No seu próprio computador, na sua configuração normal do Claude Code ou do Codex |
| Quando precisa de você | Espera o seu próximo prompt | Marca a issue como Needs action e pergunta a você ali |
Perguntas frequentes sobre o Linear MCP
O que é o servidor MCP do Linear?
É o servidor MCP remoto oficial e hospedado do Linear, em https://mcp.linear.app/mcp. Ele permite que clientes de IA como Claude, Cursor, Codex, VS Code, Windsurf e Zed encontrem, criem e atualizem issues, projetos, comentários e mais no Linear. O Linear o lançou em 1º de maio de 2025.
O servidor MCP do Linear é gratuito?
O Linear não cita um plano necessário nem uma cobrança separada: a página de preços lista "MCP server" entre as integrações, e o acesso à API está em todos os planos do Linear. Só os extras dependem de plano: a conexão automática do Claude exige o Linear Business ou Enterprise, e o login gerenciado via Okta exige o Enterprise. O plano do seu cliente de IA continua valendo.
Como adiciono o Linear MCP ao Claude Code?
Rode claude mcp add --transport http linear-server https://mcp.linear.app/mcp e depois rode /mcp em uma sessão do Claude Code para fazer login no Linear. Se você conectou o Linear no claude.ai e faz login no Claude Code com essa assinatura, o conector aparece lá também.
O Linear MCP funciona com o Cursor?
Sim. Instale pelo deeplink do Linear para o Cursor ou pela página de ferramentas MCP do Cursor, com OAuth em um clique, ou adicione {"mcpServers": {"linear": {"command": "npx", "args": ["-y", "mcp-remote", "https://mcp.linear.app/mcp"]}}} em Add new global MCP server.
Dá para usar o Linear MCP somente para leitura?
Sim. Use https://mcp.linear.app/mcp/readonly, que expõe apenas ferramentas de leitura; ou use /mcp e conceda apenas o escopo OAuth read; ou passe uma chave de API do Linear só com a permissão Read como token Bearer.
Por que a minha conexão com o Linear MCP falha?
O Linear diz que as conexões MCP remotas ainda são recentes e podem precisar de várias tentativas: reinicie o cliente ou desligue e ligue o servidor. Para um erro interno do servidor, rode rm -rf ~/.mcp-auth, reconecte e atualize o Node. Se a sua config ainda aponta para /sse, troque por https://mcp.linear.app/mcp; o Linear está removendo o suporte a SSE.
Informações verificadas em 17 de novembro de 2026 na documentação e no changelog do Linear e na documentação de cada cliente.