Подключите Gmail, Google Sheets и Slack к вашему конструктору приложений
Mythex теперь может работать с инструментами, которыми вы уже пользуетесь. Подключите Gmail, Google Sheets, Slack, Notion или сотни других приложений один раз, а затем попросите агента в чате прочитать таблицу, отправить письмо или опубликовать сообщение. Ваш аккаунт связан с Mythex, а не с вашим кодом: агент никогда не видит учётные данные, и ничего не попадает в ваш репозиторий.
Что это делает
Коннектор — это связь между вашим аккаунтом Mythex и аккаунтом, который у вас есть где-то ещё. Как только связь установлена, агент может использовать этот аккаунт от вашего имени, когда вы попросите его в чате. Например:
Прочитай таблицу «Q4 pipeline» и построй по ней дашборд
Агент находит подходящее действие для задачи, проверяет нужные ему аргументы и выполняет его. За этим стоят четыре инструмента:
| Инструмент | Что делает |
|---|---|
AppListConnections | Показывает подключённые вами приложения |
AppSearchTools | Находит нужное действие для задачи и аргументы, которые оно принимает |
AppConnect | Даёт вам ссылку для подключения приложения, которое нужно агенту |
AppRun | Выполняет одно действие над вашим подключённым аккаунтом |
Если агенту нужно приложение, которое вы не подключили, ход останавливается на карточке с кнопкой Connect, а не на ссылке, спрятанной в абзаце. Нажмите её, подтвердите в открывшейся вкладке и вернитесь: карточка это заметит и сменится на Connected. Спросите снова, и агент продолжит работу. Пока вы ждёте, он не будет угадывать ваши данные и не будет выдумывать таблицу.
Зачем мы это сделали
Чтобы создать что-то полезное, обычно нужно работать с реальными данными: таблица лидов, входящие письма, командный канал. Обычный путь — создать API-ключ, вставить его в файл настроек и надеяться, что он никогда не попадёт в коммит. Для не-разработчика это сложно, а для всех остальных — рискованно.
Коннекторы убирают ключ из картины. Вы входите в учётную запись провайдера так же, как в любом другом месте (OAuth, если по-научному), а учётные данные остаются в сервисе подключений Mythex:
- Зашифрованы при хранении
- Никогда не записываются в ваш проект, ваш
.envили сгенерированный код - Никогда не передаются в песочницу, в которой собирается ваше приложение: песочница просит сервер выполнить вызов и получает результат
- Удаляются, когда вы отключаете связь или удаляете аккаунт
Как пользоваться
Подключите приложение
- Откройте Connectors. Это в левой боковой панели под Projects, а внутри проекта можно также нажать + рядом с полем сообщения и выбрать Connectors. Панель открывается поверх того, что вы делали, так что ваше место не теряется.
- Найдите приложение. Поиск охватывает весь каталог, а не только то, что видно на экране.
- Нажмите Connect. Страница входа провайдера откроется в новой вкладке, поэтому ваш проект и недописанное сообщение останутся на месте.
- Подтвердите доступ там.
- Вернитесь на вкладку Mythex. У приложения появится зелёная точка и надпись Connected.
Подтверждайте каждое разрешение, которое запрашивает провайдер. Особенно Google разделяет доступ по продуктам: если разрешить Gmail, но не Drive, подключение будет работать наполовину, и при попытке использования агент выдаст ACCESS_TOKEN_SCOPE_INSUFFICIENT. Решение — отключить, подключить заново и подтвердить всё.
Просите то, что вам нужно
После подключения просто скажите это обычным языком. Не нужно называть инструмент или действие.
Отключение
Откройте Connectors, переключитесь на Connected в левой панели и наведите курсор на приложение. Disconnect немедленно отзывает доступ Mythex у провайдера. Всё, что агент уже построил, остаётся; просто он больше не может обращаться к этому аккаунту.
Планирование никогда не отправляет письма
В режимах Ask и Plan агент может только смотреть. Он может показать ваши подключения и изучить, что с ними можно сделать, но не может выполнить действие или начать подключение. Это делает режим Plan безопасным местом, чтобы продумать, чего вы хотите, до того как что-либо коснётся вашей почты или каналов. Подробнее в статье планировать перед сборкой.
Пользовательские MCP-серверы
В каталоге есть не всё. Connectors → Custom MCP принимает URL любого MCP-сервера: ваш собственный, сервер вашей компании или тот, который вам дал поставщик. Заполните название и URL, выберите способ аутентификации и нажмите Add & authorize:
- Если сервер просит войти, его собственное окно согласия откроется во вкладке.
- Если нужен статический токен, вставьте его в поле Bearer token. Сохранённый токен больше никогда не показывается.
- Если ничего не нужно, подключение происходит сразу.
Список инструментов считывается в этот момент, поэтому неверный URL или отклонённый токен сразу проваливаются в форме, а не посреди сборки. Сервер можно выключить, не удаляя его, а Refresh заново считывает его инструменты после изменений. Входы продлеваются в фоне. На один аккаунт можно добавить до десяти серверов.
Ограничения
- Подключения принадлежат вам и общие для всех ваших проектов.
- Не каждое приложение из списка можно подключить. Некоторые в каталоге этого не поддерживают и показываются как недоступные.
- Действуют лимиты запросов на то, как часто агент может обращаться к подключённому приложению, чтобы защитить квоту вашего собственного аккаунта у провайдера.
- Если провайдер отзывает или истекает доступ — это часто случается после смены пароля или изменения прав в рабочем пространстве, — агент скажет, что приложение нужно подключить заново. Отключите и подключите снова.
Этот пост о том, что агент может сделать для вас в чате. Полную картину смотрите в документации по коннекторам.