如何将 Linear 远程 MCP 连接到 OpenAI Codex CLI

约 1 分钟即可把 Linear Orbit Inc. 的远程 MCP 服务端接入 OpenAI Codex CLI。如需排查 OAuth / 401 问题,可先用 OAuth 2.1 调试器体检端点。

🛡️ Official✓ VerifiedHTTP + SSEOAuth 2.1🛡️ A+~899 tok30 tools
HTTP + SSEhttps://mcp.linear.app/mcp
Legacy SSE endpoint
SSEhttps://mcp.linear.app/sse

Add to ~/.codex/config.toml — Codex reads remote HTTP servers from [mcp_servers.*] tables:

[mcp_servers.linear]
url = "https://mcp.linear.app/mcp"

接入步骤

  1. 编辑 TOML 配置 — 打开 ~/.codex/config.toml,加入 [mcp_servers.linear] 与 url = "https://mcp.linear.app/mcp"。
  2. 配置凭据 — 首次调用时客户端会打开 Linear Orbit Inc. 的 OAuth 授权页面——点击允许后工具即可用。
  3. 验证 — 在 在线 Inspector 中粘贴 https://mcp.linear.app/mcp 并运行 initialize + tools/list 验证连通性。

🧰 工具预览(30)

ToolSafetyDescriptionParameters
search_documentation
~34 tok
🟢 ReadSearch Linear's official documentation.—
list_comments
~32 tok
🟢 ReadList comments on an issue or document.—
create_comment
~30 tok
🟠 WriteCreate a comment on an issue.—
list_cycles
~28 tok
🟢 ReadList cycles of a team.—
get_cycle
~27 tok
🟢 ReadGet details of a cycle.—
list_documents
~28 tok
🟢 ReadList Linear documents.—
get_document
~28 tok
🟢 ReadGet a Linear document.—
create_document
~29 tok
🟠 WriteCreate a Linear document.—
update_document
~29 tok
🟠 WriteUpdate a Linear document.—
list_issue_labels
~28 tok
🟢 ReadList issue labels.—
create_issue_label
~29 tok
🟠 WriteCreate an issue label.—
list_issue_statuses
~31 tok
🟢 ReadList issue workflow states.—
get_issue_status
~31 tok
🟢 ReadGet details of a workflow state.—
list_issues
~28 tok
🟢 ReadList issues with filters.—
get_issue
~28 tok
🟢 ReadGet details of an issue.—
get_issue_git_branch_name
~37 tok
🟢 ReadGet the suggested git branch name for an issue.—
create_issue
~28 tok
🟠 WriteCreate a Linear issue.—
update_issue
~28 tok
🟠 WriteUpdate a Linear issue.—
list_projects
~28 tok
🟢 ReadList Linear projects.—
get_project
~28 tok
🟢 ReadGet details of a project.—
create_project
~29 tok
🟠 WriteCreate a Linear project.—
update_project
~29 tok
🟠 WriteUpdate a Linear project.—
list_project_labels
~29 tok
🟢 ReadList project labels.—
list_project_statuses
~30 tok
🟢 ReadList project statuses.—
get_project_status
~32 tok
🟢 ReadGet details of a project status.—
list_teams
~29 tok
🟢 ReadList teams in the workspace.—
get_team
~27 tok
🟢 ReadGet details of a team.—
list_users
~29 tok
🟢 ReadList users in the workspace.—
get_user
~27 tok
🟢 ReadGet details of a user.—
list_initiatives
~29 tok
🟢 ReadList Linear initiatives.—

更多连接指南