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 сервер работает на порту 8080Vorteile 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
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-19Python 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 Aufgabenyatracker_get_issue- Aufgabendetailsyatracker_create_issue- Aufgabe/Lead erstellenyatracker_update_issue- Felder aktualisieren
Kommentare
yatracker_list_comments- Liste der Kommentareyatracker_add_comment- Kommentar hinzufügenyatracker_add_comment_with_attachment- Kommentar mit Datei
Übergänge und Status
yatracker_list_transitions- Verfügbare Übergängeyatracker_execute_transition- Übergang ausführen
Anhänge
yatracker_download_attachments- Anhänge herunterladenyatracker_attach_file- Datei anhängen
Metadaten
yatracker_list_queues- Liste der Queuesyatracker_list_queue_fields- Queue-Felderyatracker_list_all_fields- Alle Systemfelderyatracker_list_queue_issue_types- Aufgabentypenyatracker_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 -dDas 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:
OAuth-Token: Yandex OAuth
Org ID: Im Tracker → Administration → Organisationen → Identifikator
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…
This server cannot be deployed
Maintenance
Related MCP Connectors
Task manager your agent can fully operate: boards, tasks, sprints, roles, worklogs, day planner.
Task management for people and AI agents, with scoped OAuth access to issues, projects, and docs.
Task management for people and AI agents, with scoped OAuth access to issues, projects, and docs.
Read and update tickets, deals, tasks, and contacts in 18 Cores Tracker.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables 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
- FlicenseNot gradedqualityDmaintenanceEnables AI agents to manage Yandex Tracker tasks with tools for creating, reading, updating, and transitioning issues via a Streamable HTTP endpoint.-
- AlicenseAqualityBmaintenanceEnables AI assistants to securely interact with Yandex Tracker, managing issues, queues, comments, worklogs, and search, including attaching files to issues.561Apache 2.0
- AlicenseBqualityCmaintenanceEnables 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.30MIT