Linear MCP: подключение ИИ к задачам команды

Как подключиться к Linear MCP и пройти авторизацию

Используйте адрес https://mcp.linear.app/mcp и транспорт Streamable HTTP — подключение к серверу по HTTP. Интерактивная настройка использует OAuth 2.1 с динамической регистрацией клиента: этот механизм отвечает за регистрацию клиента и авторизацию пользователя. Другой вариант — передать токен OAuth или API-ключ Linear в заголовке Authorization: Bearer <yourtoken>. Настройка Linear MCP

MCP можно представить как единое окно обслуживания. Ассистент запрашивает операцию по имени — например, найти задачу или сохранить изменение. Сервер Linear выполняет её в пределах прав, выданных подключению. Промпт объясняет, что нужно сделать, но дополнительных прав не даёт.

Это разные способы ограничить доступ. Фраза «ничего не меняй» в промпте — инструкция для ассистента. Эндпоинт или учётные данные с доступом только для чтения ограничивают сами доступные ему действия. Варианты доступа в Linear

Как настроить клиент, которым пользуется команда

Claude и Claude Code

В браузерной или настольной версии Claude откройте Settings → Connectors и подключите Linear. Именно этот путь указан на странице интеграции Linear с Claude.

Для Claude Code:

1. Выполните в терминале claude mcp add --transport http linear-server https://mcp.linear.app/mcp.
2. Откройте сессию Claude Code.
3. Выполните /mcp и пройдите авторизацию.

Команда и дальнейшие действия приведены в инструкции Linear по настройке Claude.

Cursor

В основном руководстве Linear есть ссылка для установки и рекомендация найти Linear на странице MCP-инструментов Cursor. Воспользуйтесь ссылкой в разделе Linear о Cursor.

На отдельной странице интеграции с Cursor описана и ручная настройка:

1. Нажмите Ctrl/Cmd + Shift + J, чтобы открыть настройки Cursor.
2. Выберите MCP.
3. Нажмите Add new global MCP server.
4. Добавьте эту конфигурацию:

{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.linear.app/mcp"]
    }
  }
}

Здесь используется mcp-remote — посредник между клиентом и сервером. Эта конфигурация опубликована на странице интеграции Linear с Cursor.

Codex CLI и расширение для IDE

По документации Linear, CLI и расширение для IDE используют общую конфигурацию MCP.

1. Выполните codex mcp add linear --url https://mcp.linear.app/mcp.
2. Следуйте запросу на вход в Linear, описанному в руководстве по настройке.
3. При ручной настройке Linear предлагает отредактировать ~/.codex/config.toml, а затем пройти авторизацию командой codex mcp login linear.

Прежде чем копировать конфигурацию, обратите внимание на расхождение в документации:

На отдельной странице для ручной настройки сервера используется секция [mcp_servers.linear] со значением url = "https://mcp.linear.app/mcp". Здесь настройки приведены так, как они опубликованы, но расходящиеся флаги функций не стоит считать обязательным условием для любой актуальной конфигурации. Интеграция Linear с Codex, основное руководство по MCP

Используйте описанный выше путь с командами добавления сервера и входа. В актуальном руководстве OpenAI по MCP описаны настройка HTTP-сервера и команда codex mcp login <server-name>; ни один из этих флагов там не требуется. Официальная документация OpenAI по MCP

ChatGPT

Следуйте способу подключения, который описан в документации Linear:

1. Откройте настройки коннекторов ChatGPT по ссылке со страницы интеграции Linear с ChatGPT.
2. Подключите Linear.
3. Добавьте Linear как источник в режиме глубокого исследования.

Linear описывает это подключение как способ обращаться к задачам, проектам и обсуждениям с сохранением действующих прав пользователя. Создание и обновление задач через такую настройку в документации не описаны. Используйте её для исследований и сводок, а для приведённых ниже примеров с редактированием выберите MCP-клиент с документированной поддержкой записи. Это уточнение относится к конкретному подключению, а не ко всем интеграциям ChatGPT.

Какие инструменты перечислены в документации Linear

Главное — различать получение контекста и сохранение изменений. Ниже приведены точные идентификаторы из опубликованного Linear списка часто используемых инструментов и их назначение. Список находится на странице интеграции со Slack, в разделе о подключении того же сервера Linear MCP к Slackbot. Список инструментов Linear

В журнале изменений Linear также перечислены list_cycles, list_issue_labels, list_comments, save_project и save_document. Там описаны получение сведений о циклах, постраничная выдача меток и комментариев, изменение проектов, а также создание документов или изменение их родительской привязки к инициативам или циклам. Это перечень нужных для работы инструментов из опубликованных материалов, а не утверждение, что каждый клиент предоставляет один и тот же каталог неизменного размера. Инструменты для циклов и меток, инструменты для комментариев, инструменты для проектов и документов

В старых примерах могут встречаться отдельные вызовы create_issue и update_issue. Linear объединила их в save_issue. Учитывайте это, когда копируете старые промпты или строите интеграцию с обращением к инструментам по имени. Изменение инструментов Linear

Какой доступ получает ассистент и что контролирует администратор

Считайте подключение авторизованным каналом доступа к данным рабочего пространства. В терминологии OAuth у Linear read означает «доступ на чтение для учётной записи пользователя», а write — «доступ на запись для учётной записи пользователя». По умолчанию приложение действует от имени пользователя и создаёт ресурсы от имени того, кто выдал ему разрешение. Права OAuth в Linear

Для API-ключей Linear использует формулировку «полный доступ к данным, доступным вашему пользователю», при этом права и список команд можно ограничить. Поэтому ключ с ограничениями существенно отличается от личного ключа с широкими полномочиями. Права API-ключей

Доступные средства контроля зависят от способа авторизации подключения:

По описанию Linear, согласование приложений позволяет контролировать, «какие приложения могут получать доступ к рабочему пространству и его данным». Участники могут запросить одобрение при установке. Управление ключами относится к авторизации через API-ключи и не заменяет контроль подключений приложений через OAuth. Одобрение приложений, администрирование API

Для поддерживаемых клиентов Anthropic рабочие пространства Enterprise с Okta SAML могут использовать авторизацию под управлением организации. Linear указывает, что при этом «применяются существующие права пользователей в Linear». Администраторы управляют доступом через Okta, и пользователям не нужно отдельно авторизовывать каждое подключение. Авторизация под управлением организации

Если нужен только отчёт о состоянии работы, выбирайте доступ для чтения. Для разбора входящих задач и создания новых выдайте необходимые права на запись, а предлагаемые изменения показывайте до их применения. Такая проверка — рекомендация по организации работы, а не утверждение, что все клиенты одинаково требуют подтверждения.

Три сценария, с которых стоит начать

Начните с отчётов по циклу: для них запись не нужна. Следующий шаг — разбор входящих задач, если в нём много повторяющейся работы. Создание задач по спецификации окупается там, где руководитель тратит время на перенос уже принятых решений в трекер.

Ниже разобраны вымышленные примеры. Они показывают промпты и ожидаемые результаты, а не итоги проверки в реальной учётной записи.

Разобрать новые задачи и предложить изменения для проверки

Руководитель разработки может попросить ассистента изучить новые обращения, найти похожие задачи и собрать предложения по изменениям. Это сокращает повторяющийся поиск и редактирование полей, а решения об исполнителях и приоритетах остаются за руководителем.

Исходные данные для примера: В новом обращении «Кнопка экспорта зависает» сказано, что браузер перестаёт отвечать при экспорте с фильтрами. Уже существующая задача «Экспорт с фильтрами не завершается» описывает тот же экран. В другом обращении, «Приглашения не приходят», нет ни журналов доставки, ни шагов воспроизведения.

Промпт:

Пример полезного предложения:

После проверки руководитель может разрешить через save_issue только согласованные изменения меток и исполнителей, оставив неоднозначные обращения без изменений. Ассистент должен вернуть ссылки на затронутые задачи и перечень изменённых полей. Операции получения данных и сохранения описаны в списке инструментов Linear.

Прежде чем строить собственную систему разбора, сравните её с Triage Intelligence. В Linear уже есть предложения значений полей и поиск дубликатов или связей между задачами. Собственный сценарий на MCP имеет больше смысла, когда для решения нужен контекст или правила, выходящие за рамки встроенного процесса. Triage Intelligence

Создать задачи по спецификации, не придумывая требований

Основатель компании может получить черновики задач из согласованного описания функции, проверить их и затем создать в Linear. Польза — в согласованности: у каждой задачи есть исходное требование, а нерешённые вопросы остаются на виду.

Пример спецификации: «Администраторы рабочего пространства могут приглашать участников по электронной почте. Приглашённые принимают приглашение по ссылке из письма. Администраторы могут отзывать ещё не принятые приглашения. Изменения в оплате и массовая отправка приглашений не входят в объём работ».

Промпт:

Предлагаемая разбивка на задачи:

Открытые вопросы: Что происходит, если адрес электронной почты уже принадлежит участнику? Есть ли у приглашения срок действия? Что увидит приглашённый после отзыва приглашения? Пока владелец продукта не примет решение, это остаётся вопросами.

После одобрения ассистент может создать родительскую задачу и подзадачи, вернуть их URL и указать, что создать не удалось. Создание подзадач входит в документированные возможности MCP. Изменения MCP в Linear

Ассистент переносит требования в задачи. Продуктовые решения по-прежнему принимает владелец продукта.

Подготовить еженедельный отчёт по задачам цикла

Руководитель может превратить данные о работе в цикле в черновик отчёта, где каждое утверждение подкреплено ссылкой. Это сокращает путь от разрозненных обновлений в задачах до отчёта, который можно проверить.

Еженедельный отчёт и сводка по циклу могут охватывать разные периоды. Укажите команду, цикл и отчётный период, чтобы «завершено в этом цикле» незаметно не превратилось в «завершено на этой неделе».

Исходные данные для примера: Задача «Письмо с приглашением» получила статус Done в отчётном периоде. Задача «Принятие приглашения» остаётся в статусе In Progress. В комментарии к задаче «Отзыв приглашения» сказано, что реализация ждёт продуктового решения о том, что пользователь увидит при переходе по отозванной ссылке.

Промпт:

Пример черновика:

В реальном черновике у каждого предложения должна быть ссылка на соответствующую задачу. В примере намеренно нет процента выполнения или утверждения о выпуске функции. Получение циклов, задач и комментариев даёт данные для такого процесса. Инструменты для циклов и задач, получение комментариев

Что ещё можно поручить ассистенту, когда основные сценарии отлажены

Создание комментариев входит в документированные возможности сервера, а инструменты для проектов дают контекст для передачи работы. Возможности сервера, инструменты для проектов

Как посчитать выгоду с учётом времени на проверку

Экономия относится к затратам на координацию разработки. Без MCP руководитель ищет данные, копирует их, сверяет и оформляет. С подключённым ассистентом он по-прежнему определяет рамки запроса, проверяет результат и исправляет ошибки.

Подставьте свои затраты в формулу, чтобы понять, окупается ли процесс:

Чистая выгода = (время на ручную подготовку − время на подготовку с ассистентом, проверку и исправления) × полная стоимость часа работы − дополнительные затраты на клиент и эксплуатацию.

Если красиво оформленный отчёт требует больше времени на проверку, команда ничего не сэкономила. Сравнивайте процессы при одинаковом объёме отчёта и учитывайте исправление последствий ошибочных изменений. Практический ориентир — меньше работы по координации на каждый принятый результат.

Выбрать подписку поможет обзор тарифов Linear. Если вы ещё выбираете сам трекер, прочитайте сравнение Linear и Jira. Другие подключения разобраны в нашем обзоре лучших MCP-серверов.

Какие продукты имеет смысл строить на этой основе

Сервис подготовки отчётов по циклу — наиболее перспективная отправная точка. Руководитель разработки может быть готов платить за единообразный отчёт, который соблюдает границы команд, отделяет завершённую работу от открытой и подтверждает выводы данными из задач. Минимальная полезная версия сохраняла бы параметры отчёта, получала нужные данные цикла и готовила редактируемый черновик. Расписание, повторные попытки и доставка отчёта были бы частью вашего приложения.

Сложность — в отличиях от альтернатив: обычный промпт для сводки легко воспроизвести. Основой продукта могут стать правила отчётности компании, возможность проследить выводы до источников и процедура проверки. Прежде чем запускать отдельную подписку, убедитесь, что именно эти детали регулярно создают командам трудности.

Собственная очередь проверки предложений по входящим задачам — более узкая возможность. Руководитель платформенной команды или инженерной поддержки может быть готов платить за объединение контекста задач Linear с внутренними правилами распределения и данными поддержки, доступ к которым выдан отдельно. Минимальная версия показывала бы предлагаемые изменения полей, их основания и действия «одобрить» или «пропустить», а затем применяла согласованные изменения.

Сложность здесь — в прямой конкуренции со встроенной Triage Intelligence. Разработка оправдана лишь там, где дополнительный контекст или правила меняют решение, с которым встроенная система недостаточно хорошо справляется для этой команды. Это продуктовые гипотезы, а не заявления о подтверждённых результатах клиентов.

Где заканчиваются возможности подключения

MCP даёт ассистенту доступ к операциям, но не устраняет неоднозначность требований и не делает неполные данные задач достоверными. Статус Done позволяет утверждать, что задача отмечена как завершённая. Сам по себе он не доказывает, что функция дошла до клиента.

Точно так же авторизация в Linear не даёт доступа ко всем документам, репозиториям и системам поддержки, упомянутым в задаче. Если вашей разработке нужны эти источники, предусмотрите отдельные способы доступа и получения данных.

Для новых подключений используйте /mcp. Linear помечает /sse как устаревший запасной вариант. Более ранний сервер сообщества jerhadf тоже прямо обозначен как устаревший и больше не поддерживаемый; его пользователям предлагается перейти на официальный сервер Linear. Актуальные рекомендации по эндпоинтам

Первый шаг на понедельник: пусть руководитель разработки задаст команду, цикл и отчётный период для черновика отчёта с доступом только для чтения. Сверьте утверждения со связанными задачами и сравните трудозатраты на подготовку с текущим процессом. Переходите к записи, когда у команды появится понятный порядок проверки.

Если хотите внедрить эти сценарии с учётом правил вашей команды, мы разрабатываем автоматизации на базе ИИ.