### Run tracker-mcp setup wizard

Source: https://github.com/sdamarketing/tracker_mcp/blob/main/README.md

Runs the interactive setup wizard that asks for Tracker keys, validates them against the API, and configures selected AI clients.

```bash
npm run setup
```

--------------------------------

### Install tracker-mcp globally via npm and run setup

Source: https://github.com/sdamarketing/tracker_mcp/blob/main/README.md

Installs the tracker-mcp package globally and runs the interactive setup wizard to configure Tracker keys and AI client. After installation, the server is available as the 'tracker-mcp' command.

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

--------------------------------

### One-command installation script

Source: https://github.com/sdamarketing/tracker_mcp/blob/main/docs/SETUP.md

Downloads and runs the installation script for macOS/Linux/WSL. It checks the system, installs Node.js via nvm if needed, downloads the server to ~/.traker-mcp, builds and tests it, and runs the client setup wizard. Re-running updates the server.

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

--------------------------------

### One-command installation via curl pipe to bash

Source: https://github.com/sdamarketing/tracker_mcp/blob/main/README.md

Downloads and runs the installation script. It checks the system, installs Node.js via nvm if needed (asks consent, no sudo), downloads the server to ~/.traker-mcp, builds and verifies it, then runs the setup wizard. Re-running the same command updates the server without touching client configs.

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

--------------------------------

### Install Node.js on Ubuntu/Debian

Source: https://github.com/sdamarketing/tracker_mcp/blob/main/docs/SETUP.md

Installs Node.js 22.x on Ubuntu/Debian using the NodeSource setup script and apt. Run this only if node -v is not found.

```bash
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs
```

--------------------------------

### Build tracker-mcp from source

Source: https://github.com/sdamarketing/tracker_mcp/blob/main/README.md

Clones the repository, installs dependencies, builds the server, and runs a smoke test that should output 'OK: ... 187 tools listed'.

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

--------------------------------

### Установка tracker-mcp через npm и запуск setup

Source: https://github.com/sdamarketing/tracker_mcp/blob/main/docs/quickstart.ru.mdx

Альтернативный способ установки через npm: глобальная установка пакета tracker-mcp и запуск команды setup для настройки.

```bash
npm install -g tracker-mcp
tracker-mcp setup
```

--------------------------------

### Install yandex-tracker skill with npx skills add

Source: https://github.com/sdamarketing/tracker_mcp/blob/main/README.md

Installs the yandex-tracker skill into all detected AI agents (Claude Code, Cursor, opencode, Codex, and 75+ others). The setup master (npm run setup) also offers to install the skill.

```bash
npx skills add sdamarketing/tracker_mcp
```

--------------------------------

### Check Node.js version with node -v

Source: https://github.com/sdamarketing/tracker_mcp/blob/main/docs/SETUP.md

Checks whether Node.js is already installed. A response like v20.x.x or v22.x.x means it is ready; if the command is not found, install Node.js first.

```bash
node -v
```

--------------------------------

### Manual build commands

Source: https://github.com/sdamarketing/tracker_mcp/blob/main/docs/SETUP.md

Clones the repository, installs dependencies, builds the server, and runs a smoke test. The smoke test should output 'OK: ... 187 tools listed' and does not call the API, so it can be run without a token.

```bash
git clone <адрес-репозитория>   # или скачайте ZIP и распакуйте
cd traker_mcp
npm install                     # подтянет зависимости
npm run build                   # соберёт сервер в dist/
npm run smoke                   # проверит его: "OK: ... 187 tools listed"
```

--------------------------------

### Обновление через npm: npm install -g tracker-mcp@latest

Source: https://github.com/sdamarketing/tracker_mcp/blob/main/docs/faq.ru.mdx

Команда для обновления tracker-mcp при установке через npm i -g.

```bash
npm install -g tracker-mcp@latest
```

--------------------------------

### Generate install links

Source: https://github.com/sdamarketing/tracker_mcp/blob/main/docs/SETUP.md

Prompts for token and org ID (or reads from .env) and opens install-links.html in the browser. The page provides buttons for VS Code, Cursor, and Claude Desktop, and copyable configuration blocks for other clients.

```bash
npm run links
```

--------------------------------

### Ручная сборка из исходников

Source: https://github.com/sdamarketing/tracker_mcp/blob/main/docs/installation.ru.mdx

Клонирование репозитория, установка зависимостей, сборка и запуск мастера настройки. Альтернативно можно использовать npm run setup.

```bash
git clone https://github.com/sdamarketing/tracker_mcp.git ~/traker-mcp
cd ~/traker-mcp
npm install && npm run build
tracker-mcp setup    # или npm run setup
```

--------------------------------

### Start HTTP server with tracker-mcp serve

Source: https://github.com/sdamarketing/tracker_mcp/blob/main/README.md

Starts the MCP server in HTTP mode on port 3407 and host 127.0.0.1. Optionally set MCP_AUTH_TOKEN for Bearer authentication. Health check endpoint returns {"ok":true,"tools":187}.

```bash
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}
```

--------------------------------

### Update server with git pull, npm install, npm run build

Source: https://github.com/sdamarketing/tracker_mcp/blob/main/docs/SETUP.md

Run these commands to update the server after pulling changes. The server restarts on each launch, so a rebuild is picked up automatically.

```bash
git pull
npm install
npm run build
```

--------------------------------

### Запуск мастера установки tracker-mcp setup

Source: https://github.com/sdamarketing/tracker_mcp/blob/main/docs/clients.ru.mdx

Команда запускает интерактивный мастер, который спрашивает клиента стрелочным селектором и автоматически записывает конфигурацию в нужное место.

```bash
tracker-mcp setup
```

--------------------------------

### Установка и команды npm

Source: https://github.com/sdamarketing/tracker_mcp/blob/main/docs/installation.ru.mdx

Глобальная установка через npm. Команда tracker-mcp без аргументов запускает MCP-сервер по stdio, setup — интерактивный мастер, links — страница с кнопками установки, serve — HTTP-режим.

```bash
npm install -g tracker-mcp
tracker-mcp setup    # интерактивный мастер (ключи + выбор клиента)
tracker-mcp links    # страница с кнопками установки в один клик
tracker-mcp serve    # HTTP-режим (см. страницу HTTP-сервер)
```

--------------------------------

### Команды разработки npm (typecheck, build, smoke, setup, links)

Source: https://github.com/sdamarketing/tracker_mcp/blob/main/README.md

Набор команд для разработки проекта tracker_mcp: проверка типов, сборка в dist/, запуск smoke-теста без обращения к API, интерактивный мастер установки и страница с deeplinks. Команды выполняются в корне проекта.

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

--------------------------------

### GET /health

Source: https://github.com/sdamarketing/tracker_mcp/blob/main/docs/http-server.ru.mdx

Health check endpoint for the HTTP server, used for monitoring and Kubernetes probes.

```APIDOC
## GET /health

### Description
Returns a health check response for the HTTP server, useful for Kubernetes liveness probes and monitoring.

### Method
GET

### Endpoint
/health

### Response
#### Success Response (200)
- **ok** (boolean) - Indicates the server is healthy.
- **server** (string) - The name of the server, e.g., "yandex-tracker".
- **tools** (integer) - The number of available tools.

#### Response Example
{
  "ok": true,
  "server": "yandex-tracker",
  "tools": 187
}
```

--------------------------------

### Настройка MCP для Zed: context_servers

Source: https://github.com/sdamarketing/tracker_mcp/blob/main/docs/SETUP.md

Конфигурация MCP-сервера для Zed. Добавляется в settings.json через zed: open settings. В Zed command — строка, аргументы передаются массивом args. При первом вызове Zed запросит разрешение.

```json
{
  "context_servers": {
    "yandex-tracker": {
      "command": "node",
      "args": ["/ПОЛНЫЙ/ПУТЬ/К/traker_mcp/dist/index.js"],
      "env": {
        "TRACKER_TOKEN": "y0__ВАШ_ТОКЕН",
        "TRACKER_ORG_ID": "12345678"
      }
    }
  }
}
```

--------------------------------

### GET/POST/DELETE /mcp

Source: https://github.com/sdamarketing/tracker_mcp/blob/main/docs/http-server.ru.mdx

Main MCP endpoint for Streamable HTTP communication, supporting GET, POST, and DELETE methods.

```APIDOC
## GET/POST/DELETE /mcp

### Description
Main MCP endpoint supporting Streamable HTTP (SSE or JSON). Used for MCP client-server communication.

### Method
GET, POST, DELETE

### Endpoint
/mcp

### Authentication
Requires `Authorization: Bearer <MCP_AUTH_TOKEN>` header if `MCP_AUTH_TOKEN` is set.

### Response
Returns MCP Streamable HTTP responses (SSE or JSON).
```

--------------------------------

### Настройка MCP для Claude Desktop: claude_desktop_config.json

Source: https://github.com/sdamarketing/tracker_mcp/blob/main/docs/SETUP.md

Конфигурация MCP-сервера для Claude Desktop. Файл находится в ~/Library/Application Support/Claude/claude_desktop_config.json (macOS), %APPDATA%\Claude\claude_desktop_config.json (Windows) или ~/.config/Claude/claude_desktop_config.json (Linux). Если файл уже содержит данные, добавьте только содержимое mcpServers.

```json
{
  "mcpServers": {
    "yandex-tracker": {
      "command": "node",
      "args": ["/ПОЛНЫЙ/ПУТЬ/К/traker_mcp/dist/index.js"],
      "env": {
        "TRACKER_TOKEN": "y0__ВАШ_ТОКЕН",
        "TRACKER_ORG_ID": "12345678"
      }
    }
  }
}
```

--------------------------------

### Запуск Docker-контейнера в HTTP-режиме

Source: https://github.com/sdamarketing/tracker_mcp/blob/main/docs/installation.ru.mdx

Запускает контейнер с HTTP-сервером на порту 3407. Требует переменные TRACKER_TOKEN, TRACKER_ORG_ID и MCP_AUTH_TOKEN для аутентификации.

```bash
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
```

--------------------------------

### Run tracker-mcp via Docker in HTTP mode

Source: https://github.com/sdamarketing/tracker_mcp/blob/main/README.md

Runs the tracker-mcp server in HTTP mode, exposing port 3407 and requiring an MCP_AUTH_TOKEN. The server is started with the 'serve' command.

```bash
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
```

--------------------------------

### CI/CD: Mermaid flowchart TD

Source: https://github.com/sdamarketing/tracker_mcp/blob/main/docs/architecture.ru.mdx

Диаграмма CI/CD: push в main запускает ci.yml (build+typecheck+smoke+e2e, docs:check, gitleaks на Node 20/22/24), тег v* запускает publish-npm.yml, docker.yml (ghcr) и publish-registry.yml (MCP Registry), при этом npm и docker ведут в registry.

```mermaid
flowchart TD
    Push[push в main] --> CI[ci.yml: build+typecheck+smoke+e2e\ndocs:check + gitleaks\n на Node 20/22/24]
    Tag[тег v*] --> N[publish-npm.yml]
    Tag --> D[docker.yml → ghcr]
    Tag --> R[publish-registry.yml → MCP Registry]
    N --> R
    D --> R
```

--------------------------------

### resources/read - tracker://queue/{KEY}

Source: https://github.com/sdamarketing/tracker_mcp/blob/main/docs/resources-prompts.ru.mdx

Читает ресурс tracker://queue/{KEY} и возвращает информацию об очереди: владелец, дефолтный тип/приоритет и обязательные поля создания задач.

```APIDOC
## resources/read

### Description
Читает ресурс tracker://queue/{KEY} и возвращает информацию об очереди: владелец, дефолтный тип/приоритет и обязательные поля создания задач.

### Method
resources/read

### URI
`tracker://queue/{KEY}`

### Parameters
#### Path Parameters
- **KEY** (string) - Required - Ключ очереди (например, TEST)

### Response
#### Success Response
- **content** (array) - Список контент-блоков, каждый содержит markdown-текст с информацией об очереди.

#### Response Example
```json
{
  "content": [
    {
      "type": "text",
      "text": "# Очередь TEST\n\nВладелец: admin\nДефолтный тип: Задача\nДефолтный приоритет: Средний\n\nОбязательные поля:\n- summary\n- type"
    }
  ]
}
```
```

--------------------------------

### Конфигурация MCP-клиента для Docker (stdio)

Source: https://github.com/sdamarketing/tracker_mcp/blob/main/docs/installation.ru.mdx

JSON-конфигурация для MCP-клиента, который сам запускает контейнер. Переменные TRACKER_TOKEN и TRACKER_ORG_ID передаются в контейнер.

```json
{
  "mcpServers": {
    "yandex-tracker": {
      "command": "docker",
      "args": ["run", "-i", "--rm",
        "-e", "TRACKER_TOKEN", "-e", "TRACKER_ORG_ID",
        "ghcr.io/sdamarketing/tracker-mcp:latest"]
    }
  }
}
```

--------------------------------

### Проверка MCP в Claude Code: claude mcp list/get

Source: https://github.com/sdamarketing/tracker_mcp/blob/main/docs/SETUP.md

Проверка подключения MCP-сервера в Claude Code. Команда claude mcp list показывает статус Connected, claude mcp get выводит детали. Внутри сессии Claude Code доступна команда /mcp.

```bash
claude mcp list      # напротив yandex-tracker должно быть ✔ Connected
claude mcp get yandex-tracker
```

--------------------------------

### Настройка MCP для opencode: opencode.json

Source: https://github.com/sdamarketing/tracker_mcp/blob/main/docs/SETUP.md

Конфигурация MCP-сервера для opencode. Добавляется в opencode.json (в проекте или глобально). Использует тип local и массив command. После перезапуска проверка: opencode mcp list или запрос агенту.

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "yandex-tracker": {
      "type": "local",
      "command": ["node", "/ПОЛНЫЙ/ПУТЬ/К/traker_mcp/dist/index.js"],
      "enabled": true,
      "environment": {
        "TRACKER_TOKEN": "y0__ВАШ_ТОКЕН",
        "TRACKER_ORG_ID": "12345678"
      }
    }
  }
}
```

--------------------------------

### Установка tracker-mcp одной командой (curl | bash)

Source: https://github.com/sdamarketing/tracker_mcp/blob/main/docs/quickstart.ru.mdx

Устанавливает tracker-mcp одной командой на macOS/Linux/WSL. Установщик выводит фирменный баннер, проверяет Node.js (при необходимости ставит через nvm), скачивает и собирает сервер в ~/.traker-mcp, затем запускает интерактивный мастер настройки. Повторный запуск той же команды обновляет сервер.

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

```text
  ┌───────────────────────────────────────────────────────────────────┐
  │ __     __             _        _______             _               │
  │ \ \   / /            | |      |__   __|           | |              │
  │  \ \_/ /_ _ _ __   __| | ___     | |_ __ __ _  ___| | _____ _ __   │
  │   \   / _` | '_ \ / _` |/ _ \    | | '__/ _` |/ __| |/ / _ \ '__|  │
  │    | | (_| | | | | (_| |  __/    | | | | (_| | (__|   <  __/ |     │
  │    |_|\__,_|_| |_|\__,_|\___|    |_|_|  \__,_|\___|_|\_\___|_|     │
  │                                                                   │
  │              v1.0.8 · MCP-сервер для Яндекс Трекера               │
  │              Автор: Александр Хмара (@sdamarketing)                │
  │          Исходники: github.com/sdamarketing/tracker_mcp           │
  └───────────────────────────────────────────────────────────────────┘
```

--------------------------------

### prompts/get - standup

Source: https://github.com/sdamarketing/tracker_mcp/blob/main/docs/resources-prompts.ru.mdx

Готовый сценарий для ежедневного стендапа: что сделано, что в работе, какие блокеры по задачам пользователя.

```APIDOC
## prompts/get

### Description
Возвращает готовый промпт для сценария standup: сделал / делаю / блокеры по задачам пользователя.

### Method
prompts/get

### Arguments
- **user** (string) - Optional - Имя пользователя (например, "bob")

### Response
#### Success Response
- **description** (string) - Описание промпта
- **messages** (array) - Список сообщений с подставленными аргументами

#### Response Example
```json
{
  "description": "Standup: сделал / делаю / блокеры",
  "messages": [
    {
      "role": "user",
      "content": {
        "type": "text",
        "text": "Собери стендап для пользователя bob"
      }
    }
  ]
}
```
```

--------------------------------

### Docker production-запуск tracker-mcp

Source: https://github.com/sdamarketing/tracker_mcp/blob/main/docs/http-server.ru.mdx

Запускает контейнер tracker-mcp в production-режиме с пробросом порта 3407, передачей токенов и read-only режимом. Генерирует случайный MCP_AUTH_TOKEN через openssl.

```bash
docker run -d \
  --name tracker-mcp \
  -p 3407:3407 \
  -e TRACKER_TOKEN=... \
  -e TRACKER_ORG_ID=... \
  -e MCP_AUTH_TOKEN=$(openssl rand -base64 32) \
  -e TRACKER_READ_ONLY=1 \
  ghcr.io/sdamarketing/tracker-mcp \
  serve --host 0.0.0.0 --port 3407
```

--------------------------------

### Загрузка Docker-образа

Source: https://github.com/sdamarketing/tracker_mcp/blob/main/docs/installation.ru.mdx

Образ публикуется в GitHub Container Registry при каждом релизе по тегу v*. Команда pull загружает последнюю версию.

```bash
docker pull ghcr.io/sdamarketing/tracker-mcp:latest
```