Создание контента через MCP

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

Результат это обычный проект в вашей учётной записи, сохранённый на сервере и доступный на любом устройстве, где вы вошли. Этот сценарий ничего не публикует.

Как начинается прогон

Всё начинается с generate_outline:

Можно передать и topic, и source_text: тогда тема говорит, что сделать из текста.

Кто пишет: модели Papera или ваша

По умолчанию Papera изучает тему, планирует и пишет на своих моделях, и это расходует кредиты ИИ вашей учётной записи.

Передайте use_my_model, и работа поручается модели в вашем клиенте. На каждом шаге Papera отдаёт запрос, модель вашего клиента его выполняет, а submit_agent_action возвращает результат. Papera по-прежнему планирует прогон, ведёт подтверждения и сохраняет проект. Этот путь не стоит кредитов, потому что генерация была не нашей.

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

Шаги

1. generate_outline начинает прогон и возвращает план на вашу проверку. С use_my_model он сначала возвращает запрос, а ваш клиент вызывает submit_agent_action с тем, что выдала его модель. Это повторяется для каждого шага, где нужна модель.
2. approve_outline записывает ваше решение по плану. Утверждение плана запускает написание контента.
3. approve_content записывает ваше решение по написанному контенту.
4. save_project сохраняет утверждённый контент как проект и даёт ссылку, чтобы его открыть.

generate_outline
        │
   outline  ◄── your approval (repeatable)
        │
   content  ◄── your approval (repeatable)
        │
  save_project ──► link to your project

На каждом шаге Papera называет следующий инструмент, поэтому вашему клиенту не приходится угадывать порядок.

Подтверждение и правки

На обоих шагах подтверждения клиент показывает вам черновик и спрашивает, что делать. Ответить можно так:

• Утвердить, принимая черновик как есть.
• Правкой, изменив черновик самостоятельно.
• Замечаниями своими словами, например «сделай короче и добавь раздел про цены». Papera переделает этот шаг и снова покажет результат. Повторять можно сколько угодно.

Ничего не идёт дальше, пока вы не утвердите. План закрепляется до того, как написан хоть какой-то контент, а контент закрепляется до того, как что-то сохранено.

Сохранение

save_project возвращает ссылку вида https://papera.dev/project/<id>, а вместе с ней идентификаторы проекта и процесса, которые используют инструменты процесса. Откройте ссылку, войдя в ту же учётную запись, на любом устройстве, и вы окажетесь в редакторе.

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

Если вы достигли лимита проектов

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

Что дальше

Сохранённый контент это узел контента, из которого ещё ничего не выведено. Чтобы превратить его в презентацию, документ, статью блога или пост в соцсети, переходите к статье Сборка процесса или откройте ссылку и работайте на холсте процесса в приложении.

Полностью расписанный прогон смотрите в статье Пример: презентация из ваших заметок.