Skip to main content
Glama
YaTracker Connector

YaTracker Connector

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

📚 ドキュメント

  • 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

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