MCP Linear

MCP Linear

実際のプロジェクト管理ワークフロー向けに構築された、Linear GraphQL API 用の Model Context Protocol（MCP）サーバーです。基本的な課題の CRUD だけにとどまりません。

機能

MCP Linear は MCP プロトコルを実装することで、AI アシスタントと Linear をつなぎます。次のことができます。

• 課題、プロジェクト、チーム、サイクル、マイルストーン、ロードマップ、顧客、顧客ニーズ、およびワークスペース／プロジェクト／イニシアチブ／チーム／課題／リリース／サイクルのドキュメントを取得
• 課題の作成や更新、ステータスの変更、担当者の割り当て、コメントの追加
• プロジェクト、差分を考慮したプロジェクトとイニシアチブの更新ライフサイクル全体、マイルストーン、ロードマップ、保存済みビュー、お気に入りを管理
• 更新や署名シークレットのローテーションを含む、ワークスペースの Webhook を作成・管理
• OAuth アプリのマニフェストと認可 URL を準備し、スコープを限定したクライアントクレデンシャルのトークンを発行する。または、管理用 OAuth アプリとして認証済みの場合は、子 OAuth アプリを管理
• テンプレート、カスタムフィールド、添付ファイルを操作
• 顧客レコード、顧客ステータス／ティア、課題またはプロジェクトにリンクされた顧客ニーズを操作
• 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 を John Smith に割り当てて」
• 「このプロジェクトの未完了の課題をすべて、マイルストーンとサイクルごとにグループ化して表示して」
• 「現在の Linear の状態を基に、週次のプロジェクト更新を下書きして」
• 「プロジェクトに関連する最新のドキュメントを見つけて、重要な決定事項を要約して」
• 「このチームのホームページにピン留めされたドキュメントとリンクを表示して」
• 「リソース順序のメタデータを付けて ENG-123 のドキュメントを作成して」
• 「最新のプロジェクト更新の差分を取得し、古い更新をアーカイブして」
• 「このプロジェクトの顧客ニーズを表示し、重要なものに印を付けて」
• 「イニシアチブの更新を作成し、生成された差分を更新本文に表示しないで」
• 「クライアントクレデンシャルを有効にして、GitHub の課題パイプライン用の非公開 OAuth アプリを準備して」
• 「その GitHub パイプライン用に、スコープを限定したクライアントクレデンシャルのトークンを発行して」
• 「Issue と Comment のイベント用の Webhook を作成し、その後、署名シークレットをローテーションして」

インストール

認証

個人用 API キー（デフォルト）

1. linear.app で Linear アカウントにログインします
2. 組織のアバター（左上）をクリックします
3. Settings を選択します
4. 左側のサイドバーで Security & access に移動します
5. Personal API Keys の下にある New API Key をクリックします
6. キーに名前を付けます（例：MCP Linear Integration）
7. 生成された API トークンをコピーし、安全な場所に保管します。一度画面を離れると、再び確認することはできません

個人用 API キーは、通常の Linear ツールとワークスペースの Webhook ツールに対応しています。Linear のアルファ版、管理対象の子 OAuth アプリケーション API は呼び出せません。この API では、呼び出し元自体が OAuth アプリケーションである必要があるためです。個人用 API キーを使用している場合でも、linear_generateOAuthApplicationSetup は公式マニフェストと、管理者が確認できるように事前入力された Linear のセットアップ URL を生成します。

OAuth アクセストークン（管理対象 OAuth アプリケーション）

MCP で子 OAuth アプリケーションを実際に作成・管理するには、それらの子アプリケーションを管理できる Linear OAuth アプリケーションのアクセストークンで認証します。

export LINEAR_OAUTH_ACCESS_TOKEN=YOUR_OAUTH_ACCESS_TOKEN
mcp-linear

または、--oauth-token YOUR_OAUTH_ACCESS_TOKEN を渡します。明示的に指定したコマンドラインの認証情報は、環境変数より優先されます。両方の種類の環境変数による認証情報が設定されている場合は、OAuth 認証が選択されます。Linear の OAuth documentation と OAuth application manifests を参照してください。

各 MCP サーバープロセスで使用できる Linear 認証情報は 1 つです。管理アプリのトークンで actor=app を使用している場合（admin を付与できません）、かつ管理者スコープのワークスペース Webhook ツールも必要な場合は、MCP サーバーの設定を 2 つ用意してください。1 つは子アプリ操作用の管理 OAuth トークンを使用し、もう 1 つはワークスペース Webhook 用にワークスペース管理者の個人用 API キーを使用します。admin を持つユーザーアクターの OAuth トークンを使えば、Webhook 側もカバーできます。

OAuth スコープは、認可 URL またはクライアント認証情報トークンをリクエストする際に選択します。OAuth アプリケーション上で変更できるフィールドではありません。MCP は現在の Linear スコープを検証し、認可 URL を用意し、linear_createOAuthClientCredentialsToken でアプリケーションアクターのトークンを発行できます。GitHub でホストされるパイプラインでは、client_credentials グラントを有効にし、issues:create など、用途に必要な最小限のスコープをリクエストしてください。

クライアント認証情報トークンの有効期限は通常 30 日間で、リフレッシュトークンはありません。Linear では、複数の有効なトークンを同じスコープセットで使用している場合に限り、複数のトークンを保持できます。異なるスコープセットをリクエストすると、アプリケーションの既存のアプリケーションアクタートークンは無効になります。そのため、トークンツールでは confirmSecretExposure: true と confirmScopeChangeRisk: true の両方が必要です。

OAuth アプリの作成や OAuth／Webhook シークレットのローテーションを行うと、MCP 経由で一度限りのシークレット情報が返されます。これらのツールでは confirmSecretExposure: true が必要です。返された値は GitHub Actions のシークレットなどのシークレットマネージャーに直接移し、ソース管理やログには貼り付けないでください。

Webhook URL は、インターネットから到達可能な HTTPS エンドポイントである必要があります。URL 内の認証情報や、明らかなループバック、プライベートネットワーク、リンクローカル、ローカルホスト名の宛先は検証時に拒否されます。

add-mcp でインストール（推奨）

add-mcp を使うと、1 つのコマンドで 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 docs を参照してください。

手動で設定する

以下を 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（v20+）
• NPM または Yarn
• Linear の個人用 API キーまたは OAuth アクセストークン

# Install globally
npm install -g @tacticlaunch/mcp-linear

# Or clone and install locally
git clone https://github.com/tacticlaunch/mcp-linear.git
cd mcp-linear
npm install
npm link  # Makes the package available globally

サーバーの実行

Linear API トークンを使ってサーバーを実行します：

mcp-linear --token YOUR_LINEAR_API_TOKEN

または、管理用 OAuth アプリケーションのアクセストークンを使います：

mcp-linear --oauth-token YOUR_OAUTH_ACCESS_TOKEN

または、環境にトークンを設定し、引数なしで実行します：

export LINEAR_API_TOKEN=YOUR_LINEAR_API_TOKEN
mcp-linear

検証

デフォルトの検証方法は次のとおりです：

npm test
npm run build

npm test は Jest の単体テストと、ビルド済みの stdio サーバーに対する公式 MCP SDK のスモークテストを実行し、ツール、リソース、プロンプトの登録に加えて、ホスト互換のスキーマ出力を検証します。

開発

ローカル開発の詳細については、DEVELOPMENT.md を参照してください。

リンク

tacticlaunch/cursor-memory-bank — Cursor を使ってワークフローを強化したい開発者の方は、ぜひお試しください。

ライセンス

このプロジェクトは MIT ライセンスの下でライセンスされています。詳細については、LICENSE ファイルを参照してください。