ブログ · Linear

Linear MCP サーバーの設定:Claude、Cursor、Codex、VS Code ほか

Linear 公式のリモート MCP サーバーを使うと、AI クライアントが Linear の issue、プロジェクト、コメントを検索、作成、更新できます。サーバーは Linear が https://mcp.linear.app/mcp で提供しているので、自分でインストールしたり動かしたりする必要はなく、クライアントに URL を追加して Linear にサインインするだけです。ここでは、エンドポイントと認証の選択肢、Linear と各ベンダーのドキュメントに基づく各クライアントの正確な設定方法、ツール、そしてよくある接続トラブルの対処法を紹介します。

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 に置き換えます。

  1. 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
    /mcp
  2. Claude(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 on
  3. Cursor

    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"]}}}
  4. 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"]}}}
  5. 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 linear
  6. Windsurf

    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"]}}}
  7. 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": {}}}}
  8. 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
  9. そのほか: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 と連携するすべての方法を解説しています。

Crewmark なら

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日に確認しました。

エージェントに、接続だけでなくボードを。

Crewmark は、Claude Code、Codex、そして OpenCode や DeepSeek Harness のような ACP エージェントを、職種、KPI、勤務時間、ハートビートを持つ AI 社員に変えます。