Настройки воркспейса через агента

Агент с доступом по MCP показывает настройки оценки вашего воркспейса и меняет их: ставку, шкалу поинтов, валюту по умолчанию. Перед сохранением он показывает превью "было и стало", а записывает только после вашего подтверждения. Как выпустить токен и подключить агента, описано в статье MCP: подключение агента. Каждый вызов входит в лимит MCP: 100 вызовов в месяц на воркспейс.

Шаг	Инструмент	Токен
Прочитать настройки	get_workspace_settings	Любой, хватит "Только чтение"
Изменить настройки	update_workspace_settings	Чтение и черновики оценок

Прочитать настройки

Попросите, например: "Покажи настройки воркспейса и оценок проекта Сайт студии". Агент отвечает:

• валютой по умолчанию воркспейса;
• значениями, которые заданы в воркспейсе явно (overrides): пустое значение значит, что действует стандарт Dead Point;
• действующими значениями для новых оценок (effective): единица трудозатрат, шкала поинтов, ставка в час или стоимость команды в месяц;
• шкалой поинтов каждой команды.

Если назвать проект, к ответу добавятся его оценки: название, статус, валюта, единица трудозатрат, шкала и ставка или стоимость команды каждой оценки. Суммы приходят строками, например "3500". Контакты, платёжные реквизиты и участников воркспейса агент не получает.

Изменить настройки

Нужен токен с правом записи. Попросите, например: "Поставь ставку 3500 в час и шкалу Фибоначчи". Агент может менять:

Поле	Что задаёт
hour_rate	Часовая ставка для новых оценок в часах
team_cost_per_month	Стоимость команды в месяц
buffer_percent	Буфер, %
rounding_scale	Знаков после запятой в суммах, число от 0 до 6
estimate_type	Шкала поинтов всех команд: not_in_use, linear, fibonacci, exponential или t_shirt
default_currency_code	Валюта по умолчанию, трёхбуквенный код, например USD
work_hours_per_day	Рабочих часов в день
work_days	Рабочие дни недели числами
cycle_days	Длина цикла в днях

Ставка, стоимость команды и буфер передаются строкой, например "3500". Шкалы поинтов описаны в статье Поинты и шкалы, валюта по умолчанию в статье Валюты и курсы.

Чтобы вернуть hour_rate, team_cost_per_month, buffer_percent или rounding_scale к стандарту Dead Point, агент передаёт их имена в reset_fields. Другое имя в reset_fields и значение вне допустимого агент получает как ответ invalid_params с подсказкой, какие значения разрешены.

Превью и подтверждение

Первый вызов update_workspace_settings ничего не сохраняет. В ответе:

• applied равно false;
• changes перечисляет поля: что было (before) и что станет (after);
• affected_teams показывает, у скольких команд изменится шкала поинтов.

Агент показывает вам превью. Если всё верно, подтвердите: агент повторяет вызов с confirm равным true, настройки сохраняются, applied равно true. Пока вы не подтвердили, в приложении ничего не меняется.

• Если значения уже совпадают с текущими, changes пуст и сохранять нечего.
• Ключ идемпотентности (idempotency_key) передают только вместе с confirm равным true. Повтор с тем же ключом вернёт первый результат и не сохранит ничего дважды. Ключ, использованный на превью, при подтверждении даёт ответ idempotency_conflict.
• Если лимит MCP исчерпан, агент получает ответ quota_exceeded с датой сброса.

Существующие оценки

Новые настройки действуют на новые оценки. Оценки, которые уже созданы, не пересчитываются: черновики и опубликованные версии остаются прежними.

Кто может менять

Настройки меняют владелец и администратор. Если токен выпущен пользователем с другой ролью, агент получает отказ forbidden, а настройки остаются прежними. Читать настройки может любой токен воркспейса, а оценки проекта в ответе агент получает, если у вас есть право смотреть оценки этого проекта.

В приложении то же правило: владелец и администратор меняют настройки в "Настройки рабочего пространства", остальные видят поля только для чтения и подсказку "Изменять настройки могут владелец и администратор".

Чего агент не делает

• Не пересчитывает существующие оценки и не трогает опубликованные версии.
• Не меняет реквизиты, контакты, участников и роли.
• Не сохраняет настройки без confirm равного true.

См. также

MCP: подключение агента Токен, доступ, лимиты и черновик оценки из ТЗ

Поинты и шкалы Четыре шкалы, производительность команды и стоимость

Валюты и курсы Валюта по умолчанию, курсы и строки в другой валюте