Linear MCP: задачи и проекты Linear в Claude Code, Codex и Cursor

tacticlaunch/mcp-linear· Проверено 12.11.2026· 151на GitHub

Подключает агента к Linear: найти и создать задачу, сменить статус и исполнителя, оставить комментарий, вести проекты, циклы и апдейты по проектам.

2 реализации:

Пакет из npm на 198 инструментов по всему GraphQL API Linear: задачи, проекты, циклы, документы, клиенты, вебхуки, OAuth-приложения; вход по личному API-ключу.

Как подключить

Что сделать до подключения

Node.js 20 или новее

Личный API-ключ Linear

LINEAR_API_TOKEN

Linear → аватар организации → Settings → Security & access → Personal API Keys → New API Key; ключ показывается один раз

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'LINEAR_API_TOKEN=<ваш API-ключ Linear>' --transport stdio linear \
  -- npx -y @tacticlaunch/mcp-linear

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.linear]
command = "npx"
args = ["-y", "@tacticlaunch/mcp-linear"]

[mcp_servers.linear.env]
LINEAR_API_TOKEN = "<ваш API-ключ Linear>"

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": ["-y", "@tacticlaunch/mcp-linear"],
      "env": {
        "LINEAR_API_TOKEN": "<ваш API-ключ Linear>"
      }
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "linear": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@tacticlaunch/mcp-linear"],
      "env": {
        "LINEAR_API_TOKEN": "<ваш API-ключ Linear>"
      }
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": ["-y", "@tacticlaunch/mcp-linear"],
      "env": {
        "LINEAR_API_TOKEN": "<ваш API-ключ Linear>"
      }
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": ["-y", "@tacticlaunch/mcp-linear"],
      "env": {
        "LINEAR_API_TOKEN": "<ваш API-ключ Linear>"
      }
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "linear": {
        "type": "local",
        "command": ["npx", "-y", "@tacticlaunch/mcp-linear"],
        "environment": {
          "LINEAR_API_TOKEN": "<ваш API-ключ Linear>"
        }
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": ["-y", "@tacticlaunch/mcp-linear"],
      "env": {
        "LINEAR_API_TOKEN": "<ваш API-ключ Linear>"
      }
    }
  }
}

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": ["-y", "@tacticlaunch/mcp-linear"],
      "env": {
        "LINEAR_API_TOKEN": "<ваш API-ключ Linear>"
      }
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

linear_getViewerчитает текущего пользователя

linear_getTeamsпоказывает команды

linear_getUsersпоказывает пользователей

linear_searchIssuesищет задачи по фильтрам

linear_getIssueByIdчитает задачу по номеру

linear_createIssueсоздаёт задачу

linear_updateIssueменяет задачу

linear_assignIssueназначает исполнителя

linear_setIssuePriorityзадаёт приоритет

linear_addIssueLabelвешает метку

linear_createCommentпишет комментарий

linear_getCommentsчитает комментарии

linear_getWorkflowStatesпоказывает статусы команды

linear_getProjectsпоказывает проекты

linear_createProjectсоздаёт проект

linear_createProjectUpdateпубликует апдейт по проекту

linear_getActiveCycleпоказывает текущий цикл

linear_getDocumentsищет документы

linear_createDocumentсоздаёт документ

linear_createWebhookсоздаёт вебхук

Показано 20 из 198.

Удалённый сервер, который вы разворачиваете сами на Cloudflare Workers или Bun: 15 инструментов, пачки до 50 задач, вход через OAuth Linear, без удаления.

Как подключить

Что сделать до подключения

Создать OAuth-приложение в Linear с адресом возврата /oauth/callback вашего сервера

Развернуть сервер на Cloudflare Workers командой bun run deploy или запустить на Bun 1.4+ с Node.js 22.18+

Задать PROVIDER_CLIENT_ID, PROVIDER_CLIENT_SECRET, RS_TOKENS_ENC_KEY и адрес MCP_PUBLIC_URL

В клиенте указать адрес сервера: при первом подключении откроется вход в Linear

PROVIDER_CLIENT_ID

client ID OAuth-приложения сервера в Linear

PROVIDER_CLIENT_SECRET

client secret того же OAuth-приложения

RS_TOKENS_ENC_KEY

32 случайных байта в base64url, шифрует сохранённые токены; без него сервер не стартует

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport http linear-streamable-mcp-server https://linear-mcp.<subdomain>.workers.dev/mcp

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.linear-streamable-mcp-server]
url = "https://linear-mcp.<subdomain>.workers.dev/mcp"

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "linear-streamable-mcp-server": {
      "url": "https://linear-mcp.<subdomain>.workers.dev/mcp"
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "linear-streamable-mcp-server": {
      "type": "http",
      "url": "https://linear-mcp.<subdomain>.workers.dev/mcp"
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "linear-streamable-mcp-server": {
      "httpUrl": "https://linear-mcp.<subdomain>.workers.dev/mcp"
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "linear-streamable-mcp-server": {
      "httpUrl": "https://linear-mcp.<subdomain>.workers.dev/mcp"
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "linear-streamable-mcp-server": {
        "type": "remote",
        "url": "https://linear-mcp.<subdomain>.workers.dev/mcp"
      }
    }
  }
}

Customize → Connectors → добавить свой коннектор.
Адрес сервера: https://linear-mcp.<subdomain>.workers.dev/mcp

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "linear-streamable-mcp-server": {
      "url": "https://linear-mcp.<subdomain>.workers.dev/mcp"
    }
  }
}

Инструменты сервера

workspace_metadataсобирает ID команд, статусов, меток

list_issuesищет задачи по фильтрам

get_issuesчитает до 50 задач

create_issuesсоздаёт до 50 задач

update_issuesменяет и архивирует задачи

list_teamsпоказывает команды

list_usersпоказывает пользователей

list_commentsчитает комментарии к задаче

add_commentsдобавляет до 50 комментариев

update_commentsправит текст комментариев

list_cyclesпоказывает циклы команды

list_projectsищет проекты

create_projectsсоздаёт до 50 проектов

update_projectsменяет проекты

show_issues_uiоткрывает панель задач

Что попросить агента

«Покажи все мои задачи в Linear»tacticlaunch вызовет linear_getViewer и linear_searchIssues, iceener — list_issues с фильтром assignedToMe

«Создай задачу «<название>» в команде <команда>»Агент найдёт команду через linear_getTeams и создаст задачу linear_createIssue

«Переведи задачу <FE-123> в статус «In Progress»»Агент возьмёт статусы команды из linear_getWorkflowStates и сменит статус через linear_updateIssue

«Назначь задачу <BE-456> на <имя>»Агент найдёт человека в linear_getUsers и вызовет linear_assignIssue

«Составь еженедельный апдейт по проекту <проект> из текущего состояния Linear»tacticlaunch соберёт данные через linear_getProjects и linear_searchIssues и опубликует апдейт linear_createProjectUpdate

Для каких задач

Найти свои открытые задачи и сгруппировать их по вехам и циклам

Создать задачу в нужной команде и назначить исполнителя

Сменить статус, приоритет или метку у задачи по её номеру

Составить еженедельный апдейт по проекту из текущего состояния Linear

Завести вебхук на события задач и комментариев

Создать или обновить до 50 задач одним вызовом

Ограничения

Изменения уходят в Linear сразу: оба сервера создают и меняют задачи, комментарии и проекты в рабочем пространстве

iceener нужно развернуть самому: своё OAuth-приложение в Linear и Cloudflare Workers или Bun, общего готового адреса нет

iceener не удаляет задачи, комментарии и проекты, задачи он только архивирует

Личный API-ключ в tacticlaunch не управляет дочерними OAuth-приложениями: для этого нужен токен OAuth-приложения в LINEAR_OAUTH_ACCESS_TOKEN

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
MCP Linear	TacticLaunch	151	локально	токен	198	12 октября 2026
Linear MCP Server	iceener	72	HTTP	вход	15	5 октября 2026

Частые вопросы

Какой из двух серверов выбрать?

tacticlaunch ставится одной строкой через npx и даёт 198 инструментов, вход по личному ключу. iceener подходит, если сервер нужен по адресу в интернете, например для Claude в браузере: его надо развернуть самому, зато токены Linear не попадают в клиент.

Где взять API-ключ Linear?

В Linear нажмите на аватар организации слева вверху, откройте Settings → Security & access и в блоке Personal API Keys нажмите New API Key. Скопируйте ключ сразу: второй раз его не покажут.

Можно подключить Linear к Claude в браузере?

Да, через iceener: в Claude откройте Settings → Connectors, добавьте свой коннектор с адресом развёрнутого сервера и войдите в Linear при первом подключении.

Есть ли у сервера готовые сценарии?

У tacticlaunch есть MCP-промпты summarize-project-status, draft-project-update, triage-issue и summarize-document. Ещё он отдаёт ресурсы вроде linear://project/{id}/issues и linear://rate-limit.

Как поставить tacticlaunch сразу в Claude Code, Cursor и Codex?

Выполните npx add-mcp @tacticlaunch/mcp-linear --env LINEAR_API_TOKEN=<ключ>. Флаг -g ставит сервер глобально, без него — в текущий проект.

Как подключить Linear MCP к Claude Code?

Для iceener выполните claude mcp add --transport http linear <адрес сервера>. Для tacticlaunch откройте вкладку Claude Code в блоке «Как подключить» или поставьте его через npx add-mcp.

Как называется Linear MCP в npm?

Пакет tacticlaunch называется @tacticlaunch/mcp-linear: его запускает npx -y @tacticlaunch/mcp-linear, а npm install -g ставит команду mcp-linear. iceener разворачивают из репозитория: bun install, затем bun run deploy.

Работает ли сервер из России?

tacticlaunch запускается на вашем компьютере и обращается к Linear по вашему ключу; iceener работает там, где вы его развернули, например на Cloudflare Workers.