MCPリニアアプリ
AIツールとしてLinearと統合するためのモデルコンテキストプロトコル(MCP)。このツールにより、AIはモデルコンテキストプロトコルを介してLinearと対話できるようになります。
特徴
完全な線形積分:
検索の問題
新しい問題を作成する
アップデートの問題
コメントを追加する
コメントを更新
ユーザープロファイルを取得する
チーム情報を取得する
Related MCP server: Linear MCP Server
前提条件
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. 初期設定
このリポジトリをクローンします:
依存関係をインストールします:
ルート ディレクトリに
.envファイルを作成します。
プロジェクトをビルドします。
これで、
distフォルダーをさまざまな AI プラットフォームでの構成に使用できるようになりました。
2. カーソルの設定
カーソル MCP 構成ファイルを見つけます。
Windows:
C:\Users\<username>\.cursor\mcp.jsonmacOS:
~/.cursor/mcp.jsonLinux:
~/.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キー
構成例:
変更を有効にするには、ファイルを保存して Cursor を再起動します。
3. クロード構成
ClaudeでMCP Linear Toolsを使用するには、Claudeの設定ファイルに設定を追加する必要があります。以下の手順に従ってください。
Claude AIデスクトップアプリの設定を開く
「開発者」セクションに移動します
「ツール」設定セクションを探します
次のようにして Linear MCP の構成を追加します。
プレースホルダーを置き換えます:
<path-to-node>: Node.js実行ファイルへのパス<path-to-project>: MCP Linear App プロジェクト ディレクトリへの絶対パスyour_linear_api_key_here: Linear APIキー
構成例:
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 関連のタスクを実行するよう依頼するだけで済みます。
ワークフローの例: 問題の作成と管理
これらのツールの使用方法を示すワークフローの例を次に示します。
チーム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-321Claude は
get_commentツールを使用してコメントを取得します。
これらの例は、ツールが適切に構成されると、AI アシスタントを介して Linear といかに自然に対話できるかを示しています。
最近の更新
このプロジェクトは最近、ドキュメントと線形ツールの機能が改善され、強化されました。主な改善点は以下のとおりです。
インストールと設定の手順をより明確にしたREADMEを更新しました
さまざまな AI プラットフォームの例を含む強化されたドキュメント
エラー処理と応答フォーマットが改善された線形ツールの改善
コメントの管理(作成、取得、更新、削除)のサポートを追加しました
ステータスと優先度によるフィルタリングによる検索機能の向上
ライセンス
このプロジェクトは MIT ライセンスに基づいてライセンスされています。