переведено ИИ

MCP Linear

Сервер Протокола Контекста Модели (MCP) для Linear GraphQL API, созданный для реальных рабочих процессов управления проектами — а не просто базовых CRUD-операций над задачами.

Возможности

MCP Linear связывает ИИ-ассистентов и Linear, реализуя протокол MCP. С его помощью вы можете:

Получать задачи, проекты, команды, циклы, вехи, дорожные карты, клиентов, потребности клиентов и документы рабочего пространства/проекта/инициативы/команды/задачи/релиза/цикла
Создавать и обновлять задачи, менять статус, назначать и комментировать
Управлять проектами, полноценными жизненными циклами обновлений проектов и инициатив с учётом различий, вехами, дорожными картами, сохранёнными представлениями и избранным
Работать с шаблонами, пользовательскими полями, вебхуками и вложениями
Работать со записями клиентов, статусами/уровнями клиентов и потребностями клиентов, связанными с задачами или проектами
Читать уведомления, подписки, сессии, аудиты и интеграции, не выходя из MCP
Проверять лимиты частоты запросов и состояние сервера перед запуском сложных сессий планирования

Полный перечень смотрите в TOOLS.md.

Ресурсы и промпты нативные для MCP

Помимо инструментов, сервер предоставляет ресурсы и промпты MCP, включая:

Ресурсы: linear://viewer, linear://organization, linear://teams, linear://projects, linear://project/{id}, linear://project/{id}/issues, linear://project/{id}/documents, linear://issue/{id}, linear://document/{id}, linear://roadmap/{id}, linear://milestone/{id}, linear://rate-limit
Промпты: summarize-project-status, draft-project-update, triage-issue, summarize-document

Примеры промптов

После подключения вы можете использовать промпты, такие как:

"Покажи мне все мои задачи в Linear"
"Создай новую задачу с заголовком «Исправить баг входа» в команде Frontend"
"Измени статус задачи FE-123 на «В работе»"
"Назначь задачу BE-456 на Джона Смита"
"Покажи все открытые задачи в этом проекте, сгруппированные по вехам и циклам"
"Сформируй черновик еженедельного обновления проекта на основе текущего состояния Linear"
"Найди самые новые документы, относящиеся к проекту, и кратко опиши ключевые решения"
"Покажи закреплённые документы и ссылки на домашней странице этой команды"
"Создай документ для ENG-123 с метаданными упорядочивания ресурсов"
"Получи последний diff обновления проекта и заархивируй устаревшее обновление"
"Покажи потребности клиентов для этого проекта и отметь важные"
"Создай обновление инициативы и скрой сгенерированный diff из текста обновления"

Установка

Получение токена API Linear

Войдите в свой аккаунт Linear по адресу linear.app
Нажмите на аватар организации (в левом верхнем углу)
Выберите Settings (Настройки)
Перейдите в раздел Security & access (Безопасность и доступ) в левой боковой панели
В разделе Personal API Keys нажмите New API Key (Новый ключ API)
Дайте имя вашему ключу (например, MCP Linear Integration)
Скопируйте сгенерированный API-токен и сохраните его в безопасном месте — вы не сможете увидеть его снова

Установка через add-mcp (Рекомендуется)

add-mcp устанавливает сервер в Claude Code, Cursor, Codex, VS Code, Claude Desktop и многие другие агенты, поддерживающие MCP, одной командой:

npx add-mcp @tacticlaunch/mcp-linear --env LINEAR_API_TOKEN=YOUR_LINEAR_API_TOKEN

Добавьте -g для глобальной установки вместо установки в текущий проект. Полный список агентов и флагов смотрите в документации add-mcp.

Ручная конфигурация

Добавьте следующее в файл настроек вашего MCP:

{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": ["-y", "@tacticlaunch/mcp-linear"],
      "env": {
        "LINEAR_API_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

Расположение файлов конфигурации для конкретных клиентов

Cursor: ~/.cursor/mcp.json
Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json
Claude VSCode Extension: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
GoMCP: ~/.config/gomcp/config.yaml

Запуск вручную

Необходимые условия:

Node.js (v18+)
NPM или Yarn
API-токен Linear

# Установка глобально
npm install -g @tacticlaunch/mcp-linear

# Или клонирование и установка локально
git clone https://github.com/tacticlaunch/mcp-linear.git
cd mcp-linear
npm install
npm link  # Делает пакет доступным глобально

Запуск сервера

Запустите сервер с вашим API-токеном Linear:

mcp-linear --token YOUR_LINEAR_API_TOKEN

Или установите токен в переменную окружения и запустите без аргументов:

export LINEAR_API_TOKEN=YOUR_LINEAR_API_TOKEN
mcp-linear

Проверка

Путь проверки по умолчанию:

npm test
npm run build

npm test запускает модульные тесты Jest и официальную проверку работоспособности MCP SDK для построенного сервера stdio, покрывая регистрацию инструментов, ресурсов и промптов, а также генерацию схемы, совместимой с хостом.

Разработка

Подробную информацию о локальной разработке смотрите в DEVELOPMENT.md.

Ссылки

tacticlaunch/cursor-memory-bank — Если вы разработчик, стремящийся улучшить свой рабочий процесс с помощью Cursor, попробуйте этот инструмент.

Лицензия

Этот проект лицензирован по лицензии MIT — подробности смотрите в файле LICENSE.

Linear MCP