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

📚 ドキュメント

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

認証情報の取得方法:

OAuthトークン: Yandex OAuth
Org ID: Tracker → 管理 → 組織 → ID
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

YaTracker Connector

YaTracker Connector

🚀 クイックスタート

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

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

📚 ドキュメント

🔧 機能

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

Python API

Claude Code用MCPサーバー

MCPツール

タスク操作

コメント

遷移とステータス

添付ファイル

メタデータ

🤝 チーム向け

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

🔐 設定

認証情報の取得方法:

📦 プロジェクト構造

利用可能なキュー

要件

ライセンス

Resources

Looking for Admin?

Latest Blog Posts

MCP directory API