Yandex Tracker

Name: Yandex Tracker
Author: sdamarketing

ローカル

github.com/sdamarketing生産性12 週間前に更新

リポジトリ

Yandex Tracker について

Yandex Tracker は、AI アシスタントから API v3 経由で Yandex Tracker を操作する MCP サーバーです。187個のツールに加え、課題、キュー、ボード、カタログのリソースと、一般的なワークフロー向けプロンプトを備えています。

主な機能

01Tracker API v3を網羅する187個のツール
02課題、コメント、ファイル、作業時間の管理
03キュー、ボード、スプリント、プロジェクトの操作
04課題とカタログのリソース読み取り
05トリアージやレポート用プロンプト
06読み取り専用モードとリスク操作の確認

活用シーン

01Tracker課題の検索、作成、更新
02スプリントの確認とボード作業の管理
03課題のトリアージや週次レポートの作成
04連携を読み取り専用に制限

MCP 対応

Tracker の操作を MCP ツールとして公開し、課題などのコンテキストを tracker:// リソースで提供します。トリアージや週次レポートなどのプロンプトも備え、stdio と認証付き Streamable HTTP に対応します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定

{
  "mcpServers": {
    "sdamarketing-tracker": {
      "command": "npx",
      "args": [
        "-y",
        "tracker-mcp"
      ],
      "env": {
        "TRACKER_TOKEN": "<TRACKER_TOKEN>",
        "TRACKER_ORG_ID": "<TRACKER_ORG_ID>",
        "TRACKER_AUTH": "<TRACKER_AUTH>"
      }
    }
  }
}

起動コマンドnpx -y tracker-mcp

設定が必要な環境変数

TRACKER_TOKENシークレットOAuth-токен Яндекс 360 (y0_...) или IAM-токен Yandex Cloud (t1....)

TRACKER_ORG_IDID организации (Яндекс 360 или Yandex Cloud)

TRACKER_AUTHシークレットСхема авторизации: oauth (Яндекс 360) или iam (Yandex Cloud)

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ

npmtracker-mcp1.2.0stdio

ocighcr.io/sdamarketing/tracker-mcp:1.2.0stdio

ツール

187

掲載時のツール一覧 · 2 週間前に更新

パラメーター	型	必須	説明
keys	any	いいえ	issue キー、または issue キーのリスト
page	number	いいえ	ページ番号。デフォルトは 1
order	string	いいえ	ソート順（"filter" との併用時のみ）：[+/-]FIELD。例："+updatedAt"
query	string	いいえ	Tracker クエリ言語でのクエリ。例：'Queue: TREK Resolution: empty()'
queue	string	いいえ	キューキー。例："TREK"
expand	string	いいえ	含める追加データをカンマ区切りで指定します："transitions"、"attachments"、"comments"
fields	string	いいえ	レスポンスに含める issue フィールドのカンマ区切りリスト
filter	object	いいえ	フィルターオブジェクト：フィールド名 -> 値。例：{"queue": "TREK", "assignee": "user1"}
query2	object	いいえ	Query language 2.0 オブジェクト
perPage	number	いいえ	ページあたりの結果数。デフォルトは 50
filterId	number	いいえ	保存済みフィルター ID
scrollId	string	いいえ	前回のレスポンスに含まれるスクロールページ ID
perScroll	number	いいえ	スクロールページあたりの issue 数の上限（デフォルト 100、最大 1000）
scrollType	enum	いいえ	大量の結果セットで結果のスクロールを有効にします："sorted" は順序を維持し、"unsorted" は負荷が低くなります。最初のリクエストのみ指定します。sorted \| unsorted
scrollTTLMillis	number	いいえ	スクロールコンテキストの有効期間（ms、デフォルト 60000）

詳細

traker-mcp — Яндекс トラッカー向け MCP サーバー

簡単に言うと、このサーバーは AI アシスタントに Яндекс トラッカーの使い方を教えます。 「自分のタスクを探して」「キュー TREK にタスクを作成して」「TASK-123 を解決済みとしてクローズして」とアシスタントに伝えると、リンクを手作業でコピーすることなく、アシスタントがトラッカーの API を通じて処理します。

あらゆる MCP クライアントで動作します：VS Code (Copilot)、Cursor、Claude Desktop、 Claude Code、opencode、Windsurf、Zed、JetBrains AI Assistant、Grok CLI。

📘 初心者向けの詳しいガイド（トークンの取得、各クライアントの手順に沿った設定、問題の解決）は、docs/SETUP.md をご覧ください。

ドキュメント

ドキュメントサイト（docs7）と Context7 の LLM インデックス： context7.com/sdamarketing/tracker_mcp。

セクション	内容
はじめに	概要、クイックスタート、インストール、クライアント
運用	ツール、リソースとプロンプト、HTTP サーバー、セキュリティ
機能ガイド	タスク · コメント／チェックリスト／作業ログ／ファイル · キュー · ボードとスプリント · プロジェクト／目標／ポートフォリオ · 自動化 · 管理 · アーキテクチャ
リファレンス	SETUP · API 対応状況 · トラブルシューティング · FAQ

その他：CHANGELOG と skills.sh スキル。

リソースとプロンプト（MCP）

ツールに加えて、サーバーは以下を提供します。

Resources（resources/list、resources/read）— ツールを呼び出さずにコンテキストを読み取るための tracker:// URI：
- tracker://issue/{KEY} — 説明と直近 20 件のコメントを含むタスクカード（markdown）；
- tracker://queue/{KEY} — キューと、タスク作成時の必須フィールド；
- tracker://board/{ID} — 列とステータスを含むボード；
- tracker://catalog/statuses|priorities|types|resolutions|linktypes — リファレンスデータ（ツールと TTL キャッシュを共有）；
- tracker://myself — プロフィール。
Prompts（prompts/list、prompts/get）— 引数付きのすぐに使えるシナリオ：standup、weekly-report、triage、sprint-review、close-issue、create-issue。プロンプトに対応するクライアントでは、スラッシュコマンドとして呼び出せます。

できること

187 個のツールで、API トラッカー v3を完全にカバーしています。

カテゴリ	できること
タスク	検索（フィルター、クエリ言語、query 2.0、scroll >10k、候補表示）、作成、読み取り、編集、移動、ステータス変更、リンク、履歴
コメント	追加、読み取り（一覧および個別）、編集、削除、リアクション
チェックリスト	タスク＋プロジェクト／ポートフォリオ：追加、チェック、移動、削除
時間の記録	タスクごとの記録、作成者／日付による検索
添付ファイル	一覧、メタデータ、ダウンロード（画像／テキスト／データベース）、サムネイル、アップロード、一時ファイル
一括操作	タスクの編集、移動、クローズ、プロジェクト／目標の一括更新
レポートとフィルター	ウィジェット用の保存済みレポート、保存済みフィルターの CRUD
キュー	CRUD（削除／復元を含む）、アクセス権、バージョン、コンポーネント、ローカルフィールド、マクロ、タグ
自動化	トリガーと自動アクション（CRUD＋ログ）、ワークフロー（ステータスと遷移）
ボード	CRUD、ページネーション、列の CRUD、スプリント（作成／開始／アーカイブ）
ダッシュボード	ダッシュボードとウィジェット（「サイクル時間」）の作成
プロジェクト、目標、ポートフォリオ	CRUD、コメント、チェックリスト、添付ファイル、リンク、イベント、権限、主要な結果とメトリクス（fields 経由）
参照データ	読み取りと書き込み：タイプ、ステータス、優先度、解決策、グローバルフィールドとカテゴリ
外部アプリケーション	タスクと外部システム（Jira など）のリンク
不在	休暇／病欠／出張（admin）
移行	タスク／コメント／リンク／作業時間／添付ファイルの「過去の日付での」インポート（admin）

エージェント向けの安全性

各ツールにはMCP アノテーションが付いています。読み取りには readOnlyHint、すべての delete_* には destructiveHint が付いており、クライアントはこれらを確認が必要な／安全な操作として表示します。
すべての delete_* と bulk_* には confirm: true が必要です（エージェントは削除する内容を先に表示します）。
TRACKER_READ_ONLY=1 を設定すると、サーバーは読み取り専用の 80 個のツールのみを提供し、書き込み機能は完全に非表示になります。「見るだけ」の連携に適しています。

AI エージェント向けスキル（skills.sh）

サーバーには**yandex-tracker スキル**が付属しています。エージェント向けの手順に関する知識として、トラッカーのクエリ言語、フィールドの正しい値（優先度、ステータス、解決策）、レシピ（「自分のタスクを検索」「解決策を指定してクローズ」「一括編集」）、API の落とし穴（dueDate と releaseDate の違い、クローズ時に解決策が必須、IAM トークンは 12 時間以下）が含まれます。

npx skills add sdamarketing/tracker_mcp

検出されたすべてのエージェント（Claude Code、Cursor、opencode、 Codex など、ほか 75 以上）にスキルをインストールします。npm run setup ウィザードでも、 MCP クライアントの設定とあわせてスキルのインストールを提案します。スキルのリポジトリ：skills.sh/sdamarketing/tracker_mcp。

1 コマンドでインストール（macOS / Linux / WSL）

curl -fsSL https://raw.githubusercontent.com/sdamarketing/tracker_mcp/main/install.sh | bash

スクリプトが自動で、システムを確認し → Node.js がなければ nvm 経由でインストールし（同意を確認し、sudo は不要）→ サーバーを ~/.traker-mcp にダウンロードし → ビルドして検証し → セットアップウィザードを起動します。ウィザードでは、トラッカーのキー（入力は非表示）、API でのキーの検証、AI クライアントの選択（VS Code、Cursor、Claude Desktop、 Claude Code、opencode、Windsurf、Zed、JetBrains、Grok CLI）を行います。grok コマンドがすでにある場合は、ウィザードがメニューを表示する前に、サーバーを ~/.grok/config.toml に登録します。

同じコマンドを再実行するとサーバーが更新されます（クライアントの設定は変更されません）。

🔎 先にスクリプトを確認したい場合は、| bash を取り除いて出力を確認してください： curl -fsSL https://raw.githubusercontent.com/sdamarketing/tracker_mcp/main/install.sh

🪟 Windows： 上記のコマンドを使って WSL 経由でインストールするか、手動でインストールしてください。詳細は以下をご覧ください。

npm からインストール（クローン不要）

npm install -g tracker-mcp
tracker-mcp setup     # интерактивный мастер: ключи Трекера + настройка AI-клиента

これで、サーバーを tracker-mcp コマンドから利用できるようになります（AI クライアントの設定にこのコマンドを記述してください）。その他のコマンド：tracker-mcp update、tracker-mcp links、 tracker-mcp --help。

Official MCP Registry

サーバーは、公式 MCP レジストリに io.github.sdamarketing/tracker-mcp として公開されています（npm パッケージと Docker パッケージがあり、環境変数は server.json に記載されています）。レジストリに対応したクライアントは、名前で検索できます。

Docker（Docker 以外のインストール不要）

イメージは、リリースのたびに GitHub Container Registry に公開されます（v*-tag）：

# stdio (MCP-клиент запускает контейнер сам)
docker run -i --rm -e TRACKER_TOKEN -e TRACKER_ORG_ID ghcr.io/sdamarketing/tracker-mcp

# HTTP-режим
docker run --rm -p 3407:3407 -e TRACKER_TOKEN -e TRACKER_ORG_ID \
  -e MCP_AUTH_TOKEN=вашключ ghcr.io/sdamarketing/tracker-mcp serve --host 0.0.0.0

エージェントの設定では、command: node の代わりに command: docker, args: ["run","-i","--rm","-e","TRACKER_TOKEN","-e","TRACKER_ORG_ID","ghcr.io/sdamarketing/tracker-mcp"] を使用します。

手動インストール（Windows または curl を使わない場合）

ステップ 1. Node.js 20 以降がインストールされていることを確認します（node -v で確認できます）。

ステップ 2. サーバーをビルドします：

git clone <адрес-этого-репозитория>
cd traker_mcp
npm install
npm run build
npm run smoke   # проверка: должно быть "OK: ... 187 tools listed"

ステップ 3. トラッカーから次の 2 つを用意します：

トークン — 取得方法：docs/SETUP.md、セクション 3
組織 ID — 確認方法：docs/SETUP.md、セクション 4

ステップ 4. セットアップウィザードを起動します：

npm run setup

ウィザードではキーを入力します（トークンは非表示入力です）。キーをトラッカーの API で検証し、クライアントのインタラクティブメニュー（↑↓ + Enter）を表示します。選択したクライアントを（複数を続けて選択できます）、CLI を使うか、バックアップを作成して設定ファイルに追記して設定し、最後にレポートを出力します。

別の方法として、npm run links を実行すると、ワンクリックでインストールできるボタン（VS Code、Cursor、Claude Desktop）と、手動コピー用のすべてのクライアント設定を含むページがブラウザーで開きます。

エージェントへの接続

エージェント	簡単な方法	設定ファイル
VS Code（Copilot）	`npm run setup`（CLI `code`）	`.vscode/mcp.json`
Cursor	`npm run setup`	`~/.cursor/mcp.json`
Claude Desktop	`npm run setup`	`claude_desktop_config.json`
Claude Code（ターミナル）	`npm run setup`（CLI `claude`）	`~/.claude.json`
opencode	`npm run setup`	`~/.config/opencode/opencode.json`
Windsurf	`npm run setup`	`~/.codeium/windsurf/mcp_config.json`
Zed	`npm run setup`	`settings.json`（`context_servers`）
JetBrains IDE	`npm run setup`	プロジェクトのルートにある `.mcp.json`
Grok CLI	`npm run setup`（`grok` があれば自動設定）	`~/.grok/config.toml`

macOS／Windows／Linux での正確なパスを含む手順については、docs/SETUP.md をご覧ください。

動作確認

インストール後、エージェントを再起動して、次のように尋ねます：

「get_current_user ツールを呼び出して」— トラッカーのプロフィールが返されます。「トラッカーで自分のタスクを探して」— find_issues が実行されます。

よくある問題

症状	原因と解決方法
`Missing required environment variable TRACKER_TOKEN`	トークンが渡されていません。リンクを再生成（`npm run links`）するか、設定の `env` を確認してください
`Yandex Tracker API error 401`	トークンが無効か、有効期限が切れています（IAM の有効期間は 12 時間以内です）
`Yandex Tracker API error 403: Organization is not available`	`TRACKER_ORG_ID` が無効か、組織がトラッカーに接続されていません
Claude Desktop（macOS）でサーバーが起動しない	node の絶対パスを使用してください。生成された設定ではすでに絶対パスが使われています
エージェントにツールが表示されない	サーバーが無効になっています。クライアントの MCP サーバー一覧で有効にして、再起動してください

その他の解決方法については、docs/SETUP.md、セクション 8 をご覧ください。

サーバーの設定

変数	必須	説明
`TRACKER_TOKEN`	はい	OAuth トークン（`y0_...`、Яндекс 360）または IAM トークン（`t1....`、Yandex Cloud）
`TRACKER_ORG_ID`	はい	組織 ID
`TRACKER_AUTH`	いいえ	`oauth`（デフォルト）または `iam` — `X-Org-ID`／`X-Cloud-Org-ID` ヘッダーを決定します
`TRACKER_API_URL`	いいえ	デフォルトは `https://api.tracker.yandex.net/v3`
`TRACKER_LANG`	いいえ	`ru` または `en` — ローカライズされたフィールドの言語
`TRACKER_READ_ONLY`	いいえ	`1` — エージェントには読み取り専用ツールのみ（80 個）が表示されます
`TRACKER_CACHE_TTL_MS`	いいえ	参照データのキャッシュ TTL（デフォルトは 10 分）

HTTP-режим (`serve`)

По умолчанию сервер работает по stdio (для локальных агентов). Для сетевого доступа (команда, удалённый клиент, проксирование):

tracker-mcp serve --port 3407 --host 127.0.0.1   # значения по умолчанию
MCP_AUTH_TOKEN=s3cret tracker-mcp serve            # ключ к эндпоинту (Bearer)
curl localhost:3407/health                         # {"ok":true,"tools":187}

Эндпоинт MCP: POST/GET/DELETE /mcp (Streamable HTTP, stateless)
Без MCP_AUTH_TOKEN привязка к не-loopback-адресу отклоняется — токен Трекера живёт в env, голый порт в сети недопустим
Конфиг клиента для HTTP: "url": "http://127.0.0.1:3407/mcp" + "headers": {"Authorization": "Bearer s3cret"}

Безопасность

Токен даёт агенту те же права, что у вас в Трекере. Выдавайте минимальные права (для чтения хватит tracker:read).
Храните токен в .env (уже в .gitignore) или в конфиге клиента, не в коде.
install-links.html содержит токен — скрипт добавляет его в .gitignore сам.

Разработка

npm run typecheck   # проверка типов
npm run build       # сборка в dist/
npm run smoke       # запуск и список инструментов без обращения к API
npm run setup       # интерактивный мастер установки для AI-клиентов
npm run links       # страница с кнопками установки (deeplinks)

Архитектура и полный список инструментов — в docs/SETUP.md и в коде src/tools/.

Лицензия и поддержка

Проблемы и идеи — в issues репозитория. API Трекера меняется — следите за официальной документацией.

Markdown 対応

ログインしてコメント

基本情報

作者: sdamarketing
言語: node
バージョン: 1.2.0
トランスポート: stdio
掲載日: 2026年10月13日
最終更新: 2 週間前
公式 Registry: io.github.sdamarketing/tracker-mcp

問題を報告

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

入門ガイドを読む

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。