Linear MCP Server

Linear MCP サーバー

重要なお知らせ： この MCP サーバーは非推奨となり、メンテナンスは終了しています。こちらの公式 Linear リモート MCP サーバーのご利用をおすすめします：https://linear.app/changelog/2025-05-01-mcp (https://mcp.linear.app/sse)

Linear API 用の Model Context Protocol サーバーです。

このサーバーは MCP を通じて Linear の課題追跡システムと連携し、LLM が Linear の課題を操作できるようにします。

インストール

自動インストール

Smithery 経由で Claude Desktop 用の Linear MCP サーバーを自動的にインストールするには：

npx @smithery/cli install linear-mcp-server --client claude

手動インストール

1. チーム用の Linear API キーを作成するか、取得します：https://linear.app/YOUR-TEAM/settings/api

2. Claude Desktop にサーバー設定を追加します：

   • MacOS：~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": [
        "-y",
        "linear-mcp-server"
      ],
      "env": {
        "LINEAR_API_KEY": "your_linear_api_key_here"
      }
    }
  }
}

コンポーネント

ツール

1. linear_create_issue：Linear の新しい課題を作成します

   • 必須入力：
     • title (string)：課題のタイトル
     • teamId (string)：課題を作成するチームの ID
   • 任意入力：
     • description (string)：課題の説明（Markdown に対応）
     • priority (number, 0-4)：優先度（1＝緊急、4＝低）
     • status (string)：初期ステータス名

2. linear_update_issue：既存の課題を更新します

   • 必須入力：
     • id (string)：更新する課題の ID
   • 任意入力：
     • title (string)：新しいタイトル
     • description (string)：新しい説明
     • priority (number, 0-4)：新しい優先度
     • status (string)：新しいステータス名

3. linear_search_issues：柔軟なフィルタリング条件で課題を検索します

   • 任意入力：
     • query (string)：タイトル／説明内で検索するテキスト
     • teamId (string)：チームで絞り込み
     • status (string)：ステータスで絞り込み
     • assigneeId (string)：担当者で絞り込み
     • labels (string[])：ラベルで絞り込み
     • priority (number)：優先度で絞り込み
     • limit (number, default: 10)：結果の最大件数

4. linear_get_user_issues：ユーザーに割り当てられた課題を取得します

   • 任意入力：
     • userId (string)：ユーザー ID（認証済みユーザーの場合は省略）
     • includeArchived (boolean)：アーカイブ済みの課題を含める
     • limit (number, default: 50)：結果の最大件数

5. linear_add_comment：課題にコメントを追加します

   • 必須入力：
     • issueId (string)：コメントを追加する課題の ID
     • body (string)：コメント本文（Markdown に対応）
   • 任意入力：
     • createAsUser (string)：カスタムユーザー名
     • displayIconUrl (string)：カスタムアバターの URL

リソース

• linear-issue:///{issueId} - 個別の課題の詳細を表示
• linear-team:///{teamId}/issues - チームの課題を表示
• linear-user:///{userId}/assigned - ユーザーに割り当てられた課題を表示
• linear-organization: - 組織情報を表示
• linear-viewer: - 現在のユーザーのコンテキストを表示

使用例

Linear と連携する際に Claude Desktop で使用できるプロンプトの例をいくつか紹介します。

1. 「優先度が高いすべての課題を表示して」→ search_issues ツールおよび／または linear-user:///{userId}/assigned を実行して、優先度 1 の、自分に割り当てられた課題を検索します

2. 「このバグについてこれまでに伝えた内容に基づいて、認証システムのバグ報告を作成して」→ create_issue を使用して、適切な詳細とステータスの追跡情報を含む、優先度の高い新しい課題を作成します

3. 「進行中のフロントエンドのタスクをすべて探して」→ search_issues を使用して、進行中のタスクのうちフロントエンド関連の課題を検索します

4. 「モバイルアプリ開発の課題に関する最近の更新を要約して」→ search_issues で関連する課題を特定し、次に linear-issue:///{issueId} で課題の詳細を取得して、最近のアクティビティとコメントを表示します

5. 「モバイルチームの現在の作業負荷は？」→ linear-team:///{teamId}/issues と search_issues を組み合わせて、モバイルチーム全体の課題の分布と優先度を分析します

開発

1. 依存関係をインストールします：

npm install

1. .env で Linear API キーを設定します：

LINEAR_API_KEY=your_api_key_here

1. サーバーをビルドします：

npm run build

自動再ビルドを有効にして開発する場合：

npm run watch

ライセンス

この MCP サーバーは MIT ライセンスの下でライセンスされています。これは、MIT ライセンスの利用規約に従うことを条件に、ソフトウェアを自由に使用、変更、配布できることを意味します。詳細については、プロジェクトリポジトリの LICENSE ファイルをご覧ください。