Запуск MCP-сервера¶
ycli mcp start отдаёт каждую операцию как MCP-инструмент по stdio. Для него нужно дополнение mcp
(uv tool install 'yandex-cli[mcp]') и учётные данные в окружении.
Выберите инструменты¶
Если отдавать все инструменты, tools/list получается огромным, а некоторые хосты ограничивают число
инструментов (VS Code принимает 128). Выберите то, что нужно в этой сессии:
| Флаг | Что отдаёт |
|---|---|
--toolsets tracker,wiki |
только перечисленные сервисы (tracker, wiki, forms); по умолчанию all |
--toolsets core |
отобранный набор на каждый день, около 40 инструментов: задачи, комментарии, переходы, учёт времени, страницы Вики и поиск, чтение форм |
--tools a,b / --exclude-tools a,b |
добавить или скрыть отдельные инструменты по имени; неизвестное имя приводит к ошибке при запуске |
--read-only |
без инструментов записи; всегда главнее перечисленных выше флагов |
--tool-search |
вместо инструментов — инструмент поиска и прокси для вызова; подходит для большого набора |
status_get и schema_get отдаются всегда: первый проверяет учётные данные, второй читает схему тела, которое инструмент показывает свободным объектом (тело слишком велико, чтобы показать целиком), и схему ответа инструмента, которой нет ни в одном списке (tool, затем tool и name для части). Чтобы посмотреть, какие инструменты дадут выбранные флаги, не запуская
сервер:
ycli mcp methods --toolsets core --read-only
Доверяйте подсказкам¶
Каждый инструмент сообщает, что он делает: у чтений есть readOnlyHint, а записи указывают,
разрушающие ли они и идемпотентные ли. Хост может автоматически разрешать чтения и спрашивать
подтверждение перед разрушающим вызовом. --read-only убирает все записи — для случая, когда агент
ничего не должен менять.
Инструмент, который выдаёт доступ (роль, право, привязку доступа, встраивание), помечен так, что клиент, понимающий пометку, спрашивает человека при каждом вызове; об этом сказано и в его описании.
Предпросмотр записи¶
У каждого пишущего инструмента есть dry_run. С dry_run: true он ничего не отправляет и
возвращает запрос, который отправил бы, — тот же объект, что печатает ycli … --dry-run -o json,
с закрытыми секретами:
{"dry_run": true, "request": {"method": "PATCH", "url": "https://api.tracker.yandex.net/v3/issues/DE-7", "body": {"summary": "New"}}}
- То, что инструмент читает до первой записи, читается; план — только первой записи. Несколько записей делает один инструмент:
wiki_attachments_uploadпоказывает открытие сессии загрузки. requestравенnull, если инструмент ничего бы не записал.- У инструмента, который только читает,
dry_runнет: планировать нечего, аргумент получает отказ. CLI отличается:--dry-run— опция каждой команды, и чтение с ней уходит. - Инструмент, выдающий доступ, спросит человека и при пробном запуске: клиент решает по инструменту, раньше чем сервер увидит аргументы. Там, где спросить некого, план даёт команда:
ycli … --dry-run.
Prompts и ресурсы¶
Кроме инструментов сервер предлагает несколько prompts и ресурсов. Клиент показывает prompt как готовый запрос (в Claude Code — /yandex-360:tracker_issue_brief DE-7) и позволяет прикрепить ресурс к разговору (@yandex-360:ycli://tracker/issue/DE-7).
| Prompt | Что запрашивает |
|---|---|
tracker_queue_digest |
открытые задачи очереди: сколько их, что застряло, кто чем занят |
tracker_issue_brief |
одну задачу: в каком она состоянии, что решено, что её блокирует |
tracker_sprint_review |
спринт доски: что сделано, что не успели |
wiki_page_from_issue |
страницу Вики по задаче; создаётся после того, как вы одобрите черновик |
forms_answers_table |
ответы формы таблицей, с кратким итогом |
| Ресурс | Содержимое |
|---|---|
ycli://tracker/issue/{issue_key} |
задача, как её возвращает tracker_issues_get |
ycli://wiki/page/{slug} |
Markdown страницы |
ycli://forms/survey/{survey_id} |
настройки формы, как их возвращает forms_surveys_get |
ycli://tracker/guide, ycli://wiki/guide, ycli://forms/guide, ycli://guide |
как работать с сервисом через эти инструменты: текст skills из плагина, для клиента без плагина |
Prompt или ресурс предлагается, только если сервер отдаёт инструменты, из которых он состоит: с --read-only нет wiki_page_from_issue, с --toolsets wiki нет prompts Трекера. ycli mcp methods --kind prompts и --kind resources показывают, что предложит сервер с теми же флагами. Аргументы — в справочнике (англ.).
Подключите клиент¶
Большинство MCP-клиентов принимают команду и окружение:
{
"mcpServers": {
"yandex-360": {
"command": "uvx",
"args": ["--from", "yandex-cli[mcp]", "ycli", "mcp", "start", "--toolsets", "core"],
"env": {
"YANDEX_ID_OAUTH_TOKEN": "...",
"YANDEX_ID_ORGANIZATION_ID": "..."
}
}
}
}
Точный файл и ключи для каждого ИИ-клиента описаны в разделе Установка в вашем ИИ-клиенте. Как обслуживать много пользователей по HTTP, см. Свой сервер по HTTP. Все инструменты и их параметры — в справочнике по MCP-инструментам.