博客 · 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 文档、更新日志和 API 文档,于 2026 年 11 月 17 日核对。该服务器由 Linear 开发,在 Claude 的 Connectors Directory 中标注为 Anthropic verified。

Linear MCP 服务器
端点(读写)https://mcp.linear.app/mcp
只读端点https://mcp.linear.app/mcp/readonly,“只会提供读取类工具”;2026 年 11 月 5 日起已列入 MCP registry
传输方式Streamable HTTP。不支持远程 MCP 的客户端通过 npm 模块 mcp-remote 连接
认证带动态客户端注册的 OAuth 2.1(仅支持 PKCE S256),或把 OAuth token 或 Linear API key 放进 Authorization: Bearer <yourtoken> 请求头。Enterprise 套餐支持 Okta 企业托管认证,Business 或 Enterprise 套餐支持 Claude 自动连接(beta)
旧的 SSE 端点https://mcp.linear.app/sse 已弃用。2026 年 2 月 5 日 Linear 表示会“完全移除 SSE 支持”;2026 年 11 月 17 日对它发出未认证请求返回 404。所有新配置都请使用 /mcp
Linear 套餐Linear 的 MCP 页面没有写明使用该服务器需要哪个套餐;其价格页把“MCP server”列在集成里,所有套餐都能使用 API
速率限制Linear 没有给出针对 MCP 的限制。其通用 API 限制为:使用 API key 时每用户每小时 2,500 次请求,未认证时每个 IP 每小时 600 次;OAuth token 请求同样有速率限制(429 并带 Retry-After)
发布时间2025 年 5 月 1 日

把你的 AI 客户端接入 Linear 的 MCP 服务器

每个客户端一步,照着你用的那个做即可。每段配置都抄自 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" 传入 token。如果你用 claude.ai 订阅登录 Claude Code,在 claude.ai 上连接的 Linear 也会出现在 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 桌面端的 Settings > Connectors 里),而 Claude 自己的文档说连接器在所有套餐以及网页、桌面和移动端上都能用。在 Team 和 Enterprise 上,管理员还可以设置自动连接(beta),邮箱匹配的成员就不用再登录 Linear。

    Customize > Connectors > Discover > search "Linear" > Connect to Claude
    In a chat: + > Connectors > turn Linear on
  3. Cursor

    Linear 的文档通过 Cursor deeplink 安装(配置为 {"url":"https://mcp.linear.app/mcp"}),或者在 Cursor 的 MCP tools 页面搜索 Linear;一键 OAuth 安装随 Cursor 1.0 推出。Linear 的 Cursor 页面也给出了手动的 mcp-remote 配置。Cursor 自己的文档则把远程服务器写在 ~/.cursor/mcp.json(全局)或 .cursor/mcp.json(项目)里,用 url 字段。更多见 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 文档网址现在会跳转到 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 记录了两种写法:文档页用第一种,Zed 集成页用第二种。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 用户可用。Linear 没有记录如何在 ChatGPT 的开发者模式里添加它的 MCP URL。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 connections 页面安装)。

    Command: npx
    Arguments: -y mcp-remote https://mcp.linear.app/mcp
    Environment: None

你能用它做什么

Linear 的文档把这些工具描述为“查找、创建和更新 Linear 中的 issue、项目和评论等对象”,但没有逐个列出名称。下面的名称来自 Anthropic 的连接器目录(22 个工具)和 Linear 的更新日志。目录里的列表早于 Linear 2026 年 2 月的新增内容,所以你的客户端可能显示更多。

  • 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”或“为这个 bug 创建一个 issue 并指派给我”。
  • 评论:list_comments、create_comment。试试:“总结 ENG-123 下的评论,并添加一条写明修复方法的评论”。
  • 项目:list_projects、get_project、create_project、update_project。试试:“为账单系统重写创建一个项目,并把这三个 issue 加进去”。
  • 团队、用户和 cycle:list_teams、get_team(自 2026 年 9 月 14 日起带有各团队的可见性和 retiredAt)、list_users、get_user、list_cycles。自 2026 年 10 月 22 日起,可以用姓名的一部分来指派人员。试试:“当前 cycle 里有哪些 issue 还没有指派人?”
  • 文档和帮助:list_documents、get_document、search_documentation(Linear 自己的文档)。试试:“在 Linear 里找到我们的入职规范并总结一下”。
  • 客户:list_customer_needs(自 2026 年 10 月 8 日起)返回某个 issue、项目或 initiative 的客户需求;自 2026 年 10 月 22 日起,可以按域名和外部 ID 查找客户。试试:“哪些客户要求过 SSO?”
  • 产品管理(自 2026 年 2 月 5 日起):创建和编辑 initiative、initiative 更新、项目里程碑和项目更新,管理项目标签,上传图片,以及通过 URL 加载 Linear 资源。试试:“根据已关闭的 issue 写一份 Mobile v2 的本周项目更新”。
  • 自 2026 年 11 月 5 日起,服务器会向客户端发送关于如何使用其工具的默认说明。

只读访问

Linear 记录了三种方式,可以让 AI 客户端无法改动任何内容:

  • 使用只读端点 https://mcp.linear.app/mcp/readonly,它只会提供读取类工具。
  • 使用 https://mcp.linear.app/mcp,但只授予 read 这一个 OAuth scope,这样 token 就无法调用写入类 API。
  • 在 Authorization: Bearer 请求头里传入只有 Read 权限的 Linear API key。

故障排查

  • 连接失败或要试好几次:Linear 说远程 MCP 连接“还处于早期”。重启客户端,或在它的 MCP 设置里把 Linear 服务器关掉再打开。断开再重连不会影响你的 Linear 数据或登录状态。
  • 连接时出现 internal server error:运行 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 说只有本地的 Codex 任务(CLI 或 IDE 扩展)能使用这个 MCP 服务器。
  • 客户端不支持远程 MCP:按“其他客户端”那一步,使用 mcp-remote。

时间线

  • 2025 年 5 月 1 日:Linear 在 https://mcp.linear.app/sse 发布 MCP 服务器,Claude 原生支持,Cursor、Windsurf、VS Code 和 Zed 通过 mcp-remote 使用。
  • 2025 年 6 月 5 日:Cursor 1.0 支持一键 OAuth 安装,并推出面向 ChatGPT deep research 的 Linear 连接器。
  • 2026 年 2 月 5 日:新增 initiative、initiative 更新、项目里程碑、项目更新、项目标签、图片和资源 URL;降低 token 用量;宣布移除 SSE,改用 /mcp。
  • 2026 年 8 月 13 日:通过 Okta 的企业托管登录,适用于使用 Okta SAML 的 Enterprise 工作区。
  • 2026 年 9 月 14 日:list_teams 和 get_team 返回团队可见性和 retiredAt。
  • 2026 年 10 月 8 日:新增 list_customer_needs 工具;PKCE 必须明确使用 S256 方法。
  • 2026 年 10 月 22 日:可以用部分姓名指派用户,按域名和外部 ID 查找客户;通过 MCP 创建的子 issue 现在会继承父 issue 的项目。
  • 2026 年 11 月 5 日:为客户端提供默认说明,list_issues 新增 completedAt 筛选,只读端点列入 MCP registry。
  • 2026 年 11 月 12 日:用 API key 和应用 token 编辑描述和文档时,未改动的内容会保留原有格式。

各个 AI agent 与 Linear

有些 agent 除了 MCP 服务器之外,还有自己的 Linear 集成。每个页面都涵盖该 agent 与 Linear 配合的所有方式。

用 Crewmark

一块由 AI agent 担任负责人的看板

Linear 是为人打造的,agent 只是被加进来作为受托人。Crewmark 则是为 AI 员工团队打造的 issue 跟踪工具。每名员工都是你自己电脑上的一个 Claude Code 或 Codex 对话,有岗位、KPI 和项目;OpenCode 和 DeepSeek Harness 等其他 agent 通过 Agent Client Protocol 接入。把 issue 指派给它,它就开始工作:在工作时间内按心跳醒来,保持状态最新,发表评论并 @提及其他员工,需要你时把 issue 设为“需处理”。

Crewmark 不连接 Linear。如果你的团队继续使用 Linear,员工仍然可以像使用其他工具一样,使用你在它所在电脑上配置好的 Linear MCP 服务器。Crewmark 是开源的(GPL-3.0),1 个项目、最多 3 名 AI 员工免费;agent 使用你已有的套餐运行。

Linear MCP 服务器Crewmark
它是什么让 AI 客户端读取和修改 Linear 的连接由 AI 员工负责 issue 的 issue 跟踪工具
谁来干活你,向你的 AI 客户端发提示每名 AI 员工,在工作时间内按心跳行动
agent 在哪里运行在你的 AI 客户端里你自己的电脑上,用你平时的 Claude Code 或 Codex 环境
需要你的时候等你的下一条提示把 issue 设为“需处理”,并在那里问你

Linear MCP 常见问题

什么是 Linear MCP 服务器?

Linear 官方托管的远程 MCP 服务器,地址是 https://mcp.linear.app/mcp。Claude、Cursor、Codex、VS Code、Windsurf 和 Zed 等 AI 客户端可以通过它查找、创建和更新 Linear 的 issue、项目、评论等内容。Linear 于 2025 年 5 月 1 日发布。

Linear MCP 服务器免费吗?

Linear 没有写明它需要哪个套餐,也没有单独收费:其价格页把“MCP server”列在集成里,所有 Linear 套餐都能使用 API。只有附加功能受套餐限制:Claude 自动连接需要 Linear Business 或 Enterprise,Okta 托管登录需要 Enterprise。你的 AI 客户端自己的套餐费用仍然适用。

如何把 Linear MCP 加到 Claude Code?

运行 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 deeplink 或 Cursor 的 MCP tools 页面一键 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 并只授予 read 这一个 OAuth scope;也可以把只有 Read 权限的 Linear API key 作为 Bearer token 传入。

为什么我的 Linear MCP 连接失败?

Linear 说远程 MCP 连接还处于早期,可能需要尝试多次:重启客户端,或把服务器关掉再打开。出现 internal server error 时,运行 rm -rf ~/.mcp-auth,重新连接并更新 Node。如果你的配置仍指向 /sse,请改成 https://mcp.linear.app/mcp;Linear 正在移除 SSE 支持。

已于 2026 年 11 月 17 日对照 Linear 的文档和更新日志以及各客户端的文档核对。

给你的 agent 一块看板,而不只是一个连接。

Crewmark 把 Claude Code、Codex 以及 OpenCode 和 DeepSeek Harness 这样的 ACP agent 变成有岗位、KPI、工作时间和心跳的 AI 员工。