local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Provides comprehensive Linear project management integration, enabling searching, creating, and updating issues, adding and managing comments, retrieving user profiles, and accessing team information through Linear's API.

MCP 선형 앱

Linear를 AI 도구로 통합하기 위한 모델 컨텍스트 프로토콜(MCP). 이 도구를 사용하면 AI가 모델 컨텍스트 프로토콜을 통해 Linear와 상호 작용할 수 있습니다.

특징

완전 선형 적분 :
- 검색 문제
- 새로운 이슈를 만들어 보세요
- 업데이트 문제
- 댓글 추가
- 댓글 업데이트
- 사용자 프로필 가져오기
- 팀 정보 얻기

필수 조건

Node.js 18 이상
선형 API 키

선형 API 키를 얻는 방법

이 애플리케이션을 사용하려면 Linear API 키가 필요합니다. 키를 얻는 방법은 다음과 같습니다.

로그인 또는 선형 계정 생성
- Linear를 방문하여 기존 계정에 로그인하거나 등록하여 새 계정을 만드십시오.
작업 공간 설정에 액세스
- 메인 페이지에서 왼쪽 상단 모서리에 있는 사용자 이름을 클릭하세요.
- "작업 공간 설정" 옵션을 선택하세요
오픈 API 설정
- 왼쪽의 "설정" 열에서 "API"를 찾을 때까지 아래로 스크롤하세요.
- "API" 옵션을 클릭하세요
새 API 키 만들기
- API 키에 대한 레이블을 입력하세요(예: "MCP Linear App")
- "새 API 키 만들기" 버튼을 클릭하세요
API 키를 안전하게 저장하세요
- API 키는 한 번만 표시됩니다.
- Linear에서는 다시 표시되지 않으므로 안전한 위치에 복사하여 저장하세요.

중요 참고 : Linear는 API 키에 대해 시간당 1,500개의 요청으로 제한합니다. 429 Too Many Requests 오류를 방지하려면 애플리케이션이 이 제한을 준수해야 합니다.

Linear API 키를 얻고 사용하는 방법에 대한 자세한 내용은 Merge.dev의 가이드를 참조하세요.

도구 사용 방법

1. 초기 설정

이 저장소를 복제하세요:

지엑스피1

종속성 설치:

npm install

루트 디렉토리에 .env 파일을 만듭니다.

LINEAR_API_KEY=your_linear_api_key_here

프로젝트를 빌드하세요:

npm run build

이제 dist 폴더는 다양한 AI 플랫폼에서 구성하는 데 사용할 수 있습니다.

2. 커서 구성

커서 MCP 구성 파일을 찾으세요.
- Windows: C:\Users\<username>\.cursor\mcp.json
- macOS: ~/.cursor/mcp.json
- 리눅스: ~/.cursor/mcp.json
파일을 편집하여 Linear MCP 서버 구성을 추가합니다.
{ "mcpServers": { "linear": { "command": "<path-to-node>", "args": [ "<path-to-project>/dist/index.js" ], "env": { "LINEAR_API_KEY": "your_linear_api_key_here" } } } }
자리 표시자를 교체하세요:
- <path-to-node> : Node.js 실행 파일의 경로
- <path-to-project> : MCP Linear App 프로젝트 디렉토리의 절대 경로
- your_linear_api_key_here : Linear API 키

구성 예:

{
  "mcpServers": {
    "linear": {
      "command": "C:\\nvm4w\\nodejs\\node.exe",
      "args": [
        "H:\\mcp\\linear\\dist\\index.js"
      ],
      "env": {
        "LINEAR_API_KEY": "lin_api_xxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

파일을 저장하고 Cursor를 다시 시작하여 변경 사항을 적용하세요.

3. 클로드 구성

Claude와 함께 MCP Linear Tools를 사용하려면 Claude 설정 파일에 구성을 추가해야 합니다. 다음 단계를 따르세요.

Claude AI 데스크톱 앱 설정 열기
"개발자" 섹션으로 이동하세요
"도구" 구성 섹션을 찾으세요
다음과 같이 Linear MCP에 대한 구성을 추가합니다.

{
  "tools": {
    "linear": {
      "command": "<path-to-node>",
      "args": [
        "<path-to-project>/dist/index.js"
      ],
      "env": {
        "LINEAR_API_KEY": "your_linear_api_key_here"
      }
    }
  }
}

자리 표시자를 교체하세요:
- <path-to-node> : Node.js 실행 파일의 경로
- <path-to-project> : MCP Linear App 프로젝트 디렉토리의 절대 경로
- your_linear_api_key_here : Linear API 키

구성 예:

{
  "tools": {
    "linear": {
      "command": "/usr/local/bin/node",
      "args": [
        "/Users/username/projects/mcp-linear-app/dist/index.js"
      ],
      "env": {
        "LINEAR_API_KEY": "lin_api_xxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

4. 다른 플랫폼에서의 구성

MCP를 지원하는 다른 AI 플랫폼의 기본 원칙은 동일합니다.

외부 도구 또는 MCP에 대한 구성 영역 찾기
이 저장소의 dist/index.js 파일로 Node.js를 실행하도록 구성합니다.
환경 구성에 LINEAR_API_KEY를 포함합니다.

사용 가능한 도구

구성 후 AI는 다음 선형 도구에 액세스할 수 있습니다.

search_issues - 키워드, 상태 또는 우선순위로 문제 검색
create_issue - 새로운 이슈를 생성합니다
get_issue - 문제 세부 정보 가져오기
update_issue - 기존 이슈 업데이트
create_comment - 이슈에 댓글 추가
get_comment - 이슈에 대한 코멘트를 가져옵니다
update_comment - 댓글 업데이트 또는 삭제
get_profile - 현재 선형 사용자 프로필을 가져옵니다.
get_team_id - 팀과 ID 목록을 가져옵니다.

지원 및 도움말

이 도구를 사용하는 데 문제가 발생하면 다음을 수행하세요.

Linear API 키가 유효하고 충분한 권한이 있는지 확인하세요.
Node.js가 제대로 설치되었는지 확인하세요
AI 플랫폼에서 MCP 구성을 확인하세요
나타날 수 있는 오류 메시지가 있는지 로그 파일을 확인하세요.

AI 환경에서 선형 도구 사용

AI 환경에서 선형 도구를 구성하면 AI에 메시지를 표시하여 사용할 수 있습니다. 다음은 몇 가지 예입니다.

커서에서 선형 도구 사용

Cursor에서는 Claude에게 Linear 관련 작업을 수행하도록 간단히 요청할 수 있습니다.

Search for high priority issues in our Linear project.

Create a new issue in Linear with the title "Improve login page performance" and add it to the backlog.

Get the details of the issue LIN-123 from Linear.

Add a comment to issue LIN-456 saying "This is fixed in the latest release. Please verify."

Update the priority of issue LIN-789 to urgent.

워크플로 예시: 문제 생성 및 관리

다음은 이러한 도구를 사용하는 방법을 보여주는 워크플로의 예입니다.

팀 ID 찾기 :
What's my Linear team ID?
Claude는 get_team_id 도구를 사용하여 팀 정보를 가져옵니다.
새로운 이슈 생성 :
Create a new Linear issue titled "Implement password reset feature" for the Engineering team with a high priority. The description should be "Users need a way to reset their passwords when they forget them."
클로드는 필요한 매개변수와 함께 create_issue 도구를 사용합니다.
문제 검색 :
Find all high priority issues assigned to me that are currently in progress.
클로드는 적절한 필터와 함께 search_issues 도구를 사용합니다.
문제 업데이트 :
Update issue LIN-456 to add the description "This issue has been verified and tested on all browsers."
Claude는 update_issue 도구를 사용하여 문제를 수정합니다.
댓글 추가 :
Add a comment to issue LIN-789 asking "Is this still a priority for this sprint?"
Claude는 create_comment 도구를 사용하여 댓글을 추가합니다.
댓글 검색 :
Show me all the comments on issue LIN-321
클로드는 get_comment 도구를 사용하여 댓글을 가져옵니다.

이러한 예는 도구를 적절히 구성하면 AI 도우미를 통해 Linear와 얼마나 자연스럽게 상호 작용할 수 있는지 보여줍니다.

최근 업데이트

이 프로젝트는 최근 문서화 및 선형 도구 기능이 개선되어 더욱 향상되었습니다. 개선된 내용은 다음과 같습니다.

더 명확한 설치 및 구성 지침으로 업데이트된 README
다양한 AI 플랫폼에 대한 예제가 포함된 향상된 문서
더 나은 오류 처리 및 응답 형식을 갖춘 개선된 선형 도구
댓글 관리(생성, 가져오기, 업데이트, 삭제)에 대한 지원이 추가되었습니다.
상태 및 우선순위별 필터링으로 검색 기능 개선

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다.

https://kelasinovatif.com/

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

모델 컨텍스트 프로토콜을 통해 AI 어시스턴트가 Linear의 프로젝트 관리 도구와 상호 작용할 수 있도록 하는 서버로, 문제 검색, 생성 및 업데이트, 코멘트 추가, 사용자 프로필 및 팀 정보 검색과 같은 기능을 지원합니다.