Валюта и копия проекта через агента

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

Задача	Инструмент	Токен
Перевести оценки проекта в другую валюту	change_project_currency	Чтение и черновики оценок
Скопировать проект	copy_project	Чтение и черновики оценок

Проект агент находит по project_id, это идентификатор из списка проектов.

Перевод в другую валюту

Попросите, например: "Переведи оценки проекта Сайт студии в USD, 1 USD = 80 RUB". Агент вызывает change_project_currency с полями project_id и target_currency (трёхбуквенный код, например USD). Он пересчитывает ставку, стоимость команды, постоянные расходы и итоги обоих сценариев.

Валюту меняют только черновики. Остальные оценки проекта агент пропускает, они попадают в skipped с причиной:

Причина	Что значит
published	Оценка опубликована
archived	Оценка в архиве
already_in_target	Оценка уже в нужной валюте
currency_not_in_rate_pair	Валюты оценки нет в паре курса

Опубликованные версии и ссылки клиентам не меняются. Подробнее о валютах в оценке: Валюты и курсы.

Как задать курс

Курс агент передаёт в поле rate: { base: "USD", quote: "RUB", value: 80 } значит 1 USD = 80 RUB. Порядок пары любой, но в паре должны быть текущая валюта оценок и target_currency. value это число больше нуля.

Курс можно не называть. Тогда агент берёт справочный курс воркспейса: в ответе он помечен как reference и показывает источник и дату курса. Названный вами курс приходит с пометкой custom.

Если пара не подходит, агент получает ответ invalid_params. В подсказке сказано, как записать курс, и перечислены валюты черновиков проекта.

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

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

• applied равно false;
• для каждой оценки показаны курс (пара, множитель, источник) и суммы "было" (before) и "стало" (after): ставка или стоимость команды, постоянные расходы, трудозатраты и итог по сценариям;
• skipped перечисляет пропущенные оценки с причиной.

Агент показывает превью. Если суммы верны, подтвердите: агент повторяет вызов с confirm равным true, и все черновики переводятся одной транзакцией. Вернуть прежнюю валюту после этого нельзя, только перевести ещё раз по новому курсу.

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

Копирование проекта

Попросите, например: "Скопируй проект Сайт студии". Агент вызывает copy_project с полем project_id. Название копии подбирается само, например "Сайт студии (копия 1)".

Первый вызов показывает план и ничего не создаёт. В ответе:

• applied равно false;
• project_name: название будущей копии;
• estimates_to_copy: оценки, которые попадут в копию (идентификатор и название);
• skipped: оценки, которые в копию не попадут, с причиной archived;
• not_copied: сколько участников (participants), задач (issues) и действующих ссылок для клиентов (active_shares) в копию не перейдёт.

После вашего подтверждения агент повторяет вызов с confirm равным true. Копия создаётся одной транзакцией, в ответе applied равно true, project_id и project_name новой копии и estimates_copied: число скопированных оценок. Ключ idempotency_key работает так же, как при смене валюты: повтор с ним не создаст вторую копию.

Что копируется и что нет

В копию попадают:

• настройки проекта: значок, теги, шкала поинтов, циклы и часовой пояс;
• черновики и опубликованные оценки: каждая появляется в копии новым черновиком с пометкой "создано через MCP".

В копию не попадают:

• участники: в копии вы единственный участник;
• задачи;
• описание и даты проекта;
• архивные оценки;
• версии оценок: у копии нет истории;
• ссылки для клиентов и данные клиентов.

Кнопка "Копировать проект" в приложении работает иначе, например она переносит описание проекта. Её описывает статья Копия проекта.

Кто может это делать

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

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

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

См. также

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

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

Копия проекта Кнопка копирования в приложении и что она переносит