Linear MCP: AIネイティブなプロジェクト管理連携

あなたのAIエージェントはすでにコードを書き、メールをトリアージし、インフラストラクチャを管理しています。しかしプロジェクト管理となると、彼らは盲目です — バックログを見ることも、課題を作成することも、手動のコピペなしではプロジェクトステータスを更新することもできません。

Linear MCPがこれを解決します。 任意のMCP互換AIエージェントに、Linearワークスペースへの完全かつ構造化されたアクセスを提供します。

何ができるか

Linear MCPはModel Context Protocolを通じてLinearのプロジェクト管理画面全体を公開します。AIエージェントは以下を実行できます:

コアワーク管理

• 課題 — 作成 (単一またはバッチ)、更新、検索、削除、親子階層の管理、課題リレーションの作成
• プロジェクト — 作成、更新、削除、検索、課題付き作成、イニシアチブへの関連付け
• コメント — スレッド返信の作成、更新、削除、スレッドのresolve/unresolve
• マイルストーン — 完全なCRUDに加え一括作成と検索

ワークフローと検索

• チーム、ユーザー、ワークフロー状態、ラベル、サイクル
• オプションフィルタ付きのフリーテキスト検索 (チーム、プロジェクト、担当者、状態、優先度、サイクル)
• 正確な課題識別子の解決 (例: ENG-431)、ランク付けされた検索へのフォールバック付き

連携と高度な画面

• 添付ファイル、Webhooks、ポートフォリオエンティティ (イニシアチブ、顧客)
• エージェントセッションとエージェントアクティビティ
• ランタイムの機能検出とライブ診断

アーキテクチャ

AI Agent (Claude / Codex / OpenClaw / Cline)
  -> MCP transport (stdio or HTTP)
    -> Linear MCP server
      -> Linear GraphQL API

Linear MCPはハンドラディスパッチの前にランタイムでツールスキーマを強制します。不正なペイロードはLinear APIの深部ではなく、MCP境界で構造化された検証エラーとして失敗します。

ガードされたコントラクト — 重要な課題ワークフロー (単一作成、バッチ作成、検索) はSDKミューテーションではなく監査付きの生GraphQL操作を使用し、SDKのリグレッションがエージェントに到達するのを防ぎます。npm run verify:linear-api-contracts を実行してローカルで監査できます。

構造化テレメトリ — すべてのツールリクエストはツール名、トランスポート、所要時間、サニタイズされた失敗メタデータを含むstderrテレメトリを送出し、トラブルシューティングに役立てます。

認証

APIキー (最もシンプル):

LINEAR_API_KEY=your_personal_access_token

OAuth (共有またはリモートデプロイ向け):

1. clientId、clientSecret、redirectUri を指定して linear_auth を呼び出す
2. 返された認証URLを開く
3. code と state を指定して linear_auth_callback を呼び出す

ストリームモードでは、各MCPセッションが独自の分離された認証コンテキストを持ちます。

クイックスタート

# Install from npm
npx @kkaminsk/linear-mcp

# Or clone and build
git clone https://github.com/kkaminsk/linear-mcp.git
cd linear-mcp && npm install && npm run build

# Run with API key
LINEAR_API_KEY=your_key npm start

MCPクライアント設定:

{
  "mcpServers": {
    "linear": {
      "command": "node",
      "args": ["/path/to/linear-mcp/build/index.js"],
      "env": {
        "LINEAR_API_KEY": "your_personal_access_token"
      }
    }
  }
}

対象者

• 開発チーム — ワークフローの一部として課題をトリアージ、作成、更新できるAIエージェント
• エンジニアリングマネージャー — 自動化されたプロジェクトステータス更新、マイルストーン追跡、バックログの手入れ
• DevOpsおよびSREチーム — インシデントを作成し、課題をリンクし、解決を追跡するAIエージェント
• AIエージェントビルダー — プロジェクト管理への構造化されたアクセスを必要とする任意のMCPクライアント

GitHub: github.com/kkaminsk/linear-mcp

npm: @kkaminsk/linear-mcp