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

Related MCP server: Yandex Tracker MCP Server

📚 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:

1. Token OAuth: Yandex OAuth

2. ID de organización: En Tracker → Administración → Organizaciones → identificador

3. 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