Skip to main content
Glama
YaTracker Connector

YaTracker Connector

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

Related MCP server: Yandex Tracker MCP

📚 Dokumentation

🔧 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

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