YaTracker Connector

Yandex Tracker API 작업을 위한 Python 라이브러리 및 MCP 서버입니다.

🚀 빠른 시작

옵션 1: Docker (권장)

MCP 서버를 사용하는 가장 쉬운 방법:

# 1. Создайте .env файл
cp config/sample.env .env
# Отредактируйте .env и добавьте свои credentials

# 2. Запустите
docker-compose up -d

# Готово! MCP сервер работает на порту 8080

Docker의 장점:

✅ 절대 경로 없음
✅ 어디서나 동일하게 작동
✅ 동료에게 쉽게 전달 가능
✅ 다른 프로젝트와 충돌 없음

📖 자세히 보기: DOCKER.md

옵션 2: 로컬 설치

# 1. Установите зависимости
pip install -r requirements.txt

# 2. Создайте .env
cp config/sample.env .env
# Добавьте YATRACKER_TOKEN и YATRACKER_ORG_ID

# 3. Используйте CLI
PYTHONPATH=src python3.11 -m scripts.cli issues list --queue CRM

📖 자세히 보기: QUICKSTART.md

📚 문서

QUICKSTART.md - CLI 명령 빠른 참조
CLAUDE.md - 프로젝트 작업 전체 지침
DOCKER.md - Docker를 통한 배포

🔧 기능

CLI (Command Line Interface)

# Список задач
PYTHONPATH=src python3.11 -m scripts.cli issues list --queue CRM --limit 50

# Комментарии
PYTHONPATH=src python3.11 -m scripts.cli comments list CRM-19
PYTHONPATH=src python3.11 -m scripts.cli comments add CRM-19 "Текст"

# Переходы статусов
PYTHONPATH=src python3.11 -m scripts.cli transitions list CRM-19

# Вложения
PYTHONPATH=src python3.11 -m scripts.cli attachments download CRM-19

Python API

from yatracker_connector import (
    build_tracker_client,
    get_issue,
    add_comment,
    search_issues
)

client = build_tracker_client()
issue = get_issue(client, 'CRM-19')
add_comment(issue, 'Текст комментария')

Claude Code용 MCP 서버

Docker를 통해 실행하고 .mcp.json에서 설정하세요:

{
  "mcpServers": {
    "yatracker": {
      "transport": "sse",
      "url": "http://localhost:8080/sse"
    }
  }
}

MCP 도구

작업 관리

yatracker_search_issues - 작업 검색 및 목록
yatracker_get_issue - 작업 세부 정보
yatracker_create_issue - 작업/리드 생성
yatracker_update_issue - 필드 업데이트

yatracker_list_comments - 댓글 목록
yatracker_add_comment - 댓글 추가
yatracker_add_comment_with_attachment - 첨부 파일이 포함된 댓글

전환 및 상태

yatracker_list_transitions - 사용 가능한 전환
yatracker_execute_transition - 전환 실행

첨부 파일

yatracker_download_attachments - 첨부 파일 다운로드
yatracker_attach_file - 파일 첨부

메타데이터

yatracker_list_queues - 큐 목록
yatracker_list_queue_fields - 큐 필드
yatracker_list_all_fields - 시스템의 모든 필드
yatracker_list_queue_issue_types - 작업 유형
yatracker_get_queue_workflows - 비즈니스 프로세스/상태 그래프

🤝 팀을 위한 안내

동료에게 프로젝트 전달 (Docker):

# 1. Коллега клонирует репозиторий
git clone <url>
cd "YaTracker Connector"

# 2. Создает свой .env
cp config/sample.env .env
# Добавляет свои credentials

# 3. Запускает
docker-compose up -d

끝입니다! 경로 설정, Python 버전 등 복잡한 설정이 필요 없습니다.

🔐 설정

프로젝트 루트에 .env 파일을 생성하세요:

YATRACKER_TOKEN=your_oauth_token_here
YATRACKER_ORG_ID=your_organization_id
# опционально, если ведёшь учёт приложения: YATRACKER_OAUTH_CLIENT_ID=...

자격 증명(credentials)을 얻는 방법:

OAuth 토큰: Yandex OAuth
Org ID: Tracker → 관리 → 조직 → 식별자
Client ID (선택 사항): 동일한 OAuth 관리 페이지의 애플리케이션 식별자; Tracker API 호출에는 토큰만으로 충분합니다.

📦 프로젝트 구조

.
├── Dockerfile              # Docker образ
├── docker-compose.yml      # Простой запуск
├── .env                    # Credentials (НЕ коммитить!)
├── src/yatracker_connector/
│   ├── config.py          # Настройки
│   ├── client.py          # Клиент API
│   └── operations.py      # Операции с задачами
└── scripts/
    ├── cli.py             # CLI интерфейс
    └── mcp_server.py      # MCP сервер

사용 가능한 큐

CRM - Lead (리드 및 고객)
DEV - 개발
MGT - 관리
ISTRA - Istra
ISTRATEST - Istratest
ISTR - Istra

요구 사항

Python 3.11+
Yandex Tracker API 토큰
조직 ID

라이선스

MIT

YaTracker Connector

YaTracker Connector

🚀 빠른 시작

옵션 1: Docker (권장)

옵션 2: 로컬 설치

📚 문서

🔧 기능

CLI (Command Line Interface)

Python API

Claude Code용 MCP 서버

MCP 도구

작업 관리

댓글

전환 및 상태

첨부 파일

메타데이터

🤝 팀을 위한 안내

동료에게 프로젝트 전달 (Docker):

🔐 설정

자격 증명(credentials)을 얻는 방법:

📦 프로젝트 구조

사용 가능한 큐

요구 사항

라이선스

Resources

Looking for Admin?

Latest Blog Posts

MCP directory API