Skip to main content
Glama
deenesjakoruzh
Belkin-digital

YaTracker Connector

by Belkin-digital
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Hybrid

YaTracker Connector

Yandex Tracker APIを操作するためのPythonライブラリおよびMCPサーバーです。

🚀 クイックスタート

オプション1: Docker (推奨)

MCPサーバーを使用する最も簡単な方法です：

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

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

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

Dockerの利点:

  • ✅ 絶対パスが不要

  • ✅ どこでも同じように動作

  • ✅ 同僚との共有が容易

  • ✅ 他のプロジェクトと競合しない

📖 詳細: DOCKER.md

オプション2: ローカルインストール

# 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

📖 詳細: QUICKSTART.md

Related MCP server: Yandex Tracker MCP Server

📚 ドキュメント

  • QUICKSTART.md - CLIコマンドクイックリファレンス

  • CLAUDE.md - プロジェクト作業のための完全ガイド

  • DOCKER.md - Dockerによるデプロイ

🔧 機能

CLI (コマンドラインインターフェース)

# Список задач
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, 'Текст комментария')

Claude Code用MCPサーバー

Docker経由で起動し、.mcp.jsonで設定します：

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

MCPツール

タスク操作

  • yatracker_search_issues - 課題の検索と一覧表示

  • yatracker_get_issue - 課題の詳細

  • yatracker_create_issue - 課題/リードの作成

  • yatracker_update_issue - フィールドの更新

コメント

  • yatracker_list_comments - コメント一覧

  • yatracker_add_comment - コメントの追加

  • yatracker_add_comment_with_attachment - 添付ファイル付きコメント

遷移とステータス

  • yatracker_list_transitions - 利用可能な遷移

  • yatracker_execute_transition - 遷移の実行

添付ファイル

  • yatracker_download_attachments - 添付ファイルのダウンロード

  • yatracker_attach_file - ファイルの添付

メタデータ

  • yatracker_list_queues - キュー一覧

  • yatracker_list_queue_fields - キューのフィールド

  • yatracker_list_all_fields - システムの全フィールド

  • yatracker_list_queue_issue_types - 課題タイプ

  • yatracker_get_queue_workflows - ビジネスプロセス/ステータスグラフ

🤝 チーム向け

同僚へのプロジェクト共有 (Docker):

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

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

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

以上です！ パス設定やPythonのバージョン管理などに悩まされることはありません。

🔐 設定

プロジェクトのルートに .env ファイルを作成します：

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

認証情報の取得方法:

  1. OAuthトークン: Yandex OAuth

  2. Org ID: Tracker → 管理 → 組織 → ID

  3. Client ID (任意): 同じOAuth管理画面内のアプリケーションID。Tracker APIの呼び出しにはトークンのみで十分です。

📦 プロジェクト構造

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

利用可能なキュー

  • CRM - Lead (リードおよび顧客)

  • DEV - 開発

  • MGT - 管理

  • ISTRA - Istra

  • ISTRATEST - Istratest

  • ISTR - Istra

要件

  • Python 3.11+

  • Yandex Tracker APIトークン

  • 組織ID (Organization ID)

ライセンス

MIT

This server cannot be deployed

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • YouTrack MCP Server

    devstroop
    F
    license
    Not graded
    quality
    Not graded
    maintenance
    Enables AI assistants to interact with JetBrains YouTrack 2025.2 for managing issues, sprints, dependencies, time tracking, and knowledge base content. Supports CRUD operations, bulk commands, analytics with Gantt charts and critical path analysis, and covers ~80% of the YouTrack REST API.
    24
    52
    -

  • Yandex Tracker MCP Server

    zolkinka
    F
    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.
    -

  • yandex-tracker-mcp

    brekhov-ilya
    A
    license
    Not graded
    quality
    C
    maintenance
    MCP server for Yandex Tracker API, enabling AI assistants to search, read, create, and edit issues, as well as manage comments, attachments, and links in Yandex Tracker.
    48
    1
    MIT