跳至主要內容

Linear MCP 伺服器

透過 LiteLLM MCP Gateway 連接 Linear 的代管遠端 MCP 伺服器，以處理議題、專案、週期與留言。

Linear 會集中代管並管理此伺服器，因此您無需自行部署或執行任何內容。LiteLLM 提供集中式驗證、依金鑰與團隊的存取控制、每次工具呼叫的成本追蹤，以及您公開的每個 MCP 伺服器共用的一份稽核軌跡。

何時應該使用此伺服器​

  • 讓代理程式在工作的討論處直接建立、分流或更新議題
  • 在規劃或估算前，將目前的週期與專案狀態帶入作為內容
  • 讓程式編寫代理程式取得其正在實作的票券，接著回覆進度留言

主要功能​

  • 專用的唯讀端點，因此您可以提供 Linear 內容，而不授予建立或編輯任何內容的能力
  • 由 Linear 透過 Streamable HTTP 代管；較舊的 SSE 端點僅作為已淘汰的備援保留
  • 用於 OAuth 的動態用戶端註冊，加上供沒有真人可登入的後端代理程式使用的 API 金鑰路徑

驗證​

  • 方法： 使用具使用者 token 的 OAuth 2.1，並遵守每位呼叫者既有的 Linear 權限。Linear 支援 動態用戶端註冊，因此不需要管理 client ID 或 secret。
  • 替代方案： 以 bearer token 方式傳送的 Linear API 金鑰。這是一個共用身分，而非每位使用者各自一個，因此請將它保留給唯讀內容來源與無人值守的後端代理程式。

端點​

遠端 MCP 伺服器：

https://mcp.linear.app/mcp

唯讀：

https://mcp.linear.app/mcp/readonly

Linear 也提供 https://mcp.linear.app/sse 作為不支援 Streamable HTTP 的用戶端的已淘汰備援。新設定請使用 /mcp 端點。

透過 LiteLLM MCP Gateway 連接​

請勿留下用戶端憑證

請勿在 OAuth 伺服器上設定 client_id、client_secret 或 token_url。這會把它切換為每位呼叫者共用的機器對機器身分，因此議題會由同一個服務帳號建立，而不是由提出請求的人建立。Linear 的動態註冊讓它們變得不必要。如果您真的想要共用身分，請使用下方的 API 金鑰分頁，因為那裡明確說明了這點。

步驟 1：在 LiteLLM 中註冊伺服器​

前往 MCP Servers，點選 + Add New MCP Server，並設定：

欄位值
Server Namelinear_mcp
TransportHTTP
Server URLhttps://mcp.linear.app/mcp
AuthenticationOAuth
OAuth flow typeInteractive (PKCE)
Client ID / Client Secret留空

點選 Create MCP Server，接著開啟該伺服器的 MCP Tools 分頁以確認連線。第一次列出會帶您完成 Linear 登入。

步驟 2：設定 proxy 的公開來源​

如果 LiteLLM 執行在 TLS 終止的 ingress 後方，請將 PROXY_BASE_URL 設為使用者在網址列中看到的來源，以便 OAuth callback 驗證通過：

PROXY_BASE_URL=https://llm.example.com

當您點選 Connect 時，不符會顯示為帶有 {"detail":"invalid_request"} 的 400 Bad Request。完整規則請見 反向 proxy 與 ingress 設定。

步驟 3：從代理程式連接​

Gateway 會在 http://localhost:4000/{server_name}/mcp 提供每個伺服器，因此 linear_mcp 可透過 http://localhost:4000/linear_mcp/mcp 存取。

Claude Desktop / Cursor
{
  "mcpServers": {
    "linear": {
      "url": "http://localhost:4000/linear_mcp/mcp",
      "headers": {
        "x-litellm-api-key": "Bearer sk-<your-litellm-api-key>"
      }
    }
  }
}

第一次請求會開啟瀏覽器進行 Linear 登入。LiteLLM 會儲存該使用者的 token，並在之後更新，因此後續工作階段連線時不會再出現提示。

提供的工具​

資訊

Linear 會在執行時透過 tools/list 公布其工具定義，因此名稱與欄位可能在未通知的情況下變更。LiteLLM UI 中的 MCP Tools 分頁是您工作區所公開內容的唯一依據；它會列出即時工具，並讓您以測試參數呼叫其中一個。上游細節請參閱 Linear 的 MCP 文件。

領域工具
Issuesget_issue, list_issues, create_issue, update_issue, list_my_issues
Issue metadatalist_issue_statuses, get_issue_status, list_issue_labels
Projectslist_projects, get_project, create_project, update_project
Commentslist_comments, create_comment
Documentsget_document, list_documents
Cycleslist_cycles
Teamslist_teams

寫入僅限於 issues、projects 與 comments；documents、cycles、teams、statuses 與 labels 則為唯讀。LiteLLM 會以伺服器名稱作為工具名稱前綴，因此 create_issue 會以 linear_mcp-create_issue 的形式暴露給模型；請參閱 工具命名。

無寫入的讀取​

唯讀端點是只授予讀取權限最乾淨的方式，也是預設首選。在標準端點上，您也可以在同意時拒絕寫入 scope，或在設定中排除寫入工具來達成相同結果。請先對照您實際的工具清單確認名稱，因為一個已不再符合真實工具的 disallowed_tools 項目會失敗但不會發出警告，並讓該工具仍可被呼叫：

config.yaml
mcp_servers:
  linear_mcp:
    url: "https://mcp.linear.app/mcp"
    transport: "http"
    auth_type: oauth2
    oauth2_flow: authorization_code
    disallowed_tools: ["create_issue", "update_issue", "create_project", "update_project", "create_comment"]
限制誰可以使用它

透過 object_permission 依金鑰或依團隊授予伺服器存取權，並以 mcp_rpm_limit 限制每個伺服器的呼叫量，兩者皆見於 MCP 權限管理。

將 LiteLLM 金鑰放在 x-litellm-api-key

互動式 OAuth 需要讓 Authorization 標頭空出來供上游 token 使用。如果用戶端將 LiteLLM API 金鑰作為 Authorization: Bearer sk-... 傳送，OAuth 流程就不會執行，LiteLLM 也會把您的 LiteLLM 金鑰轉送給 Linear，而 Linear 會拒絕它。若要診斷，請加入 x-litellm-mcp-debug: true 並讀取回應標頭：SAME_AS_LITELLM_KEY 可確認這種情況，而 m2m-client-credentials 表示已設定用戶端憑證，且所有呼叫者共用同一個身分。請參閱 OAuth 偵錯 與 MCP 疑難排解指南。

已授權的工作階段會綁定到單一 Linear 工作區，且僅重新連線不會切換它，因此需要第二個工作區的使用者必須將它註冊為另一個獨立的 MCP 伺服器項目。

LiteLLM Enterprise
為正式環境打造的 SSO/SAML、稽核記錄、支出追蹤、多團隊管理與防護欄。
深入瞭解 →