# Linear: MCP-сервер и CLI с тикетами без интернета (/ru/docs/linear)

Пусть ИИ-агент читает ваши тикеты, проекты и комментарии в Linear, а вам не нужно вставлять их в чат. Инструмент
командной строки `linear` копирует рабочее пространство на ваш компьютер, и агент отвечает по этой копии, даже без
интернета. Если вы разрешите, тот же инструмент создает и меняет тикеты через API Linear.

Агент ответит, какие тикеты команды еще в работе, что написали в комментариях к ENG-12 и какие тикеты никто не
взял. Агент найдет их в локальной копии и назовет каждый тикет по его ключу. Тикет, который вы берете на себя,
становится [задачей](/llms.mdx/docs/ru/tasks/content.md) в локальном хранилище, рядом с задачами из ваших чатов.

`linear` это сразу Linear CLI для терминала и MCP-сервер Linear для приложений вроде Claude Desktop,
а для ChatGPT через туннель, который вы запускаете сами. Нужен
персональный API-ключ Linear, его один раз создают в настройках Linear.

**На этой странице:**

1. [Что вы получите](#что-вы-получите)
2. [Как это устроено](#как-это-устроено)
3. [Создайте персональный API-ключ](#создайте-персональный-api-ключ)
4. [Подключите и скопируйте рабочее пространство](#подключите-и-скопируйте-рабочее-пространство)
5. [Чего пока нет](#чего-пока-нет)
6. [Найдите инструкцию под свою задачу](#найдите-инструкцию-под-свою-задачу)

## Что вы получите [#что-вы-получите]

- **Тикеты без интернета.** Выводите тикеты по команде, проекту, статусу, исполнителю или метке, открывайте тикет с
  комментариями и находите тикеты, проекты и комментарии по словам.
- **Тикет становится вашей задачей.** `issues assign ENG-12` добавляет вам задачу со ссылкой на тикет и сроком, если вы
  его укажете. Текст тикета она не копирует и в Linear ничего не меняет.
- **Все остальное, что есть в Linear.** Создайте тикет, поменяйте его статус, добавьте комментарий, прочитайте циклы и
  документы через группу `api`. `api list` показывает все операции.
- **Вы решаете, что агент может менять.** Каждый профиль разрешает, спрашивает или запрещает каждый вид записи.
  Удалению и архивации нужно отдельное разрешение, `WCLINEAR_READ_ONLY=1` запрещает любую запись, а `--dry-run`
  показывает, что запись отправила бы, и ничего не отправляет. По MCP спросить некого, поэтому запись с уровнем ask
  выполняется. Чтобы это остановить, поставьте `permissions.api` в `readonly`. Подробнее в
  [настройках](/llms.mdx/docs/ru/linear/configuration/content.md#permissions).
- **Агент подключен.** Установите навык инструмента для терминального агента вроде Claude Code или Codex или отдайте
  инструмент по MCP приложению, которое подключается к MCP-серверам.

Ключ хранится в связке ключей системы или в закрытом файле, если связки ключей нет. Вы передаете его скрыто или через
stdin, никогда аргументом, поэтому он не попадает в историю оболочки. Подробнее в [безопасности](/llms.mdx/docs/ru/linear/security/content.md).

## Как это устроено [#как-это-устроено]

- **Копия на вашем компьютере.** `linear` хранит тикеты, проекты и комментарии вместе с командами, статусами и
  метками в локальном хранилище. Это один файл на вашем компьютере, общий для всех инструментов WireCat. Списки и поиск читают
  эту копию, а не Linear.
- **Копия ваша.** Linear показывает каждому участнику свой набор команд, поэтому в копии то, что видит ваш ключ, и
  ничего из закрытых команд других людей.
- **Синхронизация приносит изменения.** Первая синхронизация копирует все. Потом она читает только то, что
  изменилось, а раз в день замечает, что удалили в Linear. Архивные тикеты остаются в копии с пометкой.
- **Профиль для каждого аккаунта.** Профиль - имя, которое вы даете одному аккаунту Linear, например `work`. Каждая
  команда для аккаунта начинается с него: `linear work issues show ENG-12`.
- **Весь API в виде команд.** У каждого из 493 запросов и мутаций API Linear своя команда в группе `api`, со своими
  параметрами и справкой. Агент пользуется теми же командами, в терминале или по MCP.

## Создайте персональный API-ключ [#создайте-персональный-api-ключ]

В Linear откройте [Settings → Account → Security & access](https://linear.app/settings/account/security) и создайте
персональный API-ключ. Linear дает ключу полный доступ или только часть разрешений, например Read, и может
ограничить его несколькими командами. Чтобы копировать и читать рабочее пространство, хватит ключа только на чтение.
Чтобы создавать и менять тикеты через инструмент, добавьте Write. Если такого пункта нет, администратор пространства
отключил API-ключи для участников. Варианты описаны на [странице Linear об API и вебхуках](https://linear.app/docs/api-and-webhooks).

## Подключите и скопируйте рабочее пространство [#подключите-и-скопируйте-рабочее-пространство]

1. [Установите `linear`](/llms.mdx/docs/ru/linear/installation/content.md) из npm.
2. Войдите. `work` - профиль, имя, которое вы даете одному аккаунту Linear. Инструмент спросит ключ скрыто и
   проверит его в Linear, прежде чем сохранить.

```sh
linear work session start
```

3. Скопируйте рабочее пространство и посмотрите тикеты, которые в работе.

```sh
linear work sync
linear work issues list type:started
linear work issues show ENG-12
```

Позже запустите `sync` снова, чтобы получить то, что изменилось.

4. Подключите агента. Терминальный агент получает навык:

```sh
linear skill install
```

Приложение, которое подключается к MCP-серверам, получает сервер, как описано в разделе
[как пользоваться](/llms.mdx/docs/ru/linear/usage/content.md#agents).

## Чего пока нет [#чего-пока-нет]

- Общий поиск WireCat пока не читает тикеты Linear. Ищите их через `issues search`, а не вместе с сообщениями и
  заметками.
- Вход только по персональному API-ключу, без входа через браузер.
- Тикеты создаются и меняются через группу `api`, по одной операции Linear за раз.

## Найдите инструкцию под свою задачу [#найдите-инструкцию-под-свою-задачу]

| Задача | Инструкция |
|---|---|
| Установить или обновить инструмент | [Установка](/llms.mdx/docs/ru/linear/installation/content.md) |
| Понять, как устроена команда, и подключить агента | [Как пользоваться](/llms.mdx/docs/ru/linear/usage/content.md) |
| Найти команду или параметр | [Команды](/llms.mdx/docs/ru/linear/commands/content.md) |
| Поменять настройку или разрешение | [Настройки](/llms.mdx/docs/ru/linear/configuration/content.md) |
| Исправить ошибку | [Если что-то не работает](/llms.mdx/docs/ru/linear/troubleshooting/content.md) |
| Узнать, что инструмент хранит и отправляет | [Безопасность](/llms.mdx/docs/ru/linear/security/content.md) |
| Сравнить с другими инструментами для Linear | [Сравнение с другими инструментами](/llms.mdx/docs/ru/linear/compare/content.md) |
