КП клиенту через агента

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

Шаг	Инструмент	Токен
Опубликовать версию	publish_estimate_version	Чтение и черновики оценок
Создать ссылку для клиента	create_share_link	Чтение и черновики оценок
Узнать статус согласования	get_approval_status	Любой, хватит "Только чтение"

Что нужно

• Токен с правом записи для публикации и ссылки.
• Роль в проекте, которая позволяет править оценки. Наблюдатель получает отказ forbidden.
• Оценка из воркспейса токена. Подойдёт любая: созданная агентом или собранная в приложении.

Опубликовать версию

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

• Повтор с тем же ключом идемпотентности вернёт ту же версию.
• Без ключа каждый вызов создаёт новую версию.
• Если лимит MCP исчерпан, агент получает ответ quota_exceeded с датой сброса.

Создать ссылку для клиента

Агент создаёт ссылку на опубликованную версию. По умолчанию она открытая: страницу видит любой, у кого есть адрес. Можно задать срок жизни ссылки, без него она бессрочная. Что видит клиент, описано в статье Что видит клиент по ссылке. Файлы PDF и XLSX клиент скачивает на самой странице, агент их не отдаёт.

Адрес открытой ссылки показывается один раз, при создании. Агент отдаёт его вам, потерянный адрес восстановить нельзя: отзовите ссылку в приложении и создайте новую.

Ссылка с паролем

Если агенту передан пароль, ссылка создаётся с защитой: клиент вводит пароль перед открытием отчёта. Режим доступа задаётся при создании и потом не меняется.

• Пароль минимум 8 символов. Короче отклоняется ответом invalid_params, ссылка не создаётся.
• Пароль не возвращается в ответе и не пишется в журнал вызовов. Клиенту его передаёт агент или вы, лучше отдельным сообщением.
• Адрес ссылки с паролем агент получает в ответе всегда, в том числе при повторном запросе.
• Подпись ссылки агент может задать сам, она нужна только вам.

Повторный запрос ссылки

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

• Для открытой ссылки адрес не возвращается, он был показан при создании.
• Для ссылки с паролем адрес возвращается, пароль нет.
• Выданную клиенту ссылку агент не отзывает. Чтобы заменить её, отзовите ссылку в приложении: Публикация оценки клиенту по ссылке.

Согласующий

Клиент согласует оценку, только когда назначен согласующий. Агент может передать его вместе со ссылкой: имя и email того, кто согласует. Согласующий назначается только новой ссылке, в ответе recipient_set равно true.

Если назначить не вышло, ссылка всё равно создана, recipient_set равно false, а в подсказке написано назначить согласующего в приложении: Согласование оценки клиентом. Имя и email не возвращаются в ответе и не пишутся в журнал вызовов.

Статус согласования

Агент передаёт идентификатор ссылки из ответа на создание. Для ссылок, созданных в приложении, идентификатор есть у версии в list_estimate_versions. В ответе:

• состояние согласования;
• когда клиент ответил;
• сколько раз открывали ссылку и когда в последний раз.

Имя, email и компания согласующего, а также текст ответа клиента агенту не отдаются. Состояния совпадают со статусами в редакторе ссылки:

Состояние в ответе	Статус в приложении
approval_disabled	Согласующий не указан
awaiting_response	Ожидает решения
approved	Согласовано
changes_requested	Запрошены изменения
expired_offer	Срок предложения истёк
expired_link	Срок жизни ссылки истёк
revoked	Ссылка отозвана
superseded	Есть новая редакция

Счётчик открытий у ссылки с паролем может вырасти сразу на 2: страница и отчёт после ввода пароля считаются отдельно.

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

• Не отзывает ссылку и не меняет её пароль и срок жизни.
• Не меняет и не удаляет согласующего.
• Не отправляет клиенту код подтверждения и напоминания.

Отзыв ссылки, пароль, срок жизни и согласующего меняют в приложении.

См. также

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

Публикация оценки клиенту по ссылке Открытая ссылка, пароль и отзыв доступа в приложении

Согласование оценки клиентом Как клиент подтверждает оценку и что значат статусы