Skip to main content
Glama
deenesjakoruzh
Belkin-digital

YaTracker Connector

by Belkin-digital
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Hybrid

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 Server

📚 문서

🔧 기능

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

This server cannot be deployed

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • YouTrack MCP Server

    devstroop
    F
    license
    Not graded
    quality
    Not graded
    maintenance
    Enables AI assistants to interact with JetBrains YouTrack 2025.2 for managing issues, sprints, dependencies, time tracking, and knowledge base content. Supports CRUD operations, bulk commands, analytics with Gantt charts and critical path analysis, and covers ~80% of the YouTrack REST API.
    24
    52
    -

  • Yandex Tracker MCP Server

    zolkinka
    F
    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.
    -

  • yandex-tracker-mcp

    brekhov-ilya
    A
    license
    Not graded
    quality
    C
    maintenance
    MCP server for Yandex Tracker API, enabling AI assistants to search, read, create, and edit issues, as well as manage comments, attachments, and links in Yandex Tracker.
    48
    1
    MIT