MCP 선형 앱

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

특징

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

Related MCP server: Linear MCP Server

필수 조건

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 도구를 사용하여 댓글을 가져옵니다.