Запуск 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 отдаётся всегда. Чтобы посмотреть, какие инструменты дадут выбранные флаги, не запуская сервер:

ycli mcp methods --toolsets core --read-only

Доверяйте подсказкам¶

Каждый инструмент сообщает, что он делает: у чтений есть readOnlyHint, а записи указывают, разрушающие ли они и идемпотентные ли. Хост может автоматически разрешать чтения и спрашивать подтверждение перед разрушающим вызовом. --read-only убирает все записи — для случая, когда агент ничего не должен менять.

Подключите клиент¶

Большинство 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-инструментам.