# Интеграции

Раздел справки Строфи целиком, статьи в порядке чтения. Источник: https://strophe.app/docs/product/integrations

# Подключение по MCP

> Что даёт подключение внешнего AI-агента к генерации Строфи по протоколу MCP — для кого оно, на чьи кредиты работает и чем отличается от встроенного агента редактора.

Источник: https://strophe.app/docs/product/integrations/overview
Обновлено: 2026-08-27

MCP (Model Context Protocol) — способ подключить внешнего AI-агента к генерации Строфи. Claude, ChatGPT и им подобные получают доступ к тем же моделям, что и редактор, и запускают генерацию по вашей просьбе прямо в переписке — не открывая холст. Готовый результат приходит файлом.

## Для кого это

Подключение работает на платных тарифах. Доступ есть, если у вас активная подписка (в том числе отменённая, но ещё оплаченная до конца периода, и подарочная), вы состоите в непросроченной команде или вам выдан персональный безлимит. Как устроены тарифы и подписка — в статье [Тарифы и подписка](https://strophe.app/docs/product/account/plans).

## На чьи кредиты работает

Каждая генерация списывает кредиты с вашего баланса — ровно так же, как если бы вы запустили её сами в редакторе. Подробнее о списании — в статье [Кредиты и их списание](https://strophe.app/docs/product/account/credits).

Подключённому приложению вы разрешаете тратить ваши кредиты от вашего имени, поэтому подключайте только те, которым доверяете; как выдать и отозвать доступ — в статье [Как подключить агента](https://strophe.app/docs/product/integrations/connect).

## Что можно генерировать

Изображения, видео, звук и 3D — те же типы, что и на холсте. Полный перечень возможностей и границ — в статье [Что агент умеет через MCP](https://strophe.app/docs/product/integrations/capabilities).

## Где видно эти генерации

Запуски из MCP не появляются в проектах и ни к каким блокам не привязаны. Но они попадают в общий список ваших генераций — раздел «Аналитика» в меню профиля — с пометкой «Через MCP», чтобы отличать их от запусков с холста. Оттуда результат можно скачать и посмотреть, какой моделью и с какими параметрами он сделан. Как устроен этот список — в статье [Результаты и история генераций](https://strophe.app/docs/product/generation/generation-history).

## Чем это отличается от программного доступа

MCP рассчитан на готового агента: он читает описания моделей словами и решает сам. Если генерацию запускает ваша собственная программа, ей удобнее REST API — тот же каталог и тот же счёт, но машинным JSON и с кодами вместо объяснений. Он описан в разделе [Разработчикам](https://strophe.app/docs/product/developers/overview) и открыт участникам команды.

## Чем это отличается от встроенного агента

В редакторе есть свой AI-агент: он собирает блоки и цепочки прямо на холсте и работает внутри проекта — про него отдельная статья [AI-агент в редакторе](https://strophe.app/docs/product/agent/overview). По MCP подключается внешнее приложение, для которого Строфи — источник генерации: холст оно не редактирует и проект не ведёт, а только запускает генерацию и забирает результат.

---

# Как подключить агента

> Три способа дать внешнему AI-агенту доступ к генерации Строфи — попросить его самого, добавить адрес сервера в настройках агента или выпустить API-токен — и как отозвать доступ.

Источник: https://strophe.app/docs/product/integrations/connect
Обновлено: 2026-08-27

Адрес сервера один на всех: `https://strophe.app/api/mcp`. Различается только то, как этот адрес попадёт в ваше приложение.

## Попросить самого агента

У разных приложений подключение устроено по-своему, но выяснять это не обязательно: современный агент разбирается сам. Скопируйте текст ниже и отправьте ему.

```
Добавь MCP-сервер Строфи: https://strophe.app/api/mcp
Через него ты сможешь генерировать изображения, видео, звук и 3D-модели.
Если добавить сервер сам не умеешь — подскажи, где это включается у тебя.
Когда подключишься, покажи каталог: что в нём есть и от скольки кредитов.
Запускать пока ничего не надо.
```

Дальше он либо добавит сервер сам, либо продиктует шаги для своего интерфейса. При первом обращении откроется страница Строфи с запросом доступа — её нужно подтвердить.

## Добавить адрес сервера вручную

Так подключаются приложения, которые умеют добавлять внешние сервисы, но не станут делать это по просьбе.

1. Найдите в настройках приложения добавление внешнего сервиса. Называется оно везде по-разному — ищите разделы «Плагины», «Коннекторы» или «MCP».
2. Название задайте любое, а адресом сервера укажите `https://strophe.app/api/mcp`. Дополнительные поля, если приложение их спрашивает, оставьте пустыми.
3. Откроется страница Строфи с запросом доступа: на ней видно, какое приложение подключается и что оно запрашивает — генерацию от вашего имени и списание кредитов с вашего баланса. Нажмите «Разрешить».
4. После согласия приложение вернётся к себе и будет готово запускать генерацию.

Подключённое приложение появляется в настройках, в разделе «Интеграции» → «Подключённые приложения», с датой подключения. Кнопка «Отключить» рядом с ним мгновенно закрывает доступ.

## Выпустить API-токен

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

1. Откройте настройки → «Интеграции» → «API-токены» и нажмите «Добавить».
2. Задайте название, отметьте право «MCP» и, если нужно, поставьте потолки трат — в сутки и на одну генерацию. Потолки ограничивают токен, а не весь баланс.
3. Секрет показывается один раз — скопируйте и сохраните его сразу. Позже увидеть его снова нельзя.
4. В своём клиенте укажите адрес сервера `https://strophe.app/api/mcp` и вставьте токен как ключ доступа.

Список выпущенных токенов лежит там же: у каждого видно права, потраченное за сутки, дату последнего использования и срок. Права и потолки меняются кнопкой «Изменить права». Кнопка «Отозвать» выключает токен; вместе с ним перестают работать и все ссылки на результаты, которые были по нему выданы.

## Безопасность доступа

Токен и подключённое приложение действуют от вашего имени и тратят ваши кредиты, поэтому обращайтесь с ними как с паролем:

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

---

# Что агент умеет через MCP

> Полный список инструментов, которые Строфи даёт внешнему AI-агенту по MCP — каталог моделей, оценка стоимости, запуск и отмена генерации, входные файлы, баланс — и что через MCP недоступно.

Источник: https://strophe.app/docs/product/integrations/capabilities
Обновлено: 2026-08-27

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

## Инструменты

Инструментов девять, и вызываются они сами — называть их в запросе не нужно.

| Инструмент          | Что делает                                                                                 |
| ------------------- | ------------------------------------------------------------------------------------------ |
| `list_families`     | Каталог моделей: что умеет каждая, цена от, обычное время работы, сколько входов принимает |
| `get_family_schema` | Параметры и входы выбранных моделей — сразу для нескольких                                 |
| `estimate_cost`     | Стоимость нескольких вариантов запуска за один вызов                                       |
| `generate`          | Запуск генерации; единственный инструмент, который тратит кредиты                          |
| `get_generation`    | Состояние и результат: ссылка на готовый файл                                              |
| `cancel_generation` | Отмена запущенной генерации                                                                |
| `list_generations`  | История генераций, запущенных через MCP                                                    |
| `get_balance`       | Сколько кредитов доступно прямо сейчас                                                     |
| `upload_media`      | Загрузка входного файла — картинки, видео, звука или 3D                                    |

Обычный порядок работы такой: посмотреть каталог, уточнить параметры подходящих моделей, оценить стоимость, запустить генерацию и забрать результат.

## Каталог моделей

Через MCP виден тот же каталог, что и в редакторе, и модель под запрос подбирается сама. Про устройство каталога — в статье [Каталог моделей](https://strophe.app/docs/product/generation/model-catalog).

## Генерация

Запуск идёт без холста.

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

Вы можете назвать предел расхода — генерация дороже этого числа не начнётся вовсе.

## Оценка стоимости и баланс

До запуска стоимость можно оценить, причём сразу у нескольких моделей — чтобы сравнить их по цене и выбрать. Рядом видно и остаток баланса. Как формируется стоимость — в статье [Кредиты и их списание](https://strophe.app/docs/product/account/credits).

## Входные файлы

Многим моделям нужен исходный файл. Подать его можно тремя способами:

- сослаться на результат прошлой генерации, сделанной через MCP;
- загрузить файл напрямую в запросе;
- дать ссылку на файл в интернете.

Как загрузка устроена в редакторе — в статье [Загрузка файлов на холст](https://strophe.app/docs/product/files/uploading).

## Отмена

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

Генерации, запущенные на холсте, через MCP не отменяются и в списке MCP не показываются.

## Чего через MCP нельзя

- Генерировать текст — для этого у вашего приложения есть собственные возможности.
- Работать с холстом и проектами: создавать блоки, соединять их, вести проект. Для этого есть [AI-агент в редакторе](https://strophe.app/docs/product/agent/overview).
- Управлять аккаунтом — менять тариф, покупать кредиты, трогать настройки и команду.