Установка в вашем ИИ-клиенте¶

Подключите MCP-сервер ycli к ИИ-клиенту, которым вы уже пользуетесь. Каждый клиент получает один и тот же сервер под именем yandex-360 и одни и те же два значения.

Перед началом¶

Установите uv: каждый фрагмент ниже запускает сервер через uvx, который скачивает ycli при первом использовании.

Получите два значения (см. Аутентификация):

Переменная	Что это
`YANDEX_ID_OAUTH_TOKEN`	OAuth-токен Яндекса с доступом к Трекеру, Вики и Формам
`YANDEX_ID_ORGANIZATION_ID`	идентификатор вашей организации Яндекс 360

Клиент, который читает их из окружения, должен получить их экспортированными в той оболочке, которая его запускает:
```
export YANDEX_ID_OAUTH_TOKEN=...
export YANDEX_ID_ORGANIZATION_ID=...
```

Ни один фрагмент на этой странице не хранит значения: каждый ссылается на переменную или спрашивает значение у вас.

Выберите клиент¶

Клиент	В один клик	Файл конфигурации	Команда
Claude Code	плагин	`.mcp.json`	`claude mcp add`
Claude Desktop	пакет `.mcpb`	`claude_desktop_config.json`
Cursor	ссылка для установки	`mcp.json`
VS Code	ссылка для установки	`.vscode/mcp.json`	`code --add-mcp`
Windsurf (Devin Desktop)		`mcp_config.json`	`devin mcp add`
Zed		`settings.json`
Codex		`config.toml`	`codex mcp add`
Gemini CLI		`settings.json`
opencode		`opencode.json`
ChatGPT
Любой другой клиент		собственный файл клиента

Предпочитаете контейнер вместо uv? См. Docker. Что-то не работает? См. Если не работает.

Claude Code¶

В один кликФайл конфигурацииКоманда

Плагин ставит сервер и четыре навыка вместе, с версией, равной версии плагина:

/plugin marketplace add bim-ba/ycli
/plugin install yandex-360@ycli

.mcp.json в корне проекта (общий для команды; Claude Code подставляет ${VAR} при запуске сервера):

{
  "mcpServers": {
    "yandex-360": {
      "type": "stdio",
      "command": "uvx",
      "args": ["--from", "yandex-cli[mcp]", "ycli", "mcp", "start"],
      "env": {
        "YANDEX_ID_OAUTH_TOKEN": "${YANDEX_ID_OAUTH_TOKEN}",
        "YANDEX_ID_ORGANIZATION_ID": "${YANDEX_ID_ORGANIZATION_ID}"
      }
    }
  }
}

claude mcp add yandex-360 --transport stdio \
  --env YANDEX_ID_OAUTH_TOKEN='${YANDEX_ID_OAUTH_TOKEN}' \
  --env YANDEX_ID_ORGANIZATION_ID='${YANDEX_ID_ORGANIZATION_ID}' \
  -- uvx --from 'yandex-cli[mcp]' ycli mcp start

Оставьте одинарные кавычки: с двойными ваша оболочка подставит настоящий токен в конфигурацию. Добавьте --scope project, чтобы записать .mcp.json, а не ваши личные настройки.

Проверка: claude mcp get yandex-360 показывает Connected. Проверено в Claude Code 2.1.285 на 2026-10-03: команда и файл подключаются.

Claude Desktop¶

В один кликФайл конфигурации

Скачайте yandex-360-<version>.mcpb из последнего релиза и откройте его или выберите его в Settings → Extensions → Advanced settings → Extension Developer → Install Extension…. Claude Desktop запросит токен (он хранится в связке ключей системы) и идентификатор организации.

Система	Файл
macOS	`~/Library/Application Support/Claude/claude_desktop_config.json`
Windows	`%APPDATA%\Claude\claude_desktop_config.json`

Claude Desktop не читает переменные вашей оболочки, поэтому в этом файле лежат сами значения. Лучше используйте пакет: он хранит токен в связке ключей.

{
  "mcpServers": {
    "yandex-360": {
      "command": "uvx",
      "args": ["--from", "yandex-cli[mcp]", "ycli", "mcp", "start"],
      "env": {
        "YANDEX_ID_OAUTH_TOKEN": "<ваш токен>",
        "YANDEX_ID_ORGANIZATION_ID": "<идентификатор организации>"
      }
    }
  }
}

После любого из изменений полностью закройте Claude Desktop и запустите его снова. Сверено с документацией Claude на 2026-10-03; не запускалось.

Cursor¶

В один кликФайл конфигурации

Установить в Cursor. Некоторые просмотрщики блокируют ссылки cursor://: скопируйте ссылку в адресную строку браузера.

~/.cursor/mcp.json для всех проектов или .cursor/mcp.json для одного:

{
  "mcpServers": {
    "yandex-360": {
      "command": "uvx",
      "args": ["--from", "yandex-cli[mcp]", "ycli", "mcp", "start"],
      "env": {
        "YANDEX_ID_OAUTH_TOKEN": "${env:YANDEX_ID_OAUTH_TOKEN}",
        "YANDEX_ID_ORGANIZATION_ID": "${env:YANDEX_ID_ORGANIZATION_ID}"
      }
    }
  }
}

Ссылка устанавливает ровно тот объект, что во вкладке с файлом (его base64). Сверено с документацией Cursor на 2026-10-03; не запускалось.

VS Code¶

В один кликФайл конфигурацииКоманда

Установить в VS Code. При первом запуске VS Code спросит два значения и скроет токен.

.vscode/mcp.json в рабочей области (для вашего пользовательского профиля выполните MCP: Open User Configuration):

{
  "inputs": [
    { "type": "promptString", "id": "yandex-oauth-token", "description": "Yandex OAuth token", "password": true },
    { "type": "promptString", "id": "yandex-organization-id", "description": "Yandex 360 organization id" }
  ],
  "servers": {
    "yandex-360": {
      "type": "stdio",
      "command": "uvx",
      "args": ["--from", "yandex-cli[mcp]", "ycli", "mcp", "start"],
      "env": {
        "YANDEX_ID_OAUTH_TOKEN": "${input:yandex-oauth-token}",
        "YANDEX_ID_ORGANIZATION_ID": "${input:yandex-organization-id}"
      }
    }
  }
}

В ваш пользовательский профиль, с теми же запросами значений:

code --add-mcp '{"name":"yandex-360","command":"uvx","args":["--from","yandex-cli[mcp]","ycli","mcp","start"],"env":{"YANDEX_ID_OAUTH_TOKEN":"${input:yandex-oauth-token}","YANDEX_ID_ORGANIZATION_ID":"${input:yandex-organization-id}"},"inputs":[{"type":"promptString","id":"yandex-oauth-token","description":"Yandex OAuth token","password":true},{"type":"promptString","id":"yandex-organization-id","description":"Yandex 360 organization id"}]}'

VS Code отправляет в одном запросе не больше 128 инструментов, а у ycli их больше: начните с --toolsets core (добавьте "--toolsets", "core" в args), см. Запуск MCP-сервера. Проверено в VS Code 1.139.1 на 2026-10-03: команда записывает сервер и оба запроса значений в пользовательский профиль. Ссылка и сеанс чата не запускались.

Windsurf (Devin Desktop)¶

Windsurf теперь называется Devin Desktop; оба его агента читают один и тот же файл.

Файл конфигурацииКоманда

Система	Файл
macOS, Linux	`~/.config/devin/mcp_config.json`
Windows	`%APPDATA%\devin\mcp_config.json`

{
  "mcpServers": {
    "yandex-360": {
      "command": "uvx",
      "args": ["--from", "yandex-cli[mcp]", "ycli", "mcp", "start", "--toolsets", "core"],
      "env": {
        "YANDEX_ID_OAUTH_TOKEN": "${env:YANDEX_ID_OAUTH_TOKEN}",
        "YANDEX_ID_ORGANIZATION_ID": "${env:YANDEX_ID_ORGANIZATION_ID}"
      }
    }
  }
}

devin mcp add -s user yandex-360 -- uvx --from 'yandex-cli[mcp]' ycli mcp start --toolsets core

Затем добавьте блок env выше в запись, которую команда создала.

Агент Cascade принимает всего 100 инструментов, поэтому фрагмент отдаёт набор core. Старый Windsurf держит файл в ~/.codeium/windsurf/mcp_config.json. Сверено с документацией Devin на 2026-10-03; не запускалось. Старого пути в текущей документации нет.

Zed¶

Файл конфигурации

Откройте файл настроек (zed: open settings file) или добавьте сервер в Settings → AI → MCP Servers → Add Server → Add Local Server:

{
  "context_servers": {
    "yandex-360": {
      "command": "uvx",
      "args": ["--from", "yandex-cli[mcp]", "ycli", "mcp", "start", "--toolsets", "core"],
      "env": {
        "YANDEX_ID_OAUTH_TOKEN": "<ваш токен>",
        "YANDEX_ID_ORGANIZATION_ID": "<идентификатор организации>"
      }
    }
  }
}

В документации Zed нет способа сослаться здесь на переменную, поэтому в файле лежат сами значения. Сверено с документацией Zed на 2026-10-03; не запускалось.

Codex¶

Файл конфигурацииКоманда

~/.codex/config.toml или .codex/config.toml в доверенном проекте. env_vars пробрасывает переменные из вашей оболочки:

[mcp_servers.yandex-360]
command = "uvx"
args = ["--from", "yandex-cli[mcp]", "ycli", "mcp", "start"]
env_vars = ["YANDEX_ID_OAUTH_TOKEN", "YANDEX_ID_ORGANIZATION_ID"]
startup_timeout_sec = 60   # при первом запуске uvx скачивает пакет

codex mcp add yandex-360 -- uvx --from 'yandex-cli[mcp]' ycli mcp start

Затем добавьте строки env_vars и startup_timeout_sec выше в запись, которую команда создала: --env сохранил бы сам токен.

Проверка: codex mcp list показывает yandex-360 как enabled. После изменений перезапустите Codex. Проверено в Codex 0.159.2 на 2026-10-03: он принимает файл, а команда создаёт запись. Сеанс не запускался.

Gemini CLI¶

Файл конфигурации

~/.gemini/settings.json или .gemini/settings.json в проекте:

{
  "mcpServers": {
    "yandex-360": {
      "command": "uvx",
      "args": ["--from", "yandex-cli[mcp]", "ycli", "mcp", "start"],
      "env": {
        "YANDEX_ID_OAUTH_TOKEN": "$YANDEX_ID_OAUTH_TOKEN",
        "YANDEX_ID_ORGANIZATION_ID": "$YANDEX_ID_ORGANIZATION_ID"
      }
    }
  }
}

Оставьте блок env: Gemini CLI скрывает унаследованные переменные, в имени которых есть TOKEN, если сервер их не перечислил.

Сверено с документацией Gemini CLI на 2026-10-03; не запускалось.

opencode¶

Файл конфигурации

opencode.json в проекте или ~/.config/opencode/opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "yandex-360": {
      "type": "local",
      "command": ["uvx", "--from", "yandex-cli[mcp]", "ycli", "mcp", "start"],
      "environment": {
        "YANDEX_ID_OAUTH_TOKEN": "{env:YANDEX_ID_OAUTH_TOKEN}",
        "YANDEX_ID_ORGANIZATION_ID": "{env:YANDEX_ID_ORGANIZATION_ID}"
      },
      "timeout": 60000,
      "enabled": true
    }
  }
}

Оставьте timeout: opencode по умолчанию ждёт 5 секунд, а для запуска сервера этого мало.

Проверка: opencode mcp list показывает yandex-360 как connected. Проверено в opencode 2.0.20 на 2026-10-03: файл подключается; без timeout сервер оставался в состоянии pending. Сеанс не запускался.

ChatGPT¶

Где	Работает	Как
Codex (CLI, десктоп, IDE)	да	локальный сервер, см. Codex
ChatGPT в вебе	со своим сервером	он подключается только к удалённым HTTPS-серверам: см. Свой MCP-сервер по HTTP. Публичного экземпляра ycli нет

Любой другой клиент¶

Клиенту, который говорит по MCP через stdio, нужны три вещи, как бы ни назывался его файл: команда, её аргументы и две переменные.

{
  "mcpServers": {
    "yandex-360": {
      "command": "uvx",
      "args": ["--from", "yandex-cli[mcp]", "ycli", "mcp", "start"],
      "env": {
        "YANDEX_ID_OAUTH_TOKEN": "<ваш токен>",
        "YANDEX_ID_ORGANIZATION_ID": "<идентификатор организации>"
      }
    }
  }
}

Если клиент ограничивает число принимаемых инструментов, добавьте "--toolsets", "core" в args. Клиенты с поддержкой реестра также находят сервер как io.github.bim-ba/ycli в официальном MCP Registry; он публикуется при каждом релизе.

Docker¶

Образ ghcr.io/bim-ba/ycli — это сам ycli: без аргументов он отдаёт MCP по stdio, с аргументами выполняет указанную команду. Используйте его в любом клиенте вместо uvx; -e NAME без значения передаёт переменную из вашего окружения:

{
  "mcpServers": {
    "yandex-360": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "YANDEX_ID_OAUTH_TOKEN", "-e", "YANDEX_ID_ORGANIZATION_ID", "ghcr.io/bim-ba/ycli"]
    }
  }
}

Как обычный CLI, с двумя переменными в файле:

docker run --rm --env-file .env ghcr.io/bim-ba/ycli tracker issues get TRACKER-1
docker run --rm ghcr.io/bim-ba/ycli --version

Теги: <version> для каждого релиза и latest; linux/amd64 и linux/arm64. О конвейерах см. Использование в CI. Проверено в Docker на 2026-10-03: обе команды работают.

Только навыки¶

Без MCP-сервера четыре навыка ставятся в любого агента, который поддерживает skills CLI:

npx skills add bim-ba/ycli/plugins/yandex-360

Обновление и фиксация версии¶

uvx скачивает последний релиз при первом запуске и потом использует эту копию.

Что нужно	Что написать
самый новый релиз при каждом запуске	`uvx --from 'yandex-cli[mcp]@latest' ycli mcp start`
одна фиксированная версия	`uvx --from 'yandex-cli[mcp]==0.49.1' ycli mcp start`
один раз обновить копию	`uvx --refresh-package yandex-cli --from 'yandex-cli[mcp]' ycli --version`

Если не работает¶

Симптом	Причина и решение
Клиент не находит `uvx`	Приложение, запущенное из Dock или лаунчера, не видит `PATH` вашей оболочки. Укажите в `command` полный путь: его печатает `which uvx`
Каждый вызов отвечает, что `YANDEX_ID_OAUTH_TOKEN` или `YANDEX_ID_ORGANIZATION_ID` не задан	Клиент не передал две переменные. Десктопное приложение не читает экспорты вашей оболочки: используйте его запрос значений или пакет либо впишите значения туда, где сказано в его разделе
После правки конфигурации ничего не меняется	Перезапустите клиент; Claude Desktop нужно закрыть полностью
Первый запуск завершается по тайм-ауту	При первом запуске `uvx` скачивает пакет. Один раз выполните в терминале `uvx --from 'yandex-cli[mcp]' ycli --version` или увеличьте тайм-аут запуска в клиенте
Клиент отклоняет сервер или скрывает инструменты	Он ограничивает число инструментов (VS Code 128, Cascade 100). Отдавайте меньше: `--toolsets core`, см. Запуск MCP-сервера
Вызов отвечает 401 или 403	Токен неверный или ему не хватает права: выполните `ycli doctor` с теми же двумя значениями: он назовёт проверку, которая не прошла, и что исправить

Чтобы увидеть, что делает сервер, запустите его вручную и прочитайте ошибку, которую он печатает:

uvx --from 'yandex-cli[mcp]' ycli mcp methods --toolsets core   # показывает инструменты, учётные данные не нужны
uvx --from 'yandex-cli[mcp]' ycli auth status                   # проверяет два значения

Команда, которая выполнит эти проверки за вас, запланирована: следите за #206.