Blog · Linear

Servidor MCP do Linear: como configurar no Claude, Cursor, Codex, VS Code e mais

O servidor MCP remoto oficial do Linear permite que clientes de IA encontrem, criem e atualizem issues, projetos e comentários do Linear. O Linear o hospeda em https://mcp.linear.app/mcp, então não há nada para instalar ou rodar por conta própria: você adiciona a URL ao seu cliente e faz login no Linear. Abaixo estão os endpoints e as opções de autenticação, a configuração exata de cada cliente segundo a documentação do Linear e de cada fornecedor, as ferramentas e as correções para os problemas de conexão mais comuns.

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 leiturahttps://mcp.linear.app/mcp/readonly, que "expõe apenas ferramentas de leitura"; listado no registro de MCP desde 5 de novembro de 2026
TransporteStreamable HTTP. Clientes sem suporte a MCP remoto se conectam pelo módulo npm mcp-remote
AutenticaçãoOAuth 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 antigohttps://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 LinearA 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 usoO 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çamento1º 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.

  1. Claude Code

    Rode o comando no terminal e depois rode /mcp em uma sessão do Claude Code para fazer login no Linear. Adicione --scope user para usar o Linear em todos os projetos, ou --scope project para 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 oficial linear@claude-plugins-official usa 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
    /mcp
  2. Claude (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 on
  3. Cursor

    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 com mcp-remote. A documentação do próprio Cursor coloca os servidores remotos em ~/.cursor/mcp.json (global) ou .cursor/mcp.json (projeto) com um campo url. 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"]}}}
  4. 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.json do 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"]}}}
  5. Codex (CLI e extensão de IDE)

    O codex mcp add pede que você faça login. As páginas oficiais divergem sobre uma feature flag: a documentação do Linear adiciona experimental_use_rmcp_client = true em [features] no ~/.codex/config.toml, a página do Linear para o Codex diz rmcp_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 linear
  6. Windsurf

    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.json ou .devin/mcp_config.json e é 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"]}}}
  7. 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": {}}}}
  8. 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 source
  9. Outros, 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/mcp e 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_issues pode filtrar por data de conclusão com completedAt (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 e retiredAt desde 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 OAuth read, 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-auth e 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/mcp e MCP_REMOTE_CONFIG_DIR=~/.mcp-auth/workspace-b npx mcp-remote https://mcp.linear.app/mcp.
  • Config antiga com /sse: troque a URL por https://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 pelo mcp-remote no 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_teams e get_team retornam a visibilidade do time e retiredAt.
  • 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 completedAt em list_issues e 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.

Com o Crewmark

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 LinearCrewmark
O que éUma conexão que permite a um cliente de IA ler e alterar o LinearUm gerenciador de issues em que funcionários de IA são donos das issues
Quem faz o trabalhoVocê, dando prompts ao seu cliente de IACada funcionário de IA, em um heartbeat durante o horário de trabalho
Onde o agente rodaNo seu cliente de IANo seu próprio computador, na sua configuração normal do Claude Code ou do Codex
Quando precisa de vocêEspera o seu próximo promptMarca 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.

Dê aos seus agentes um quadro, e não só uma conexão.

O Crewmark transforma o Claude Code, o Codex e agentes ACP como o OpenCode e o DeepSeek Harness em funcionários de IA com cargos, KPIs, horário de trabalho e um heartbeat.