Conector de YaTracker

Biblioteca de Python y servidor MCP para trabajar con la API de Yandex Tracker.

🚀 Inicio rápido

Opción 1: Docker (Recomendado)

La forma más sencilla de utilizar el servidor MCP:

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

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

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

Ventajas de Docker:

✅ Sin rutas absolutas
✅ Funciona igual en todas partes
✅ Fácil de compartir con colegas
✅ No entra en conflicto con otros proyectos

📖 Más información: DOCKER.md

Opción 2: Instalación local

# 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

📖 Más información: QUICKSTART.md

📚 Documentación

QUICKSTART.md - Guía rápida de comandos CLI
CLAUDE.md - Instrucciones completas para trabajar con el proyecto
DOCKER.md - Despliegue mediante Docker

🔧 Funcionalidades

CLI (Interfaz de línea de comandos)

# Список задач
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

API de Python

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

Servidor MCP para Claude Code

Ejecútelo a través de Docker y configúrelo en .mcp.json:

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

Herramientas MCP

Trabajo con tareas

yatracker_search_issues - búsqueda y lista de tareas
yatracker_get_issue - detalles de la tarea
yatracker_create_issue - crear tarea/lead
yatracker_update_issue - actualizar campos

Comentarios

yatracker_list_comments - lista de comentarios
yatracker_add_comment - añadir comentario
yatracker_add_comment_with_attachment - comentario con archivo

Transiciones y estados

yatracker_list_transitions - transiciones disponibles
yatracker_execute_transition - ejecutar transición

Archivos adjuntos

yatracker_download_attachments - descargar archivos adjuntos
yatracker_attach_file - adjuntar archivo

Metadatos

yatracker_list_queues - lista de colas
yatracker_list_queue_fields - campos de la cola
yatracker_list_all_fields - todos los campos del sistema
yatracker_list_queue_issue_types - tipos de tareas
yatracker_get_queue_workflows - proceso de negocio/grafo de estados

🤝 Para el equipo

Compartir el proyecto con colegas (Docker):

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

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

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

¡Eso es todo! Sin configuraciones de rutas, versiones de Python ni nada más.

🔐 Configuración

Cree un archivo .env en la raíz del proyecto:

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

Cómo obtener las credenciales:

Token OAuth: Yandex OAuth
ID de organización: En Tracker → Administración → Organizaciones → identificador
ID de cliente (opcional): en el mismo panel de OAuth — identificador de la aplicación; para las llamadas a la API de Tracker, basta con el token

📦 Estructura del proyecto

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

Colas disponibles

CRM - Lead (leads y clientes)
DEV - Desarrollo
MGT - Gestión
ISTRA - Istra
ISTRATEST - Istratest
ISTR - Istra

Requisitos

Python 3.11+
Token de la API de Yandex Tracker
ID de organización

Licencia

MIT

YaTracker Connector