Перейти к содержанию

Запуск 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-инструментам.