local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Provides comprehensive Linear project management integration, enabling searching, creating, and updating issues, adding and managing comments, retrieving user profiles, and accessing team information through Linear's API.

MCPリニアアプリ

AIツールとしてLinearと統合するためのモデルコンテキストプロトコル（MCP）。このツールにより、AIはモデルコンテキストプロトコルを介してLinearと対話できるようになります。

特徴

完全な線形積分:
- 検索の問題
- 新しい問題を作成する
- アップデートの問題
- コメントを追加する
- コメントを更新
- ユーザープロファイルを取得する
- チーム情報を取得する

前提条件

Node.js 18以降
リニアAPIキー

リニアAPIキーを取得する方法

このアプリケーションを使用するには、Linear APIキーが必要です。取得手順は以下のとおりです。

ログインまたはLinearアカウントを作成
- Linearにアクセスして既存のアカウントにログインするか、登録して新しいアカウントを作成してください。
ワークスペース設定にアクセスする
- メインページから、左上隅のユーザー名をクリックします
- 「ワークスペース設定」オプションを選択します
API設定を開く
- 左側の「設定」列で、「API」が見つかるまで下にスクロールします。
- 「API」オプションをクリックします
新しいAPIキーを作成する
- API キーのラベルを入力します（例:「MCP Linear App」）
- 「新しいAPIキーを作成」ボタンをクリックします
APIキーを安全に保存する
- APIキーは一度だけ表示されます
- コピーして安全な場所に保存してください。Linearでは再度表示されません。

重要事項：Linearでは、APIキーに対して1時間あたり1,500リクエストのレート制限があります。429 Too Many Requestsエラーを回避するため、アプリケーションがこの制限を遵守していることを確認してください。

Linear API キーの取得と使用に関する詳細については、 Merge.dev のこのガイドをご覧ください。

ツールの使い方

1. 初期設定

このリポジトリをクローンします:

git clone git@github.com:zalab-inc/mcp-linear-app.git
cd mcp-linear-app

依存関係をインストールします:

npm install

ルートディレクトリに.envファイルを作成します。

LINEAR_API_KEY=your_linear_api_key_here

プロジェクトをビルドします。

npm run build

これで、 distフォルダーをさまざまな AI プラットフォームでの構成に使用できるようになりました。

2. カーソルの設定

カーソル MCP 構成ファイルを見つけます。
- Windows: C:\Users\<username>\.cursor\mcp.json
- macOS: ~/.cursor/mcp.json
- Linux: ~/.cursor/mcp.json
ファイルを編集して、Linear MCP サーバー構成を追加します。
{ "mcpServers": { "linear": { "command": "<path-to-node>", "args": [ "<path-to-project>/dist/index.js" ], "env": { "LINEAR_API_KEY": "your_linear_api_key_here" } } } }
プレースホルダーを置き換えます:
- <path-to-node> : Node.js実行ファイルへのパス
- <path-to-project> : MCP Linear App プロジェクトディレクトリへの絶対パス
- your_linear_api_key_here : Linear APIキー

構成例:

{
  "mcpServers": {
    "linear": {
      "command": "C:\\nvm4w\\nodejs\\node.exe",
      "args": [
        "H:\\mcp\\linear\\dist\\index.js"
      ],
      "env": {
        "LINEAR_API_KEY": "lin_api_xxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

変更を有効にするには、ファイルを保存して Cursor を再起動します。

3. クロード構成

ClaudeでMCP Linear Toolsを使用するには、Claudeの設定ファイルに設定を追加する必要があります。以下の手順に従ってください。

Claude AIデスクトップアプリの設定を開く
「開発者」セクションに移動します
「ツール」設定セクションを探します
次のようにして Linear MCP の構成を追加します。

{
  "tools": {
    "linear": {
      "command": "<path-to-node>",
      "args": [
        "<path-to-project>/dist/index.js"
      ],
      "env": {
        "LINEAR_API_KEY": "your_linear_api_key_here"
      }
    }
  }
}

プレースホルダーを置き換えます:
- <path-to-node> : Node.js実行ファイルへのパス
- <path-to-project> : MCP Linear App プロジェクトディレクトリへの絶対パス
- your_linear_api_key_here : Linear APIキー

構成例:

{
  "tools": {
    "linear": {
      "command": "/usr/local/bin/node",
      "args": [
        "/Users/username/projects/mcp-linear-app/dist/index.js"
      ],
      "env": {
        "LINEAR_API_KEY": "lin_api_xxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

4. 他のプラットフォームでの設定

基本的な原理は、MCP をサポートする他の AI プラットフォームでも同じです。

外部ツールまたはMCPの設定領域を見つける
このリポジトリのdist/index.jsファイルを使用してNode.jsを実行するように設定します
環境設定にLINEAR_API_KEYを含める

利用可能なツール

設定後、AI は次の線形ツールにアクセスできるようになります。

search_issues - キーワード、ステータス、優先度で問題を検索します
create_issue - 新しい問題を作成する
get_issue - 問題の詳細を取得する
update_issue - 既存の問題を更新する
create_comment - 問題にコメントを追加する
get_comment - 問題からコメントを取得する
update_comment - コメントを更新または削除する
get_profile - 現在のLinearユーザープロファイルを取得します
get_team_id - チームとそのIDのリストを取得する

サポートとヘルプ

このツールの使用中に問題が発生した場合は、次の手順に従ってください。

リニアAPIキーが有効であり、十分な権限があることを確認してください
Node.jsが正しくインストールされていることを確認してください
AIプラットフォームのMCP構成を確認する
ログファイルでエラーメッセージを確認してください

AI環境における線形ツールの使用

AI環境で線形ツールを設定したら、AIに指示を出すことで使用を開始できます。以下に例をいくつか示します。

カーソルでの線形ツールの使用

Cursor では、Claude に Linear 関連のタスクを実行するよう依頼するだけで済みます。

Search for high priority issues in our Linear project.

Create a new issue in Linear with the title "Improve login page performance" and add it to the backlog.

Get the details of the issue LIN-123 from Linear.

Add a comment to issue LIN-456 saying "This is fixed in the latest release. Please verify."

Update the priority of issue LIN-789 to urgent.

ワークフローの例: 問題の作成と管理

これらのツールの使用方法を示すワークフローの例を次に示します。

チームIDを見つける:
What's my Linear team ID?
Claude はget_team_idツールを使用してチーム情報を取得します。
新しい問題の作成:
Create a new Linear issue titled "Implement password reset feature" for the Engineering team with a high priority. The description should be "Users need a way to reset their passwords when they forget them."
Claude は必要なパラメータを指定してcreate_issueツールを使用します。
問題を検索中:
Find all high priority issues assigned to me that are currently in progress.
Claude は適切なフィルターを備えたsearch_issuesツールを使用します。
問題の更新:
Update issue LIN-456 to add the description "This issue has been verified and tested on all browsers."
Claude はupdate_issueツールを使用して問題を修正します。
コメントを追加:
Add a comment to issue LIN-789 asking "Is this still a priority for this sprint?"
Claude はcreate_commentツールを使用してコメントを追加します。
コメントを取得しています:
Show me all the comments on issue LIN-321
Claude はget_commentツールを使用してコメントを取得します。

これらの例は、ツールが適切に構成されると、AI アシスタントを介して Linear といかに自然に対話できるかを示しています。

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています。

https://kelasinovatif.com/

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

AI アシスタントがモデルコンテキストプロトコルを介して Linear のプロジェクト管理ツールと対話できるようにし、問題の検索、作成、更新、コメントの追加、ユーザープロファイルとチーム情報の取得などの機能をサポートするサーバー。

MCP Linear App