선형 MCP 통합 서버

이 서버는 모델 컨텍스트 프로토콜(MCP)을 통해 선형 통합 기능을 제공합니다. AI 모델이 문제 추적 및 프로젝트 관리를 위해 선형 통합과 상호 작용할 수 있도록 지원합니다.

특징

서버는 MCP 인터페이스를 통해 다음 도구를 제공합니다.

선형_생성_문제

다음 매개변수를 사용하여 새로운 선형 문제를 생성합니다.

• title (필수): 호 제목
• teamId (필수): 문제를 생성할 팀 ID
• description (선택 사항): 문제 설명(마크다운 지원)
• priority (선택 사항): 우선순위 수준(0-4)
• status (선택 사항): 초기 상태 이름

선형 검색 문제

유연한 필터링을 통한 선형 문제 검색:

• query (선택 사항): 제목/설명에서 검색할 텍스트
• teamId (선택 사항): 팀별 필터링
• status (선택 사항): 상태별 필터링
• assigneeId (선택 사항): 담당자로 필터링
• priority (선택 사항): 우선순위 수준(0-4)
• limit (선택 사항, 기본값: 10): 반환할 최대 결과 수

선형 스프린트 문제

현재 스프린트/반복의 모든 이슈를 가져옵니다.

• teamId (필수): 스프린트 문제를 가져오기 위한 팀 ID

선형_검색_팀

선형 팀 검색 및 검색:

• query (선택 사항): 팀 이름으로 검색할 텍스트

선형 필터 스프린트 문제

현재 스프린트 문제를 상태별로 필터링하고 현재 사용자로 자동 필터링합니다.

• teamId (필수): 스프린트 문제를 가져오기 위한 팀 ID
• status (필수): 필터링할 상태(예: "보류 중인 제품 릴리스")

선형_가져오기_워크플로_상태

팀의 사용 가능한 모든 워크플로 상태(상태)를 가져옵니다.

• teamId (필수): 워크플로 상태를 가져오기 위한 팀 ID

선형_목록_프로젝트

ID와 함께 사용 가능한 모든 프로젝트 목록을 받으세요.

• teamId (선택 사항): 팀별로 프로젝트를 필터링하기 위한 팀 ID
• limit (선택 사항, 기본값: 50): 반환할 최대 프로젝트 수

개발자 설정

1. Linear 설정 > API 섹션에서 Linear API 키를 받으세요.
2. Copiez le fichier d'exeple d'environnement :지엑스피1
3. Modifiez le fichier .env et ajoutez votre clé API 선형:
   LINEAR_API_KEY=votre_clé_api_linear_ici
4. 종속성 설치:
   npm install
5. 서버를 시작합니다:
   # Development mode with auto-reload npm run dev # Production mode npm start # Build TypeScript npm run build # Run linter npm run lint # Run tests npm run test # Inspect MCP server npm run inspect

GitHub에서 프로젝트를 복제한 경우 Docker 설정

Docker를 사용하여 이 애플리케이션을 실행할 수도 있습니다.

1. 시스템에 Docker와 Docker Compose가 설치되어 있는지 확인하세요.
2. 위에 설명된 대로 Linear API 키로 .env 파일을 만듭니다.
3. 컨테이너를 빌드하고 시작합니다.
   # Build and start the container in detached mode docker-compose up -d # View logs docker-compose logs -f # Stop the container docker-compose down
4. 서버는 컨테이너 내부에서 실행되며 명시적으로 중지되지 않는 한 자동으로 다시 시작됩니다.

Docker 사용(docker-compose를 이용한 간소화된 방법)

1. Linear API 키로 .env 파일을 만듭니다.
   LINEAR_API_KEY=your_linear_api_key_here
2. docker-compose.yml 파일을 만듭니다.
   version: '3.8' services: mcp-linear-server: image: madebynando/mcp-linear-server:latest container_name: mcp-linear-server restart: unless-stopped env_file: - .env volumes: - ./logs:/app/logs
3. 컨테이너를 시작합니다.
   docker-compose up -d
4. 커서를 구성하려면 다음을 사용하세요.
   • 전송 유형: 명령
   • 명령어: docker exec -i mcp-linear-server node dist/server.js

도커 개발

Docker를 사용한 개발의 경우:

기술적 세부 사항

• TypeScript 및 Model Context Protocol SDK로 구축됨
• API 상호작용을 위해 Linear SDK를 사용합니다.
• 오류 처리, 속도 제한 및 연결 관리가 포함됩니다.
• 구성 가능한 재시도 시도를 통해 자동 재연결을 지원합니다.
• 연결 상태를 위한 하트비트 모니터링을 구현합니다.
• 디버그 모드에서 자세한 로깅을 제공합니다.

오류 처리

서버에는 포괄적인 오류 처리 기능이 포함되어 있습니다.

• API 타임아웃 보호
• 연결 끊김 시 자동 재연결 시도
• 타임스탬프가 포함된 자세한 오류 로깅
• 우아한 종료 처리
• 연결 상태를 위한 하트비트 모니터링

종속성

• @linear/sdk : Linear API 클라이언트
• @modelcontextprotocol/sdk : MCP 서버 구현
• zod : 런타임 유형 검사 및 검증
• dotenv : 환경 변수 관리
• TypeScript 및 관련 개발 도구

종속성의 전체 목록을 보려면 package.json 참조하세요.

커서에서 사용

Cursor에서 이 서버를 사용하려면 MCP 서버로 추가하면 됩니다.

도커 없이

경고: Cursor에 MCP 서버를 추가할 때 명령에서 LINEAR_API_KEY 직접 설정해야 합니다. 이는 서버가 Linear API를 올바르게 인증하고 상호 작용하는 데 매우 중요합니다. 그렇지 않으면 인증 오류가 발생하고 서버가 예상대로 작동하지 않습니다.

예:

env LINEAR_API_KEY=your_linear_api_key node /path/to/your/mcp-linear-server/dist/server.js

1. 커서 설정 메뉴를 엽니다
2. "MCP 서버" 섹션으로 이동하세요
3. "MCP 서버 추가"를 클릭하세요
4. 다음 세부 정보를 입력하세요.
   • 이름: linear-mcp-server
   • 전송 유형: 명령
   • 명령어: env LINEAR_API_KEY=your_linear_api_key node /path/to/your/mcp-linear-server/dist/server.js
5. "저장"을 클릭하세요
6. 이제 커서의 도구 목록에 선형 도구가 표시됩니다.

도커를 사용하여

1. 커서 설정 메뉴를 엽니다
2. "MCP 서버" 섹션으로 이동하세요
3. "MCP 서버 추가"를 클릭하세요
4. 다음 세부 정보를 입력하세요.
   • 이름: linear-mcp-server
   • 전송 유형: 명령
   • 명령어: docker exec -i mcp-linear-server node dist/server.js
5. "저장"을 클릭하세요
6. 이제 커서의 도구 목록에 선형 도구가 표시됩니다.

클로드에게 지시하기

Claude에게 이 MCP 서버를 사용하도록 지시할 때 다음 엔드포인트를 참조할 수 있습니다.

제목, 설명, 팀 ID, 우선순위, 상태를 입력하여 새로운 선형 이슈를 만듭니다.

쿼리, 팀, 상태, 담당자, 우선순위 및 제한에 따른 유연한 필터링을 통해 선형 문제를 검색합니다.

특정 팀의 현재 스프린트/반복에서 모든 이슈를 가져옵니다.

이름으로 선형 팀을 검색하고 불러옵니다.

특정 팀의 상태별로 현재 스프린트 문제를 필터링합니다.

특정 팀에 대해 사용 가능한 모든 워크플로 상태(상태)를 가져옵니다.

팀별로 필터링하여, 선택적으로 ID와 함께 사용 가능한 모든 프로젝트 목록을 가져옵니다.