如何将 Linear 远程 MCP 连接到 OpenAI Codex CLI
约 1 分钟即可把 Linear Orbit Inc. 的远程 MCP 服务端接入 OpenAI Codex CLI。如需排查 OAuth / 401 问题,可先用 OAuth 2.1 调试器体检端点。
HTTP + SSEhttps://mcp.linear.app/mcp
Legacy SSE endpoint
SSEhttps://mcp.linear.app/sse
Install in Cursor →
Or add to ~/.cursor/mcp.json:
{
"mcpServers": {
"linear": {
"url": "https://mcp.linear.app/mcp"
}
}
}claude mcp add --transport http linear https://mcp.linear.app/mcp
Install in VS Code →
Or add to .vscode/mcp.json:
{
"servers": {
"linear": {
"type": "http",
"url": "https://mcp.linear.app/mcp"
}
}
}- Open Settings → Connectors (Integrations) → Add Custom Connector.
- Paste the endpoint URL:
https://mcp.linear.app/mcp - Complete the browser OAuth 2.1 login flow when prompted.
Bridge the remote endpoint into stdio with mcp-remote in claude_desktop_config.json:
{
"mcpServers": {
"linear": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.linear.app/mcp"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"linear": {
"serverUrl": "https://mcp.linear.app/mcp"
}
}
}Add to ~/.kiro/settings/mcp.json (or .kiro/settings/mcp.json in your workspace), then reopen Kiro's Agent panel to pick up the server:
{
"mcpServers": {
"linear": {
"url": "https://mcp.linear.app/mcp"
}
}
}Add to ~/.codex/config.toml — Codex reads remote HTTP servers from [mcp_servers.*] tables:
[mcp_servers.linear] url = "https://mcp.linear.app/mcp"
Add to cline_mcp_settings.json (Cline → MCP Servers → Configure), or paste it via Cline's MCP marketplace file:
{
"mcpServers": {
"linear": {
"type": "streamableHttp",
"url": "https://mcp.linear.app/mcp"
}
}
}Add to ~/.gemini/settings.json under mcpServers — httpUrl for Streamable HTTP, url for legacy SSE:
{
"mcpServers": {
"linear": {
"httpUrl": "https://mcp.linear.app/mcp"
}
}
}接入步骤
- 编辑 TOML 配置 — 打开
~/.codex/config.toml,加入[mcp_servers.linear]与url = "https://mcp.linear.app/mcp"。 - 配置凭据 — 首次调用时客户端会打开 Linear Orbit Inc. 的 OAuth 授权页面——点击允许后工具即可用。
- 验证 — 在 在线 Inspector 中粘贴
https://mcp.linear.app/mcp并运行 initialize + tools/list 验证连通性。
🧰 工具预览(30)
| Tool | Safety | Description | Parameters |
|---|---|---|---|
| search_documentation ~34 tok | 🟢 Read | Search Linear's official documentation. | — |
| list_comments ~32 tok | 🟢 Read | List comments on an issue or document. | — |
| create_comment ~30 tok | 🟠 Write | Create a comment on an issue. | — |
| list_cycles ~28 tok | 🟢 Read | List cycles of a team. | — |
| get_cycle ~27 tok | 🟢 Read | Get details of a cycle. | — |
| list_documents ~28 tok | 🟢 Read | List Linear documents. | — |
| get_document ~28 tok | 🟢 Read | Get a Linear document. | — |
| create_document ~29 tok | 🟠 Write | Create a Linear document. | — |
| update_document ~29 tok | 🟠 Write | Update a Linear document. | — |
| list_issue_labels ~28 tok | 🟢 Read | List issue labels. | — |
| create_issue_label ~29 tok | 🟠 Write | Create an issue label. | — |
| list_issue_statuses ~31 tok | 🟢 Read | List issue workflow states. | — |
| get_issue_status ~31 tok | 🟢 Read | Get details of a workflow state. | — |
| list_issues ~28 tok | 🟢 Read | List issues with filters. | — |
| get_issue ~28 tok | 🟢 Read | Get details of an issue. | — |
| get_issue_git_branch_name ~37 tok | 🟢 Read | Get the suggested git branch name for an issue. | — |
| create_issue ~28 tok | 🟠 Write | Create a Linear issue. | — |
| update_issue ~28 tok | 🟠 Write | Update a Linear issue. | — |
| list_projects ~28 tok | 🟢 Read | List Linear projects. | — |
| get_project ~28 tok | 🟢 Read | Get details of a project. | — |
| create_project ~29 tok | 🟠 Write | Create a Linear project. | — |
| update_project ~29 tok | 🟠 Write | Update a Linear project. | — |
| list_project_labels ~29 tok | 🟢 Read | List project labels. | — |
| list_project_statuses ~30 tok | 🟢 Read | List project statuses. | — |
| get_project_status ~32 tok | 🟢 Read | Get details of a project status. | — |
| list_teams ~29 tok | 🟢 Read | List teams in the workspace. | — |
| get_team ~27 tok | 🟢 Read | Get details of a team. | — |
| list_users ~29 tok | 🟢 Read | List users in the workspace. | — |
| get_user ~27 tok | 🟢 Read | Get details of a user. | — |
| list_initiatives ~29 tok | 🟢 Read | List Linear initiatives. | — |
更多连接指南
GitHub MCP → OpenAI Codex CLI
连接至 OpenAI Codex CLI →
Notion MCP → OpenAI Codex CLI
连接至 OpenAI Codex CLI →
Figma Dev Mode MCP → OpenAI Codex CLI
连接至 OpenAI Codex CLI →
AWS Knowledge → OpenAI Codex CLI
连接至 OpenAI Codex CLI →
Stripe MCP → OpenAI Codex CLI
连接至 OpenAI Codex CLI →
Claude Skills → OpenAI Codex CLI
连接至 OpenAI Codex CLI →