Подключение ваших инструментов

Интеграция — это подключение, которое позволяет вашему ассистенту использовать внешний инструмент или сервис от вашего имени: читать из него данные, записывать в него или и то, и другое. Как только инструмент подключён, вы можете просто попросить в чате («подтяни открытые задачи за эту неделю из Linear», «создай ссылку на оплату в Stripe») — и ассистент сделает всё остальное.

Самый простой способ: просто попросите ассистента

Вам не нужно ничего настраивать вручную. Скажите ассистенту, что хотите подключить — «подключи мой Gmail», «подключи наш аккаунт Stripe», «забирай данные из нашей 1С» — и он сам подберёт лучший способ и проведёт вас через всё необходимое.

Некоторые инструменты готовые: ассистент подключает их из встроенной Библиотеки в пару касаний. Другие — например Gmail и остальные сервисы Google, вашу систему учёта или внутренний сервис — он подключает, настраивая для вас индивидуальное подключение за кулисами. В любом случае вы просто просите обычными словами: если нужен вход, он даёт вам ссылку для одобрения доступа (ваш пароль он не видит), а если нужен ключ — попросит его прямо в чате.

Если коротко: не ищите настройки — просто попросите. Остальная часть этой страницы — про Библиотеку и экран настроек, на случай если вы предпочитаете подключать всё самостоятельно.

Бета: Управление интеграциями сейчас находится в бета-режиме, поэтому раздел настроек Интеграции скрыт, пока вы не включите его в Настройки → Предпочтения → Бета-функции. См. Бета-функции. (Раздел Интеграции в боковой панели, где также перечислены скрипты вашего рабочего пространства, остаётся видимым.)

Интеграции Plank построены на стандарте под названием MCP (Model Context Protocol). Чтобы пользоваться ими, вам не нужно ничего знать об MCP — представляйте каждую из них как дверцу между вашим ассистентом и сервисом, которым вы уже пользуетесь.

Где находятся интеграции

Управлять интеграциями можно в двух местах, и они синхронизируются между собой:

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

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

Библиотека: готовые интеграции

Библиотека (в разделе Настройки → Интеграции) — это коллекция готовых интеграций для популярных сервисов. Каждая из них уже умеет подключаться — вам не нужно ничего технически настраивать.

Среди доступных в Библиотеке примеров — Notion, Linear, Stripe, Sentry, PostHog, Supabase и Vercel, а также другие. Используйте поле поиска вверху Библиотеки, чтобы отфильтровать по названию, а чипсы категорий — чтобы сузить по типу.

На каждой карточке Библиотеки показаны название интеграции, краткое описание и то, что (если что-то требуется) ей нужно от вас для подключения.

Добавление из Настроек

1. Откройте Настройки → Интеграции.
2. Найдите нужную интеграцию в Библиотеке (при необходимости воспользуйтесь поиском).
3. Нажмите Настроить на её карточке.

Что произойдёт дальше, зависит от того, как этот сервис проходит авторизацию:

Когда всё на месте, у интеграции отображается Готова в чате — это сигнал, что ассистент может ею пользоваться.

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

Авторизация подключения (вход в сервис)

Многие интеграции подключаются через вход в сервис, а не запрашивая ключ. Когда вы нажимаете Подключить аккаунт, Plank открывает страницу входа самого сервиса в новой вкладке. Вы входите там и одобряете доступ — Plank никогда не видит ваш пароль. После того как вы одобрите доступ, эту вкладку можно закрыть; Plank обнаружит подключение и обновит интеграцию до состояния Готова в чате.

Если подключение когда-нибудь перестанет работать, откройте меню интеграции и выберите Переподключить, чтобы войти заново.

Добавление из чата

Вы также можете настроить интеграцию, просто разговаривая с ассистентом — открывать Настройки не нужно. Например:

«Какие интеграции я могу подключить?»

«Настрой мне Notion.»

Ваш ассистент может просматривать ту же Библиотеку, создавать интеграцию и провести вас через завершение настройки. Если сервису нужен ваш вход, он передаст вам ссылку для этого; если нужен ключ — попросит его прямо в беседе. В любом случае это та же безопасная настройка, что и в Настройках, только с подсказками в чате.

Для ассистентов: добавляйте интеграцию, а не правку конфига

Некоторые MCP-серверы можно подключить, вписав их прямо в opencode.json рабочего пространства. Это работает — и это не та дверь. Такой сервер не появляется в Настройках → Интеграции: его нельзя увидеть, выключить или удалить, не редактируя файл снова, — а подключаться при каждом запуске ассистента он всё равно будет.

Создавайте интеграцию (в Настройках или просто попросив в чате, как выше). Тогда она видна в списке, выключается одним переключателем, а удаление действительно удаляет.

Если сервер уже прописан в файле, Plank его не трогает — обычно это то, о чём вы сами просили, и удаление сломало бы работу, — но предупредит, что он не управляется, и в Настройках он так и не появится, пока его не добавят как интеграцию.

Кто может пользоваться и где: область действия

Когда вы добавляете интеграцию, вы выбираете её область действия — насколько широко она применяется. Plank предлагает три варианта:

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

Удаление интеграции

Откройте меню любой интеграции и выберите Удалить. Это удаляет подключение и его настройку. (Удаление интеграции ничего не удаляет во внешнем сервисе — оно лишь отключает от него Plank.)