Як підключити Linear до Claude Code

Команда CRUX · · Команди перевірено · 5 хв читання
Щоб підключити Linear до Claude Code, додайте офіційний MCP-сервер Linear командою claude mcp add --transport http linear-server https://mcp.linear.app/mcp. Потім виконайте /mcp у Claude Code і увійдіть у Linear в браузері. Для одного розробника це найкоротший робочий спосіб, і API-ключ для нього не потрібен.
Як підключити Linear до Claude Code?
Потрібні встановлений Claude Code і акаунт у тому workspace Linear, з яким ви працюєте. Для такого підключення документація Linear про MCP не називає платного плану Linear. Плани Business і Enterprise вона згадує лише для бета-функції автопідключення в застосунку Claude.
- Додайте сервер. Виконайте в терміналі, у папці проєкту:
claude mcp add --transport http linear-server https://mcp.linear.app/mcp- Увійдіть. Запустіть Claude Code і виконайте:
/mcpОберіть linear-server і пройдіть кроки в браузері. Linear використовує OAuth 2.1 з динамічною реєстрацією клієнта, тож доступ ви підтверджуєте на сторінці самого Linear і жодного токена не вставляєте. Claude Code зберігає токен і сам його оновлює. З терміналу той самий вхід запускає claude mcp login linear-server.
Типово Claude Code додає сервер в області local, тому він працює лише для вас і лише в поточному проєкті. Прапорець --scope user робить сервер доступним у всіх ваших проєктах, а --scope project записує його для команди у файл .mcp.json у корені проєкту, це описує документація Claude Code про MCP. Linear не публікує такого файлу для Claude Code, тож ось запис у форматі самого Claude Code:
{
"mcpServers": {
"linear-server": {
"type": "http",
"url": "https://mcp.linear.app/mcp"
}
}
}Якщо Claude Code має тільки читати Linear і нічого не змінювати, замість типової адреси візьміть адресу лише для читання https://mcp.linear.app/mcp/readonly.
Там, де вхід через браузер неможливий, Linear приймає API-ключ у заголовку Authorization: Bearer. Ключ створюють у Linear в налаштуваннях акаунта, у розділі "Security & access", якщо адмін workspace дозволяє учасникам створювати ключі. Claude Code передає заголовки через прапорець --header.
Як перевірити, що підключення працює?
Виведіть сервери, про які знає Claude Code:
claude mcp listУ списку має бути linear-server зі статусом ✔ Connected, а до входу зі статусом ! Needs authentication. Деталі одного сервера показує команда:
claude mcp get linear-serverУ самому Claude Code команда /mcp показує стан сервера і те, чи ви увійшли. Після цього попросіть щось, що легко звірити очима, наприклад "Покажи задачі в Linear, призначені на мене", і відкрийте поруч Linear.
Що Claude Code може робити в Linear після цього, а чого не може?
За документацією Linear, сервер має інструменти для пошуку, створення й оновлення задач (у Linear вони називаються issues), проєктів і коментарів, і цей набір обіцяють розширювати.
Обмеження такі:
- Сторінка Linear не публікує повного списку інструментів і не називає лімітів саме для MCP-сервера. Які інструменти сервер дає сьогодні, показує меню
/mcpу Claude Code. - З типовою адресою Claude Code може писати в Linear. Якщо вам це не потрібно, беріть адресу лише для читання.
- Сервер відповідає на виклики із сесії, яку запустила людина. Сам він сесію не запускає, коли задача змінює статус.
Claude Code чи застосунок Claude?
Claude Code працює у вашому терміналі, і підключає його claude mcp add. У застосунку Claude (claude.ai, Claude Desktop і мобільний застосунок) Linear з'являється як конектор: власний конектор Linear є в каталозі Anthropic, а довідка Anthropic пояснює, як користуватися конекторами. Його додають у налаштуваннях застосунку, без жодної команди.
Конектор, доданий у claude.ai, з'являється і в Claude Code, якщо ви ввійшли в Claude Code тим самим акаунтом claude.ai. claude mcp add усе одно потрібен, коли Claude Code працює з API-ключем, коли вам потрібна адреса лише для читання або файл .mcp.json для команди.
Що змінюється, коли так роблять троє і більше людей?
Саме підключення працює далі. Кожен входить під власним акаунтом Linear, а прапорець --scope project записує сервер у файл .mcp.json, який команда тримає в репозиторії. Першого разу Claude Code просить кожного підтвердити цей сервер. Сервер не відповідає на інше питання: як команда працює разом.
- Статус не має власника. Задача стоїть у "In Review". Розробник Андрій вважає, що наступний крок запускає Марія з QA, а Марія чекає, поки Андрій попросить. Ніде не сказано, хто запускає крок і хто приймає його результат.
- У кожного розробника свої промпти. Андрій спершу просить у Claude Code план. Інший розробник вставляє текст задачі і просить одразу виправлення. Рев'ювер не може сказати, яким із двох способів зроблено PR.
- Відповіді лишаються в чаті. PM Олена відповідає Андрієві в месенджері, у якому форматі робити експорт. Андрій вставляє відповідь у свою сесію. Наступна сесія над цією ж задачею цієї відповіді вже не має.
- Ніхто не бачить, яка сесія на кого чекає. На трьох ноутбуках відкрито три сесії. Одна чекає на Олену, друга на рев'ю, і дізнатись про це можна, лише розпитавши кожного.
Як командну частину вирішує CRUX?
CRUX робимо ми, тож тут ідеться про наш власний продукт. Він у беті.
Те, що агентові треба знати про проєкт, уже є в Linear: задача, її батьківська задача і рішення, які вже в ній записано. CRUX дає агентові це прочитати, а кожен статус у вашому воркфлоу має власні інструкції, тож промпт ніхто не пише. CRUX це шар воркфлоу між трекером команди і агентами для коду, якими команда вже користується.
Кожен учасник підключає власний акаунт Linear через OAuth. Проєкт у CRUX прив'язаний до однієї команди (team) в Linear, а цикли стають спринтами, коли для цієї команди цикли увімкнено. Кожен статус має роль-власника. Людина запускає кожен крок, погоджує результат у контрольних точках погодження і переводить задачу в наступний статус. Кожен крок публікує свій артефакт коментарем у задачі, тому відповідь Олени і погоджений план лежать там, де їх прочитає наступна сесія.
Коли досить самого MCP-сервера?
- Ви працюєте самі або єдині в команді користуєтесь агентом для коду.
- Над проєктом працюють двоє людей, які говорять щодня, і домовитись, хто що робить, їм вистачає одного речення.
- Вам потрібно лише, щоб Claude Code читав задачі, створював їх і коментував.
- Команда вже має спільні промпти й узгоджений порядок кроків, і вони працюють.
У цих випадках сервер Linear є правильним інструментом, і додавати до нього нічого не треба.
Часті питання
Чи є офіційний MCP-сервер Linear?
Так. Linear тримає його за адресою https://mcp.linear.app/mcp, а описує на сторінці https://linear.app/docs/mcp.
Чи потрібен API-ключ Linear?
Ні. Типовий вхід відбувається через OAuth у браузері. API-ключ у заголовку Authorization: Bearer є необов'язковою альтернативою.
Чи можна дати Claude Code доступ до Linear лише на читання?
Так. Візьміть адресу https://mcp.linear.app/mcp/readonly або API-ключ, який має тільки дозвіл Read.
Чи має кожен учасник команди входити окремо?
Так. Спільний файл .mcp.json містить лише адресу сервера. Кожен виконує /mcp і входить під власним акаунтом Linear.
Спробуйте на своєму проєкті. CRUX безкоштовний для однієї людини, картка не потрібна.
Почати безкоштовноДалі: Як підключити Plane до Claude Code
Усі статті