Máy chủ Linear MCP

Máy chủ “Linear” MCP làm gì?

Máy chủ Linear MCP là một máy chủ Model Context Protocol (MCP) được thiết kế để tích hợp hệ thống quản lý dự án của Linear với trợ lý AI và các mô hình ngôn ngữ lớn (LLM). Bằng cách làm cầu nối giữa API Linear và các client AI, nó cho phép quản lý các vấn đề Linear trực tiếp qua giao diện hội thoại AI một cách liền mạch. Các lập trình viên và nhóm có thể tận dụng máy chủ này để tự động hóa và tối ưu hóa quy trình làm việc liên quan đến việc tạo, cập nhật, tìm kiếm và bình luận trên các vấn đề trong Linear. Máy chủ cung cấp công cụ và nguồn lực, cho phép LLM thực hiện thao tác quản lý dự án thông qua lập trình—giúp tăng năng suất, cải thiện cộng tác nhóm và theo dõi công việc hiệu quả nhờ các tương tác MCP tiêu chuẩn.

Danh sách Prompts

• Không có mẫu nhắc lặp lại nào được mô tả trong kho lưu trữ.
  (Prompts ở đây chỉ các mẫu nhắc lặp lại được định nghĩa cho client—không phải ví dụ cho người dùng cuối. Phần này để trống vì không có đề cập tới loại mẫu này.)

Danh sách Nguồn lực

• linear-issue:///{issueId}
  Xem thông tin chi tiết một vấn đề cụ thể bằng cách tham chiếu ID vấn đề Linear.
• linear-team:///{teamId}/issues
  Truy cập tất cả vấn đề của một nhóm nhất định trong Linear.
• linear-user:///{userId}/assigned
  Truy xuất tất cả vấn đề hiện đang được giao cho một người dùng.
• linear-organization:
  Xem thông tin tổng quan về tổ chức trong Linear.
• linear-viewer:
  Truy cập ngữ cảnh của người dùng hiện tại trong Linear.

Danh sách Công cụ

• linear_create_issue
  Tạo một vấn đề Linear mới với tiêu đề, mô tả, mức độ ưu tiên, trạng thái và nhóm được chỉ định tùy chỉnh.
• linear_update_issue
  Cập nhật các trường như tiêu đề, mô tả, mức độ ưu tiên hoặc trạng thái của một vấn đề Linear hiện có.
• linear_search_issues
  Tìm kiếm các vấn đề Linear sử dụng bộ lọc linh hoạt như truy vấn văn bản, nhóm, trạng thái, người được giao, nhãn và ưu tiên.
• linear_get_user_issues
  Truy xuất các vấn đề được giao cho người dùng cụ thể, có thể lọc theo trạng thái lưu trữ và giới hạn kết quả.
• linear_add_comment
  Thêm bình luận vào một vấn đề Linear, hỗ trợ tên người dùng và URL avatar tùy chỉnh.

Trường hợp sử dụng của Máy chủ MCP này

• Tự động tạo và quản lý vấn đề
  Lập trình viên có thể sử dụng LLM để tạo, cập nhật hoặc bình luận trên vấn đề Linear mà không cần thao tác thủ công, giúp tối ưu hóa quá trình báo cáo và theo dõi.
• Tổng quan và phân công tác vụ nhóm
  Trợ lý AI có thể nhanh chóng truy xuất tất cả vấn đề của một nhóm hoặc người dùng, giúp các buổi họp đứng và lập kế hoạch sprint hiệu quả hơn.
• Tìm kiếm và lọc vấn đề nâng cao
  Dễ dàng tìm vấn đề phù hợp tiêu chí (ví dụ: mức ưu tiên, trạng thái, nhãn) thông qua truy vấn hội thoại.
• Theo dõi khối lượng công việc cá nhân
  Thành viên nhóm có thể dùng LLM liệt kê các vấn đề được giao, theo dõi thay đổi trạng thái và ưu tiên công việc.
• Tự động cập nhật trạng thái và bình luận
  LLM có thể đăng cập nhật hoặc yêu cầu làm rõ trên vấn đề Linear, nâng cao giao tiếp dự án và minh bạch.

Cách thiết lập

Windsurf

1. Đảm bảo đã cài đặt Node.js trên hệ thống của bạn.
2. Lấy khóa API Linear từ phần cài đặt của nhóm.
3. Tìm file cấu hình Windsurf (thường là windsurf_config.json).
4. Thêm mục máy chủ Linear MCP vào đối tượng mcpServers:

   {
     "mcpServers": {
       "linear": {
         "command": "npx",
         "args": [
           "-y",
           "linear-mcp-server"
         ],
         "env": {
           "LINEAR_API_KEY": "your_linear_api_key_here"
         }
       }
     }
   }
   

5. Lưu file và khởi động lại Windsurf.
6. Xác nhận máy chủ MCP đang chạy và truy cập được.

Claude

1. Lấy khóa API Linear từ https://linear.app/YOUR-TEAM/settings/api.
2. Trên MacOS, chỉnh sửa ~/Library/Application Support/Claude/claude_desktop_config.json.
3. Thêm hoặc cập nhật đoạn sau:

   {
     "mcpServers": {
       "linear": {
         "command": "npx",
         "args": [
           "-y",
           "linear-mcp-server"
         ],
         "env": {
           "LINEAR_API_KEY": "your_linear_api_key_here"
         }
       }
     }
   }
   

4. Lưu và khởi động lại Claude Desktop.
5. Xác nhận thiết lập qua giao diện Claude.

Cursor

1. Đảm bảo đã cài đặt Node.js và lấy khóa API Linear.
2. Tìm file cấu hình Cursor (ví dụ cursor_config.json).
3. Thêm cấu hình máy chủ Linear MCP như sau:

   {
     "mcpServers": {
       "linear": {
         "command": "npx",
         "args": [
           "-y",
           "linear-mcp-server"
         ],
         "env": {
           "LINEAR_API_KEY": "your_linear_api_key_here"
         }
       }
     }
   }
   

4. Lưu thay đổi và khởi động lại Cursor.
5. Đảm bảo máy chủ đã được liệt kê và hoạt động.

Cline

1. Cài đặt Node.js và bảo mật khóa API Linear của bạn.
2. Chỉnh sửa file cấu hình Cline (ví dụ: cline_config.json).
3. Thêm đoạn máy chủ MCP sau:

   {
     "mcpServers": {
       "linear": {
         "command": "npx",
         "args": [
           "-y",
           "linear-mcp-server"
         ],
         "env": {
           "LINEAR_API_KEY": "your_linear_api_key_here"
         }
       }
     }
   }
   

4. Lưu và khởi động lại Cline.
5. Kiểm tra máy chủ Linear MCP đã hoạt động.

Bảo mật khóa API
Luôn sử dụng biến môi trường cho các dữ liệu nhạy cảm như khóa API. Ví dụ cấu hình:

{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": [
        "-y",
        "linear-mcp-server"
      ],
      "env": {
        "LINEAR_API_KEY": "${LINEAR_API_KEY}"
      }
    }
  }
}

Thiết lập biến môi trường LINEAR_API_KEY trong hệ điều hành hoặc môi trường triển khai của bạn.

Cách sử dụng MCP này trong luồng

Sử dụng MCP trong FlowHunt

Để tích hợp máy chủ MCP vào luồng làm việc FlowHunt, hãy bắt đầu bằng cách thêm thành phần MCP vào flow và kết nối với agent AI của bạn:

Nhấp vào thành phần MCP để mở bảng cấu hình. Trong phần cấu hình MCP hệ thống, điền thông tin máy chủ MCP của bạn theo định dạng JSON sau:

{
  "linear": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Khi đã cấu hình, agent AI sẽ có thể sử dụng MCP này như một công cụ với đầy đủ chức năng. Lưu ý thay đổi “linear” thành tên thực tế của máy chủ MCP của bạn và thay URL bằng địa chỉ máy chủ MCP của bạn.

Tổng quan

Hỗ trợ Roots: ⛔ (Không đề cập trong kho lưu trữ)

Dựa trên bảng trên, Máy chủ Linear MCP cung cấp tích hợp mạnh mẽ cho các tác vụ quản lý dự án Linear, có các công cụ và nguồn lực rõ ràng, cùng hướng dẫn thiết lập chi tiết. Tuy nhiên, nó thiếu mẫu nhắc lặp lại và chưa đề cập đến Roots hoặc sampling. Nhìn chung, máy chủ này đạt điểm cao cho các nhiệm vụ MCP tiêu chuẩn nhưng còn thiếu một số tính năng nâng cao.

Điểm MCP