Linear MCP の概要
Linear の MCP ドキュメント、changelog、API ドキュメントの情報で、2026年11月17日に確認しました。サーバーは Linear が作っていて、Claude の Connectors Directory に Anthropic 検証済みとして掲載されています。
| Linear MCP サーバー | |
|---|---|
| エンドポイント(読み取りと書き込み) | https://mcp.linear.app/mcp |
| 読み取り専用のエンドポイント | https://mcp.linear.app/mcp/readonly。「読み取りツールしか公開しない」もので、2026年11月5日から MCP レジストリに掲載 |
| トランスポート | Streamable HTTP。リモート MCP に対応していないクライアントは、npm モジュールの mcp-remote を通して接続する |
| 認証 | 動的クライアント登録つきの OAuth 2.1(PKCE は S256 のみ)、または Authorization: Bearer <yourtoken> ヘッダーに入れる OAuth トークンか Linear API キー。Enterprise では Okta によるエンタープライズ管理の認証、Business と Enterprise では Claude の自動接続(ベータ) |
| 古い SSE エンドポイント | https://mcp.linear.app/sse は非推奨。Linear は 2026年2月5日に「SSE のサポートを完全に廃止する」と発表していて、2026年11月17日には認証なしのリクエストに 404 が返りました。新しい設定はすべて /mcp を使います |
| Linear のプラン | Linear の MCP のページにサーバーのプラン要件の記載はありません。料金ページでは連携の 1 つに「MCP server」が挙がっていて、API はすべてのプランで使えます |
| レート制限 | Linear は MCP の制限を示していません。API 全般の制限は、API キーを使うと 1 ユーザーあたり 1 時間 2,500 リクエスト、認証なしだと 1 IP あたり 1 時間 600 リクエストで、OAuth のトークンリクエストにも制限があります(Retry-After つきの 429) |
| 公開 | 2025年5月1日 |
AI クライアントを Linear の MCP サーバーにつなぐ
クライアントごとに 1 ステップです。お使いのものを選んでください。スニペットは Linear のドキュメントや連携ページから、内容が違うところはクライアント自身のドキュメントから、そのままコピーしています。読み取り専用にしたいときは、スニペットの https://mcp.linear.app/mcp を https://mcp.linear.app/mcp/readonly に置き換えます。
Claude Code
ターミナルでコマンドを実行し、Claude Code のセッションで
/mcpを実行して Linear のサインインを済ませます。--scope userを付けるとすべてのプロジェクトで Linear を使え、--scope projectを付けると.mcp.jsonでチームと共有できます。サインインを省くには、--header "Authorization: Bearer your-token"でトークンを渡します。claude.ai で接続した Linear は、claude.ai のサブスクリプションでサインインしていれば Claude Code にも表示され、公式プラグインlinear@claude-plugins-officialも同じエンドポイントを使います。詳しくは Claude Code + Linear をご覧ください。# Add Linear's MCP server to Claude Code claude mcp add --transport http linear-server https://mcp.linear.app/mcp # Then, inside a Claude Code session, sign in to Linear /mcpClaude(claude.ai、デスクトップ、モバイル)
Linear のコネクタは Claude の Connectors Directory にあります。下は Anthropic の手順です。Linear のドキュメントはプランで分けていて(Team と Enterprise は claude.ai、Free と Pro は Claude デスクトップの「設定」>「Connectors」)、一方 Claude 自身のドキュメントでは、コネクタはどのプランでも、Web、デスクトップ、モバイルで使えるとしています。Team と Enterprise では、管理者が自動接続(ベータ)を設定すると、メールアドレスが一致するメンバーは Linear のサインインを省けます。
Customize > Connectors > Discover > search "Linear" > Connect to Claude In a chat: + > Connectors > turn Linear onCursor
Linear のドキュメントでは、Cursor のディープリンク(設定は
{"url":"https://mcp.linear.app/mcp"})か、Cursor の MCP ツールのページで Linear を検索してインストールします。ワンクリックの OAuth インストールは Cursor 1.0 で加わりました。Linear の Cursor のページには、mcp-remoteを使う手動の設定もあります。Cursor 自身のドキュメントでは、リモートサーバーをurlフィールドつきで~/.cursor/mcp.json(グローバル)か.cursor/mcp.json(プロジェクト)に置きます。詳しくは Cursor + Linear をご覧ください。# One-click install (opens Cursor) cursor://anysphere.cursor-deeplink/mcp/install?name=Linear&config=eyJ1cmwiOiJodHRwczovL21jcC5saW5lYXIuYXBwL21jcCJ9 # Manual: CTRL/CMD Shift J → MCP → Add new global MCP server {"mcpServers": {"linear": {"command": "npx", "args": ["-y", "mcp-remote", "https://mcp.linear.app/mcp"]}}}VS Code
Linear が案内しているのはこの方法です。
mcp-remoteを実行する stdio サーバーを追加して **Linear** という名前を付け、**MCP: List Servers** → Linear → **Start Server** と進みます。VS Code 自身のドキュメントでは、リモートサーバーを直接追加します。**MCP: Add Server** → **HTTP (HTTP or Server-Sent Events)** → エンドポイントを入力 → Global かワークスペースの.mcp.jsonを選びます。Global のサーバーは Copilot CLI と共有されます。詳しくは GitHub Copilot + Linear をご覧ください。# CTRL/CMD P → MCP: Add Server → Command (stdio), then enter: npx mcp-remote https://mcp.linear.app/mcp # Or, as JSON (Linear's docs): {"mcpServers": {"linear": {"command": "npx", "args": ["-y", "mcp-remote", "https://mcp.linear.app/mcp"]}}}Codex(CLI と IDE 拡張機能)
codex mcp addを実行するとログインを求められます。機能フラグについては、公式ページの内容が食い違っています。Linear のドキュメントは~/.codex/config.tomlの[features]にexperimental_use_rmcp_client = trueを足すとしていて、Linear の Codex のページはrmcp_client = true、OpenAI の最新の MCP ドキュメントはフラグなしです。下のスニペットは OpenAI の形式です。お使いの Codex のバージョンがフラグを求めるときは、両方のページを確認してください。この設定は Codex CLI、IDE 拡張機能、ChatGPT デスクトップアプリで共通です。Linear によると、サーバーを使えるのはローカルの Codex タスク(CLI か IDE 拡張機能)だけです。詳しくは Codex + Linear をご覧ください。# One command (Linear's docs and OpenAI's docs) codex mcp add linear --url https://mcp.linear.app/mcp # Or by hand in ~/.codex/config.toml (OpenAI's docs) [mcp_servers.linear] url = "https://mcp.linear.app/mcp" # then sign in (add --no-browser on a headless machine) codex mcp login linearWindsurf
Linear の Windsurf のページでは、Cascade のプラグインのアイコンを選んでそこから Linear MCP サーバーをインストールするか、下のように手動で追加します。Windsurf の MCP ドキュメントの URL は、現在 Devin Local のドキュメントにリダイレクトされます。そちらではサーバーを
~/.config/devin/mcp_config.jsonか.devin/mcp_config.jsonに置き、OAuth つきの Streamable HTTP に対応しているので、メニューが Linear の説明と違って見えることがあります。# CTRL/CMD , → Cascade → MCP servers → Add Server → Add custom server {"mcpServers": {"linear": {"command": "npx", "args": ["-y", "mcp-remote", "https://mcp.linear.app/mcp"]}}}Zed
Linear は 2 つの形式を載せています。ドキュメントのページは 1 つ目、Zed の連携ページは 2 つ目です。Zed 自身のドキュメントも、URL を指定したリモートサーバー(Settings → AI → MCP Servers → Add Remote Server)と MCP の OAuth フローに対応していますが、Linear はその形式を載せておらず、Zed のドキュメントには
"source": "custom"の記載もありません。まずドキュメントのページの形式を試し、お使いのバージョンが受け付けないときは Zed の MCP ドキュメントを確認してください。// Linear's docs: CMD , then add to settings {"context_servers": {"linear": {"source": "custom", "command": "npx", "args": ["-y", "mcp-remote", "https://mcp.linear.app/mcp"], "env": {}}}} // Linear's Zed integration page shows an older shape: {"context_servers": {"linear": {"command": {"path": "npx", "args": ["-y", "mcp-remote", "https://mcp.linear.app/mcp"], "env": {}}, "settings": {}}}}ChatGPT(Deep Research コネクタ)
Linear の ChatGPT のページが扱うのは Deep Research のコネクタだけです。ChatGPT のコネクタ設定で Linear を接続し、Deep Research で Linear をソースに追加します。Plus と Pro(EEA、スイス、英国を除く)、そして Team、Enterprise、Edu のユーザーが対象です。ChatGPT のデベロッパーモードで Linear の MCP URL を追加する方法は、Linear のドキュメントにありません。OpenAI は Linear を ChatGPT のプラグインとして掲載していて、ChatGPT デスクトップアプリは上の Codex の設定を通して MCP サーバーを使います。詳しくは ChatGPT + Linear をご覧ください。
ChatGPT connector settings > connect Linear Deep research > add Linear as a sourceそのほか:mcp-remote を使う
ローカルの MCP コマンドは実行できるが、リモート MCP には対応していないクライアントには、Linear が次の値を案内しています。Linear は fx(
/mcp add linear https://mcp.linear.app/mcpのあと/mcp login linear)と、v0 by Vercel(MCP 接続のページからインストール)も載せています。Command: npx Arguments: -y mcp-remote https://mcp.linear.app/mcp Environment: None
できること
Linear のドキュメントはツールを「issue、プロジェクト、コメントなど Linear のオブジェクトの検索、作成、更新」と説明していますが、名前は挙げていません。以下の名前は、Anthropic のコネクタディレクトリ(22 ツール)と Linear の changelog によるものです。ディレクトリの一覧は 2026年2月の Linear の追加より前のものなので、お使いのクライアントにはもっと表示されるかもしれません。
- issue:
list_issues、list_my_issues、get_issue、create_issue、update_issue、list_issue_statuses、get_issue_status、list_issue_labels。2026年11月5日から、list_issuesはcompletedAt(ISO-8601 の日付、または-P7Dのような期間)で完了日を絞り込めます。例:「Backend チームの未完了の Linear issue を一覧にして」「このバグの issue を作って、私に割り当てて」 - コメント:
list_comments、create_comment。例:「ENG-123 のコメントを要約して、修正内容をコメントに追加して」 - プロジェクト:
list_projects、get_project、create_project、update_project。例:「請求システム刷新のプロジェクトを作って、この 3 つの issue を入れて」 - チーム、ユーザー、サイクル:
list_teams、get_team(2026年9月14日から、各チームの公開範囲とretiredAtも返す)、list_users、get_user、list_cycles。2026年10月22日から、名前の一部で担当者を指定できます。例:「今のサイクルで担当者のいない issue はどれ?」 - ドキュメントとヘルプ:
list_documents、get_document、search_documentation(Linear 自身のドキュメント)。例:「Linear でオンボーディングの仕様を見つけて要約して」 - 顧客:
list_customer_needs(2026年10月8日から)は、issue、プロジェクト、イニシアチブに対する顧客の要望を返します。顧客は 2026年10月22日から、ドメインと外部 ID でも検索できます。例:「SSO を求めたのはどの顧客?」 - プロダクト管理(2026年2月5日から):イニシアチブ、イニシアチブの更新、プロジェクトのマイルストーン、プロジェクトの更新の作成と編集、プロジェクトのラベルの管理、画像の読み込み、URL からの Linear リソースの読み込み。例:「クローズした issue から、Mobile v2 の今週のプロジェクト更新を書いて」
- 2026年11月5日から、サーバーはツールの使い方に関する既定の指示をクライアントに送ります。
読み取り専用のアクセス
Linear は、AI クライアントに何も変更させない方法を 3 つ紹介しています。
- 読み取り専用のエンドポイント
https://mcp.linear.app/mcp/readonlyを使います。読み取りツールしか公開しません。 https://mcp.linear.app/mcpを使い、OAuth のスコープはreadだけを許可します。トークンは書き込み API に届きません。Authorization: Bearerヘッダーに、Read 権限だけの Linear API キーを渡します。
トラブルシューティング
- 接続に失敗する、何度か試す必要がある:Linear は、リモート MCP の接続は「まだ初期段階」だとしています。クライアントを再起動するか、MCP の設定で Linear のサーバーをいったんオフにして、またオンにします。切断して再接続しても、Linear のデータやサインインには影響しません。
- 接続時に内部サーバーエラーが出る:
rm -rf ~/.mcp-authを実行して、再接続します。Node のバージョンを上げる必要があるかもしれません。 - ワークスペースが違う:再接続しても、既存のサインインの中ではワークスペースが切り替わりません。ワークスペースごとに別の認証フォルダーを使います。例:
MCP_REMOTE_CONFIG_DIR=~/.mcp-auth/workspace-a npx mcp-remote https://mcp.linear.app/mcpとMCP_REMOTE_CONFIG_DIR=~/.mcp-auth/workspace-b npx mcp-remote https://mcp.linear.app/mcp。 /sseの古い設定:URL をhttps://mcp.linear.app/mcpに変えます。Linear は 2026年2月5日に SSE サポートの廃止を発表しました。- Windows の WSL:Linear のドキュメントには、今も SSE を使う回避策
{"mcpServers": {"linear": {"command": "wsl","args": ["npx","-y","mcp-remote","https://mcp.linear.app/sse","--transport sse-only"]}}}が載っていますが、これは Linear が廃止しようとしているエンドポイントです。失敗する可能性があるので、Linear のドキュメントで更新を確認してください。 - Codex のクラウドタスクから Linear が見えない:Linear によると、MCP サーバーを使えるのはローカルの Codex タスク(CLI か IDE 拡張機能)だけです。
- クライアントがリモート MCP に対応していない:「そのほか」のステップのように
mcp-remoteを使います。
年表
- 2025年5月1日:Linear が MCP サーバーを
https://mcp.linear.app/sseで公開。Claude ではネイティブに、Cursor、Windsurf、VS Code、Zed ではmcp-remote経由で使えました。 - 2025年6月5日:Cursor 1.0 でワンクリックの OAuth インストール、ChatGPT の Deep Research 向け Linear コネクタ。
- 2026年2月5日:イニシアチブ、イニシアチブの更新、プロジェクトのマイルストーン、プロジェクトの更新、プロジェクトのラベル、画像、リソースの URL。トークン使用量の削減。
/mcpへの移行に伴う SSE 廃止の発表。 - 2026年8月13日:Okta SAML を使う Enterprise のワークスペース向けに、Okta によるエンタープライズ管理のサインイン。
- 2026年9月14日:
list_teamsとget_teamがチームの公開範囲とretiredAtを返す。 - 2026年10月8日:
list_customer_needsツール。PKCE は S256 を明示する必要がある。 - 2026年10月22日:名前の一部でユーザーを割り当て、ドメインと外部 ID で顧客を検索。MCP で作成したサブ issue が親のプロジェクトを引き継ぐ。
- 2026年11月5日:クライアント向けの既定の指示、
list_issuesのcompletedAtフィルター、MCP レジストリへの読み取り専用エンドポイントの掲載。 - 2026年11月12日:API キーとアプリのトークンによる説明やドキュメントの編集で、変更していない部分の書式が保たれる。
AI エージェント別の Linear
エージェントによっては、MCP サーバーのほかに独自の Linear 連携もあります。各ページで、そのエージェントが Linear と連携するすべての方法を解説しています。
| エージェント | ページ |
|---|---|
| Claude Code と Claude | Claude Code + Linear:MCP、プラグイン、コネクタ |
| Codex | Codex + Linear:@Codex エージェント、コネクタ、MCP |
| Cursor | Cursor + Linear:連携、クラウドエージェント、MCP |
| ChatGPT | ChatGPT + Linear:プラグイン、コネクタ、MCP |
| GitHub Copilot | GitHub Copilot + Linear:連携、クラウドエージェント、MCP |
| Devin | Devin + Linear:連携、ラベル、オートメーション |
| Gemini | Gemini + Linear:Linear アプリ、Enterprise コネクタ、MCP |
| OpenCode | OpenCode + Linear:Linear MCP サーバーの追加 |
| OpenClaw | OpenClaw + Linear:プラグイン、MCP、スキル |
| Antigravity | Antigravity + Linear:MCP Store と mcp_config.json |
| すべて | AI エージェント向け Linear と、その代替 |
AI エージェントが担当者になるボード
Linear は人のために作られていて、エージェントは委任先として加わります。Crewmark は AI 社員のチームのために作られた issue トラッカーです。各社員はあなたのパソコン上の Claude Code または Codex の会話で、職種、KPI、プロジェクトを持ちます。OpenCode や DeepSeek Harness などのエージェントは、Agent Client Protocol でつなぎます。issue を割り当てれば作業を始め、勤務時間中はハートビートで起き、ステータスを最新に保ち、コメントし、ほかの社員を @メンションし、あなたが必要なときは issue を「要対応」にします。
Crewmark は Linear に接続しません。チームが Linear を使い続ける場合でも、社員は、そのパソコンに設定した Linear MCP サーバーをほかのツールと同じように使えます。Crewmark はオープンソース(GPL-3.0)で、1 プロジェクト・AI 社員 3 人までは無料です。エージェントは、すでにお持ちのプランで動きます。
| Linear MCP サーバー | Crewmark | |
|---|---|---|
| 何か | AI クライアントが Linear を読み書きできるようにする接続 | AI 社員が issue を担当する issue トラッカー |
| 誰が仕事をするか | あなたが AI クライアントに指示する | 各 AI 社員が、勤務時間中のハートビートで動く |
| エージェントが動く場所 | AI クライアントの中 | あなたのパソコン上の、いつもの Claude Code や Codex の環境 |
| あなたが必要なとき | 次の指示を待つ | issue を「要対応」にして、そこで尋ねる |
Linear MCP に関するよくある質問
Linear MCP サーバーとは?
https://mcp.linear.app/mcp にある、Linear 公式のホスト型リモート MCP サーバーです。Claude、Cursor、Codex、VS Code、Windsurf、Zed などの AI クライアントが、Linear の issue、プロジェクト、コメントなどを検索、作成、更新できます。Linear は 2025年5月1日に公開しました。
Linear MCP サーバーは無料ですか?
Linear は、プランの要件も別料金も示していません。料金ページでは連携の 1 つに「MCP server」が挙がっていて、API はすべての Linear プランで使えます。プランが関わるのは追加機能だけで、Claude の自動接続には Linear Business か Enterprise、Okta 管理のサインインには Enterprise が必要です。お使いの AI クライアント自体のプランは、これとは別にかかります。
Claude Code に Linear MCP を追加するには?
claude mcp add --transport http linear-server https://mcp.linear.app/mcp を実行し、Claude Code のセッションで /mcp を実行して Linear にサインインします。claude.ai で Linear を接続していて、そのサブスクリプションで Claude Code にサインインしていれば、コネクタは Claude Code にも表示されます。
Linear MCP は Cursor で使えますか?
使えます。Linear の Cursor のディープリンクか、Cursor の MCP ツールのページからワンクリックの OAuth でインストールするか、Add new global MCP server に {"mcpServers": {"linear": {"command": "npx", "args": ["-y", "mcp-remote", "https://mcp.linear.app/mcp"]}}} を追加します。
Linear MCP を読み取り専用で使えますか?
使えます。読み取りツールしか公開しない https://mcp.linear.app/mcp/readonly を使うか、/mcp を使って OAuth のスコープを read だけにするか、Read 権限だけの Linear API キーを Bearer トークンとして渡します。
Linear MCP の接続に失敗するのはなぜですか?
Linear は、リモート MCP の接続はまだ初期段階で、何度か試す必要があるかもしれないとしています。クライアントを再起動するか、サーバーをオフにしてからオンにしてください。内部サーバーエラーが出るときは、rm -rf ~/.mcp-auth を実行して再接続し、Node を更新します。設定がまだ /sse を指している場合は、https://mcp.linear.app/mcp に変えてください。Linear は SSE のサポートを廃止しようとしています。
Linear のドキュメントと changelog、各クライアントのドキュメントと照合し、2026年11月17日に確認しました。