リニアMCP統合サーバー
このサーバーは、モデルコンテキストプロトコル（MCP）を介してLinearとの統合機能を提供します。これにより、AIモデルはLinearと連携して問題追跡やプロジェクト管理を行うことができます。
特徴
サーバーは、MCP インターフェイスを通じて次のツールを提供します。
線形作成問題
次のパラメータを使用して新しい線形問題を作成します。
title（必須）: 問題のタイトルteamId(必須): 問題を作成するチームIDdescription（オプション）: 問題の説明（マークダウン対応）priority（オプション）：優先度（0～4）status（オプション）: 初期ステータス名
線形探索の問題
柔軟なフィルタリングで線形問題を検索:
query（オプション）: タイトル/説明で検索するテキストteamId(オプション): チームでフィルタリングstatus（オプション）: ステータスでフィルタリングassigneeId(オプション): 担当者によるフィルタリングpriority（オプション）：優先度（0～4）limit（オプション、デフォルト：10）：返される結果の最大数
リニアスプリントの問題
現在のスプリント/イテレーション内のすべての問題を取得します。
teamId(必須): スプリントの問題を取得するチームID
線形探索チーム
リニア チームの検索と取得:
query（オプション）: チーム名で検索するテキスト
リニアフィルタースプリント問題
現在のスプリントの問題をステータス別にフィルタリングし、現在のユーザーに自動的にフィルタリングします。
teamId(必須): スプリントの問題を取得するチームIDstatus(必須): フィルタリングするステータス (例: 「製品リリース保留中」)
linear_get_workflow_states
チームで利用可能なすべてのワークフロー状態 (ステータス) を取得します。
teamId(必須): ワークフローの状態を取得するためのチームID
線形リストプロジェクト
利用可能なすべてのプロジェクトとその ID のリストを取得します。
teamId(オプション): チーム別にプロジェクトをフィルタリングするためのチームIDlimit（オプション、デフォルト：50）：返されるプロジェクトの最大数
Related MCP server: Linear MCP Server
開発者向けセットアップ
Linearの設定 > APIセクションからLinear APIキーを取得します。
環境の例をコピーする :
cp .env.example .envAPI Linear を変更して le fichier
.envet ajoutez votre clé API を変更します。LINEAR_API_KEY=votre_clé_api_linear_ici依存関係をインストールします:
npm installサーバーを起動します。
# Development mode with auto-reload npm run dev # Production mode npm start # Build TypeScript npm run build # Run linter npm run lint # Run tests npm run test # Inspect MCP server npm run inspect
GitHub からプロジェクトをクローンした場合の Docker セットアップ
このアプリケーションは Docker を使用して実行することもできます。
システムにDockerとDocker Composeがインストールされていることを確認してください
上記のように、Linear APIキーを使用して
.envファイルを作成します。コンテナをビルドして起動します。
# Build and start the container in detached mode docker-compose up -d # View logs docker-compose logs -f # Stop the container docker-compose downサーバーはコンテナ内で実行され、明示的に停止されない限り自動的に再起動します。
Docker の使用 (docker-compose を使用した簡略化された方法)
Linear API キーを使用して
.envファイルを作成します。LINEAR_API_KEY=your_linear_api_key_heredocker-compose.ymlファイルを作成します。version: '3.8' services: mcp-linear-server: image: madebynando/mcp-linear-server:latest container_name: mcp-linear-server restart: unless-stopped env_file: - .env volumes: - ./logs:/app/logsコンテナを起動します。
docker-compose up -dカーソルを設定するには、次を使用します。
トランスポートタイプ: コマンド
コマンド: docker exec -i mcp-linear-server node dist/server.js
Docker開発
Docker を使用した開発の場合:
技術的な詳細
TypeScriptとモデルコンテキストプロトコルSDKを使用して構築
APIインタラクションにはLinear SDKを使用する
エラー処理、レート制限、接続管理が含まれます
設定可能な再試行回数による自動再接続をサポート
接続の健全性を監視するハートビート監視を実装
デバッグモードで詳細なログを提供します
エラー処理
サーバーには包括的なエラー処理が含まれています。
APIタイムアウト保護
接続が失われた場合の自動再接続試行
タイムスタンプ付きの詳細なエラーログ
正常なシャットダウン処理
接続の健全性を監視するハートビート監視
依存関係
@linear/sdk: リニア API クライアント@modelcontextprotocol/sdk: MCP サーバーの実装zod: 実行時の型チェックと検証dotenv: 環境変数の管理TypeScriptおよび関連開発ツール
依存関係の完全なリストについては、 package.json参照してください。
カーソルでの使用
このサーバーを Cursor で使用するには、MCP サーバーとして追加できます。
Dockerなし
警告： CursorでMCPサーバーを追加する際は、コマンドに
LINEAR_API_KEY直接設定してください。これは、サーバーがLinear APIを正しく認証し、操作するために不可欠です。設定しないと認証エラーが発生し、サーバーは期待どおりに動作しなくなります。例：
env LINEAR_API_KEY=your_linear_api_key node /path/to/your/mcp-linear-server/dist/server.js
カーソル設定メニューを開く
「MCPサーバー」セクションへ移動
「MCPサーバーを追加」をクリックします
次の詳細を入力してください。
名前: linear-mcp-server
トランスポートタイプ: コマンド
コマンド: env LINEAR_API_KEY=your_linear_api_key node /path/to/your/mcp-linear-server/dist/server.js
「保存」をクリック
これで、カーソルのツール リストに線形ツールが表示されるようになります。
Dockerを使用
カーソル設定メニューを開く
「MCPサーバー」セクションへ移動
「MCPサーバーを追加」をクリックします
次の詳細を入力してください。
名前: linear-mcp-server
トランスポートタイプ: コマンド
コマンド: docker exec -i mcp-linear-server node dist/server.js
「保存」をクリック
これで、カーソルのツール リストに線形ツールが表示されるようになります。
クロードに指導する
Claude にこの MCP サーバーを使用するように指示する場合は、次のエンドポイントを参照できます。
タイトル、説明、チーム ID、優先度、ステータスを指定して新しい Linear 問題を作成します。
クエリ、チーム、ステータス、担当者、優先度、制限による柔軟なフィルタリングを使用して、線形の問題を検索します。
特定のチームの現在のスプリント/イテレーション内のすべての問題を取得します。
名前でリニア チームを検索して取得します。
特定のチームの現在のスプリントの問題をステータス別にフィルタリングします。
特定のチームの利用可能なすべてのワークフロー状態 (ステータス) を取得します。
利用可能なすべてのプロジェクトのリストを ID 付きで取得します。オプションでチーム別にフィルタリングすることもできます。