Плагины и интеграции

Почти всё, что Piomio умеет помимо самого чата, — плагины: браузер, память, напоминания, Telegram, погода, твой Notion. Сервисы, которые ты подключаешь, и возможности, которые включаешь, называются интеграциями. Всё это лежит в одном каталоге, и любую интеграцию можно настроить, просто попросив ассистента.

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

Скажи своими словами, что нужно:

• «Подключи Notion». «Включи погоду». «Настрой Telegram».
• «Ты видишь мои задачи в Linear?» (если Linear ещё не подключён, агент так и скажет и предложит подключить)

Ассистент покажет в чате карточку интеграции: её состояние и одну кнопку, которая двигает дело дальше:

• Включить — для возможности, которую достаточно включить: погода, курсы валют.
• Войти в … — для сервиса со своим входом: Notion, Linear, Granola.
• Настроить — для плагина, которому нужен ключ или токен. Поле на карточке отправляет значение прямо в зашифрованное хранилище, а агент видит только ссылку на него.

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

Каталог плагинов#

Всё то же самое есть в Настройки → Плагины:

• Поиск сверху («Поиск: погода, календарь, карты…») и разделы: Все, На каждый день, Поездки и места, Деньги, Работа и дела, Новости и чтение, Связь, Ассистент, Интеллект и Ещё.
• Популярные: плагины, которыми агенты пользовались чаще всего за последние 30 дней, а за ними — то, что советует сам Piomio.
• В каждой строке — название, строчка о плагине и состояние: Вкл., Нужна настройка или Не работает. У выключенного плагина состояния нет.

Нажми на строку, чтобы открыть страницу плагина:

• Переключатель (Включён / Выключен) и состояние.
• Кнопка, которая продолжает дело в чате: Подключить в чате, Починить в чате или Настроить в чате. Она открывает чат ассистента с короткой просьбой от твоего имени.
• Попробуйте: «…» — пример, о чём спросить, когда всё заработает.
• Подключение (ключи, вход, привязка Telegram), Настройки, О плагине (куда ему можно ходить и что он добавляет) и Логи. Внизу — Перезапустить, а у плагинов, которые ставил ты, ещё и Удалить. Встроенные плагины можно только выключить.

Что есть в Piomio сразу#

Эти включены с самого начала:

Эти ждут, пока ты их включишь:

Ещё в каталоге есть Доступ из любого места — личная ссылка на твой хаб (см. Доступ откуда угодно). API-интеллект появляется, только если хаб запущен с PIOMIO_API_KEYS=1 (см. Мозги и вход).

Сервисы со своим входом: Notion, Linear, Granola#

1. Попроси «подключи Notion» (или нажми Подключить в чате на его странице).
2. Нажми на карточке Войти в Notion. Откроется страница входа самого сервиса — разреши там доступ.
3. Браузер вернётся в Piomio, и карточка станет подключённой.

Если хаб работает на сервере или ты входишь с телефона, страница возврата может не открыться. Скопируй адрес из строки браузера, вставь его в поле на карточке и нажми Готово. Вход хранится в хранилище, поэтому хранилище должно быть открыто (карточка это предложит).

После этого агенты видят то, что открыто твоему аккаунту. Чтение идёт само, а создать или поменять что-то агент просит на карточке — если только ты не скажешь «Linear разрешай всегда» (см. Подтверждения и автомод). Что говорят сами сервисы: часть фильтров поиска и комментариев в Notion есть только на тарифе Business, а бесплатный тариф Granola даёт последние 30 дней. Отключить на карточке выводит Piomio из сервиса.

Приложения через Composio#

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

1. Попроси «подключи Slack через Composio». В первый раз карточка попросит API-ключ Composio: зарегистрируйся на platform.composio.dev и создай ключ в разделе Settings, API keys. Ключ попадёт в твоё хранилище.
2. Нажми Войти в Slack: страница Composio проведёт тебя через вход в Slack.
3. Разреши всё, о чём спросит сервис. На странице Google отметь все галочки: пустая галочка потом ломает инструменты приложения, и карточка попросит войти снова.

Готовы в каталоге: Slack, GitHub, Gmail, Google Диск, Документы, Таблицы, Календарь, Задачи и Meet, HubSpot, Dropbox, Box, Outlook, Microsoft Teams, OneDrive, Trello, Jira, Zoom, Calendly, Figma, Salesforce, LinkedIn, YouTube и Reddit. Для остального просто спроси: агент поищет в списке Composio (около тысячи приложений) и добавит те, в которые Composio умеет входить сам. Google Календарь, Gmail и другие приложения Google сейчас подключаются именно так.

Blender#

Включи его — и агенты смогут посмотреть сцену, объекты и файлы, сделать скриншот, отрендерить и выполнить Python в Blender. Нужен Blender 5.1 или новее на том компьютере, где работает хаб. При первом обращении Piomio сам находит Blender, ставит в него официальное дополнение MCP и открывает Blender, когда он нужен агенту. Каждое изменение сначала спрашивает тебя.

MCP-серверы#

Любой MCP-сервер может дать агентам новые инструменты. Настройки → MCP-серверы показывают подключённые серверы: состояние (подключён, подключается, ошибка, отключён), откуда он (ваш или от плагина), его инструменты и кнопку Переподключить.

Под списком — твоя конфигурация в формате .mcp.json. У сервера есть command (он запускается процессом) или url (по HTTP). Ключи и токены пишутся только ссылками vault://<id>, а сами значения хранятся в хранилище. Вставить пример подставит шаблон:

{
  "github": {
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-github"],
    "env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "vault://github_token" }
  },
  "docs": {
    "type": "http",
    "url": "https://example.com/mcp",
    "headers": { "Authorization": "vault://docs_token" }
  }
}

Нажми Сохранить. Конфигурация хранится в файле mcp.json в папке данных хаба. Инструменты, которые сервер помечает как «только чтение», работают сами, остальные сначала спрашивают тебя. Из чата агенты умеют показать список серверов и переподключить сервер; чтобы добавить сервер через чат, попроси агента обернуть его в интеграцию (ниже).

Установка плагина по ссылке#

Внизу каталога есть Установить по ссылке: туда вставляют git-репозиторий (https://…, git@…) или путь к папке на компьютере хаба. Подходят плагины Piomio, Claude Code и Codex: их скиллы, команды и MCP-серверы становятся доступны агентам.

Вставь адрес и нажми Проверить. Сначала плагин скачивается во временную папку, и ты видишь, что он просит: сайты, куда ему можно ходить, записи хранилища, действия хаба. Если есть на что обратить внимание (ходит на любые сайты, добавляет MCP-серверы, приносит скиллы), сначала включи Я доверяю этому плагину. Потом нажми Установить и включить.

Попроси агента собрать интеграцию#

Если в каталоге нет того, что нужно, попроси: «сделай интеграцию для API моего датчика качества воздуха». Агент следует своему скиллу make-integration: собирает интеграцию в рабочей папке вместе с карточкой для чата и просит разрешения её установить. На карточке подтверждения — название и всё, что она просит: адреса в интернете, секреты, действия хаба. Как только ты разрешишь, интеграция установится, включится и появится в каталоге. Правки — так же: агент поставит новую версию поверх старой.

Для разработчиков#

• docs/plugins.ru.md: API плагинов, манифесты, права, модули интерфейса.
• integrations/README.ru.md: как добавить интеграцию (npm run new:integration -- <id>) и шаблон, по которому работают агенты.