Skip to main content
Glama
YaTracker Connector

YaTracker Connector

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

Related MCP server: Yandex Tracker MCP

📚 문서

🔧 기능

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)을 얻는 방법:

  1. OAuth 토큰: Yandex OAuth

  2. Org ID: Tracker → 관리 → 조직 → 식별자

  3. 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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to interact with Yandex.Tracker task management system through MCP protocol. Supports creating and managing issues, searching tasks, handling comments, managing projects and queues, and generating analytics reports.
      ISC
    • A
      license
      B
      quality
      C
      maintenance
      Enables AI assistants to read and manage issues, comments, checklists, worklogs, queues, users, metadata, and time reports through the Yandex Tracker REST API v3, requiring user confirmation before data-changing operations.
      30
      MIT