Skip to main content
Glama
YaTracker Connector

YaTracker Connector

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

📚 Documentación

🔧 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

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