YaTracker Connector

Python-Bibliothek und MCP-Server für die Arbeit mit der Yandex Tracker API.

🚀 Schnellstart

Option 1: Docker (Empfohlen)

Der einfachste Weg zur Nutzung des MCP-Servers:

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

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

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

Vorteile von Docker:

• ✅ Keine absoluten Pfade

• ✅ Funktioniert überall gleich

• ✅ Einfach an Kollegen weiterzugeben

• ✅ Keine Konflikte mit anderen Projekten

📖 Mehr dazu: DOCKER.md

Option 2: Lokale Installation

# 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

📖 Mehr dazu: QUICKSTART.md

📚 Dokumentation

• QUICKSTART.md - Kurzanleitung für CLI-Befehle

• CLAUDE.md - Vollständige Anleitung für die Arbeit mit dem Projekt

• DOCKER.md - Bereitstellung via Docker

🔧 Funktionen

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, 'Текст комментария')

MCP-Server für Claude Code

Über Docker starten und in .mcp.json konfigurieren:

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

MCP-Tools

Arbeit mit Aufgaben

• yatracker_search_issues - Suche und Auflistung von Aufgaben

• yatracker_get_issue - Aufgabendetails

• yatracker_create_issue - Aufgabe/Lead erstellen

• yatracker_update_issue - Felder aktualisieren

Kommentare

• yatracker_list_comments - Liste der Kommentare

• yatracker_add_comment - Kommentar hinzufügen

• yatracker_add_comment_with_attachment - Kommentar mit Datei

Übergänge und Status

• yatracker_list_transitions - Verfügbare Übergänge

• yatracker_execute_transition - Übergang ausführen

Anhänge

• yatracker_download_attachments - Anhänge herunterladen

• yatracker_attach_file - Datei anhängen

Metadaten

• yatracker_list_queues - Liste der Queues

• yatracker_list_queue_fields - Queue-Felder

• yatracker_list_all_fields - Alle Systemfelder

• yatracker_list_queue_issue_types - Aufgabentypen

• yatracker_get_queue_workflows - Geschäftsprozess/Status-Graph

🤝 Für das Team

Projekt an Kollegen weitergeben (Docker):

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

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

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

Das war's! Keine Pfadkonfigurationen, Python-Versionen oder Ähnliches.

🔐 Konfiguration

Erstellen Sie eine .env-Datei im Projektstammverzeichnis:

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

So erhalten Sie die Anmeldedaten:

1. OAuth-Token: Yandex OAuth

2. Org ID: Im Tracker → Administration → Organisationen → Identifikator

3. Client ID (optional): Im selben OAuth-Bereich — Anwendungs-ID; für Tracker-API-Aufrufe reicht ein Token

📦 Projektstruktur

.
├── 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 сервер

Verfügbare Queues

• CRM - Lead (Leads und Kunden)

• DEV - Entwicklung

• MGT - Management

• ISTRA - Istra

• ISTRATEST - Istratest

• ISTR - Istra

Anforderungen

• Python 3.11+

• Yandex Tracker API-Token

• Organisations-ID

Lizenz

MIT