MCP-действия

MCP (Model Context Protocol) является открытым стандартом, позволяющим AI напрямую использовать инструменты другого сервиса. Вместо ручного описания endpoint и параметров MCP-сервер публикует свои инструменты, а AI-агент обнаруживает и использует их.

Большинство сервисов подключаются одним нажатием. Откройте Действия и MCP, нажмите + Добавить действие и выберите MCP.

Проверьте пример MCP-подключения к документации Cloudflare или endpoint Microsoft Learn. Проверка выполняет только инициализацию и запрос списка инструментов, без входа и их выполнения.

Необязательные инструменты настройки

• Предпросмотр правил памяти MCP. Примените заданные правила памяти к примеру результата MCP-инструмента без вызова инструмента или изменения памяти разговора.

• Сравнение списков инструментов MCP. Сравните два заданных списка и объявленные настройки активации, чтобы увидеть изменения определений и вопросы для проверки. Это не подключается к серверу и не доказывает совместимость.

• Проверка направления MCP-подключения. Подготовьте параметры по публичному endpoint и выбранной цели. Инструмент не принимает учётные данные, не подключается к серверу и не меняет аккаунт.

Подключение из каталога

Экран MCP открывает каталог известных сервисов с поиском и категориями (Популярный, Поддержка клиентов, CRM и продажи, Планирование встреч, Электронная торговля, Платежи и счета, Маркетинг и почта, Общение, Продуктивность, Данные и аналитика, Поиск и веб, Путешествия и бронирование, Дизайн, Разработка и инфраструктура).

1. Найдите нужный сервис в каталоге или через поиск.
2. Нажмите его плитку. Quickchat проверит сервер и обнаружит предлагаемые инструменты.
3. Если сервис требует входа, появится панель Требуется авторизация. Нажмите Подключить через <сервис>, одобрите доступ во всплывающем окне, и панель покажет подключение.
4. Действие создаётся и включается, его инструменты появляются в списке. AI-агент может использовать их со следующего сообщения.

Заметка

После запуска авторизации Quickchat сохраняет действие и ожидающую авторизацию, даже если вы закроете панель действий или всплывающее окно. Откройте действие и нажмите Открыть авторизацию снова, чтобы продолжить, или Отмена, чтобы остановить процесс. Если поставщик завершит авторизацию после закрытия панели, Quickchat завершит подключение в фоне и включит действие, когда в тарифе есть свободное место.

Совет

Браузер должен разрешать всплывающие окна для панели Quickchat, иначе окно авторизации не откроется. При блокировке появится сообщение с просьбой разрешить окна и повторить попытку.

Подключение сервера вне каталога

Нажмите Ввести URL вручную под каталогом, затем:

1. Вставьте URL сервера MCP (должен начинаться с https://).
2. Если сервер использует статический токен вместо входа, откройте Заголовки подключения (необязательно) и добавьте ожидаемый заголовок, например Authorization: Bearer <your-token>.
3. Нажмите Подключить.

Используйте Открыть каталог, чтобы вернуться к плиткам. Если нужного сервиса нет, Не хватает интеграции? Предложите её открывает заранее заполненное письмо нашей команде.

Выбор доступных AI инструментов

После подключения действие показывает все инструменты сервера с отдельными переключателями. Выключите всё, что AI не должен вызывать. Например, у сервера бронирования можно оставить поиск только для чтения, но отключить отмену.

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

Некоторые записи каталога имеют метку Настроено Quickchat. Quickchat полностью протестировал эти серверы и предоставляет подобранный набор инструментов, необходимые правила памяти и Сообщение при обдумывании для каждого. Нажмите Использовать рекомендуемое, чтобы увидеть изменения: диалог Применить рекомендуемые настройки? перечисляет включаемые и выключаемые инструменты и устанавливаемые правила памяти, а также предупреждает о перезаписи изменённых вами правил. Ничего не сохраняется до сохранения действия, и после этого каждый инструмент можно настроить.

Совет

Имя действия MCP и Описание действия MCP предназначены для вас и команды: они обозначают действие в списке, а AI их не читает. AI руководствуется описаниями инструментов, опубликованными самим сервером, и Основным промптом агента. Укажите, когда агент должен использовать инструменты сервера («на каждый вопрос о проекте отвечай с помощью Linear»), и закрепите значения, которые модель иначе будет угадывать («всегда ищи в пространстве acme-eng»). При двух подключениях одного сервера называйте их по задаче («Справочный центр Notion», «Обращения поддержки Notion»), а не по поставщику.

Бронирование времени в Calendly

Когда одно действие подключается к серверу Calendly https://mcp.calendly.com и включает оба инструмента ниже, Quickchat предоставляет им входные данные в местном времени. Имена не меняются, дополнительные инструменты преобразования не добавляются. Если включён только один инструмент, он сохраняет исходные параметры Calendly.

• Доступность: event_types-list_event_type_available_times принимает local_start_time, local_end_time и IANA-timezone, например Europe/London. Передавайте местные даты и время в формате YYYY-MM-DDTHH:MM:SS. Quickchat преобразует диапазон в UTC по правилам пояса на эти даты, включая дни по 23 и 25 часов при переводе часов.
• Бронирование: meetings-create_invitee принимает local_start_time выбранного варианта и booking_timezone внутри post_invitee_request. Существующий invitee.timezone остаётся поясом клиента, который может отличаться от пояса встречи. Например, приглашённый в America/New_York может забронировать время, выраженное в Europe/London.

Копируйте местное время и пояс, возвращённые с вариантом доступности. Если время включает смещение UTC, сохраняйте его: оно различает повторяющиеся местные часы при переводе назад. Некорректное или несуществующее время, неоднозначное время без смещения и смещения, не соответствующие названному поясу, отклоняются.

Предложение времени не резервирует его. Перед созданием встречи Quickchat повторно проверяет доступность и передаёт соответствующую временную метку поставщика в Calendly без изменений. Если время уже занято, попытки бронирования нет. Результат содержит местное время для подтверждения агентом; поля поставщика, используемые в Сохранить в память, например $.resource.event, остаются доступны.

Сохраните требование согласия клиента в Основном промпте и подтверждайте бронирование только после успешного результата поставщика. Явно устанавливайте часовой пояс встречи в разговоре независимо от браузера или канала. Если он неясен, спросите клиента до проверки доступности или бронирования.

Сохранение результата MCP-инструмента в память

Раскройте инструмент и используйте Сохранить в память, если значение результата понадобится позже в разговоре. Добавьте JSONPath-выражение значения и Ключ памяти для его обозначения. Из одного инструмента можно сохранить до 10 значений.

Ключи памяти общие с API-действиями агента. Если API-действие уже использует тот же ключ, поле Ключ памяти сообщит о конфликте при сохранении. Выберите другой ключ.

Сохранённое значение становится частью данных разговора, доступных AI в следующих сообщениях. Например, инструмент бронирования может сохранить URI события, чтобы инструмент отмены знал, какую встречу отменить. MCP-инструменты не используют подстановку {{metadata_<key>}} из API-действий, поскольку AI передаёт их аргументы напрямую.

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

Что видят посетители

Во время работы инструмента виджет показывает короткую строку о текущем действии AI. У каждого инструмента есть поле Сообщение при обдумывании на панели инструментов. Если оставить его пустым, строка формируется из имени (для search_flights это «Поиск рейсов…»), либо можно написать свой текст («Поиск в справочном центре»). У настроенных серверов сообщения для рекомендуемых инструментов уже заполнены. Вместо одного индикатора набора посетитель получает полезную информацию во время ожидания.

Переподключение и отключение

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

Изменение URL сервера MCP у подключённого действия очищает авторизацию и выключает его: учётные данные одного сервера никогда не используются для другого. Авторизуйтесь снова для восстановления работы.

Устранение неполадок

Что вы видите	Что это означает
Авторизация не завершена	Нажмите Попробовать снова. Если вы отказали в доступе, одобрите его в следующей попытке. При другой ошибке обратитесь в поддержку и укажите код из сообщения.
Подключено, но инструменты не загрузились	Авторизация прошла, но список инструментов не загрузился. Нажмите Переподключить.
На сервере не найдены инструменты. Попробуйте подключиться заново.	Сервер авторизован, но не публикует инструменты. Убедитесь, что одобренный аккаунт имеет доступ к нужным данным.
Введите корректный URL, начинающийся с https://	URL не удалось прочитать. Используйте полный адрес сервера https://. Quickchat всегда подключается через https, чтобы учётные данные не передавались незашифрованными.
Действие само выключилось	Авторизация истекла или отозвана поставщиком. Откройте действие и нажмите Переподключить.

Заметка

MCP-действия учитываются в лимите пользовательских действий тарифа, как и API-действия.