Как использовать QoderWake с 2Slides: MCP для ИИ-сотрудников (2026)

Q: Какая точная команда для добавления 2Slides к Waker?

qoderwake mcp add --waker-id agxxx --name 2slides --transport http --http-url https://2slides.com/api/mcp --header "Authorization=Bearer YOUR2SLIDESAPIKEY". Заключите всю пару заголовка в кавычки, так как значение содержит пробел.

Q: Где в QoderWake следует хранить API-ключ 2Slides?

В заголовке MCP-коннектора (--header или --headers) или в его --env для stdio. Никогда не помещайте его в задачу, память, базу знаний или файл роли. Документация QoderWake прямо это запрещает.

Q: Может ли Waker создавать презентацию каждую неделю автоматически?

Да. Создайте автоматизацию по расписанию с помощью qoderwake automation create schedule и выражения cron. Протестируйте её с помощью automation run-now, прежде чем запускать в автономном режиме.

Краткий ответ (≤60 слов): Найдите ID вашего Waker с помощью qoderwake waker list --json, затем выполните qoderwake mcp add --waker-id ag_xxx --name 2slides --transport http --http-url https://2slides.com/api/mcp --header "Authorization=Bearer YOUR_2SLIDES_API_KEY". После этого Waker сможет искать шаблоны 2Slides и создавать редактируемые .pptx по запросу из DingTalk или Feishu, а также по расписанию.

QoderWake от команды Qoder (Alibaba) позиционирует свой продукт как «Автономные ИИ-сотрудники на рабочем месте». Каждый цифровой сотрудник называется Waker. Waker активируется сообщениями в мессенджерах, по расписанию, через события hook или вызовы API и выполняет работу самостоятельно. QoderWake работает на macOS 13+, Linux и Windows 10+. У него есть локальная веб-консоль по адресу 127.0.0.1:19820, полноценный CLI, а также интеграция с DingTalk и Feishu.

Серверы и навыки MCP подключаются индивидуально для каждого Waker. В этом руководстве показано, как наделить одного Waker (например, вашего «Ассистента по отчетности») движком презентаций 2Slides. Мы используем официальный справочник CLI QoderWake и эндпоинты 2Slides, протестированные в рабочей среде 30 сентября 2026 года.

Зачем давать Waker доступ к 2Slides?

Wakers созданы для регулярной работы, и задача «превратить цифры этой недели в презентацию» — именно такой тип работы.
2Slides создает готовый файл: редактируемый PowerPoint на основе шаблона (Fast PPT, 10 кредитов за страницу) или слайды с дизайном в виде изображений (Nano Banana, 100 кредитов за страницу в 1K/2K) с опциональным AI-озвучкой.
Область видимости на уровне Waker означает, что инструмент и ключ получает только тот Waker, которому действительно нужно создавать слайды.

Что вам понадобится

Установленный и авторизованный QoderWake. Для macOS или Linux в справочнике CLI указана команда для установки в одну строку:

curl -fsSL https://qoder-ide.oss-ap-southeast-1.aliyuncs.com/qoderwake/install.sh | bash
qoderwake login
qoderwake start      # daemon on 127.0.0.1:19820

Пакеты для Windows и macOS доступны на сайте QoderWake. Если оболочка не находит qoderwake, используйте ~/.qoderwake/bin/qoderwake.

Ключ API 2Slides, полученный на 2slides.com/api (sk-2slides-...). Новые аккаунты получают 500 бесплатных кредитов, чего хватит на 50 страниц Fast PPT.
Node.js на устройстве (требуется только для метода stdio).

Шаг 1: Найдите ID вашего Waker

qoderwake waker list --json

ID Waker начинаются с ag_. Скопируйте ID того Waker, который должен создавать презентации. В примерах ниже используется ag_xxx.

Метод 1: Размещенный MCP через HTTP (рекомендуется)

qoderwake mcp add --waker-id ag_xxx \
  --name 2slides \
  --description "2Slides presentation generator" \
  --transport http \
  --http-url https://2slides.com/api/mcp \
  --header "Authorization=Bearer YOUR_2SLIDES_API_KEY"

О кавычках. Синтаксис CLI — --header KEY=VALUE (можно повторять). Значение здесь, Bearer YOUR_2SLIDES_API_KEY, содержит пробел, поэтому заключите всю пару KEY=VALUE в двойные кавычки, как показано выше. Без кавычек оболочка разделит её на два аргумента, и заголовок придет в виде Bearer.

Хотите полностью избежать проблем с парсингом = и пробелов? Используйте JSON-форму того же параметра, --headers <json>:

qoderwake mcp add --waker-id ag_xxx \
  --name 2slides \
  --transport http \
  --http-url https://2slides.com/api/mcp \
  --headers '{"Authorization":"Bearer YOUR_2SLIDES_API_KEY"}'

В Windows PowerShell также работают одинарные кавычки, но оформление JSON в разных оболочках может быть неудобным. В таком случае импорт через файл в Методе 2 будет более надежным выбором.

Запасной вариант без заголовков. Если заголовок все равно не проходит (ошибка 401 или Authentication required при обновлении инструментов), откажитесь от заголовков совсем. 2Slides также принимает ключ как параметр запроса в URL, и мы протестировали эту форму от и до:

qoderwake mcp add --waker-id ag_xxx \
  --name 2slides \
  --transport http \
  --http-url "https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY"

Относитесь к этому URL как к паролю: не вставляйте его в задачи или скриншоты, и смените ключ на 2slides.com/api, если произошла утечка.

2Slides использует простой ключ API, а не OAuth, поэтому оставьте все флаги --oauth-* выключенными.

Метод 2: Импорт MCP JSON

qoderwake mcp add также принимает --json <json> или --json-file <path> для прямого импорта MCP JSON. Сохраните это как 2slides-mcp.json:

{
  "mcpServers": {
    "2slides": {
      "type": "streamable-http",
      "url": "https://2slides.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_2SLIDES_API_KEY"
      }
    }
  }
}

qoderwake mcp add --waker-id ag_xxx --json-file 2slides-mcp.json

В справочнике CLI не указано точно, какие структуры JSON принимает импортер. Блок выше — это стандартный формат mcpServers. Если импорт отклонен, используйте флаги из Метода 1, которые полностью документированы. Удалите файл после использования или не добавляйте его в Git-репозитории, так как он содержит ваш ключ.

Метод 3: Локальный сервер stdio

Чтобы запустить пакет с открытым исходным кодом 2slides-mcp на устройстве Waker:

qoderwake mcp add --waker-id ag_xxx \
  --name 2slides \
  --transport stdio \
  --command npx \
  --args "-y,2slides-mcp@latest" \
  --env '{"API_KEY":"YOUR_2SLIDES_API_KEY"}'

--args принимает список, разделенный запятыми, в том же стиле, что и официальный пример файловой системы в справочнике CLI. --env принимает JSON. Для этого метода на машине, где запущен Waker, необходим Node.js (по умолчанию QoderWake работает локально на устройстве).

Проверка соединения

qoderwake mcp list --waker-id ag_xxx                      # 2slides should be listed
qoderwake mcp refresh-tools --waker-id ag_xxx --mcp-id <mid>
qoderwake mcp get --waker-id ag_xxx --mcp-id <mid>        # inspect the entry

Возьмите <mid> из mcp list. Затем отправьте Waker тестовый запрос «только для чтения». Собственная рекомендация QoderWake — сначала проверять новый коннектор вызовом, не вносящим изменений:

List the tools you have from 2slides, then search for a "minimal" theme and show me the themeId.

themes_search бесплатен, поэтому этот тест ничего не стоит. Если коннектор ведет себя некорректно, qoderwake mcp toggle --waker-id ag_xxx --mcp-id <mid> --enabled false позволяет отключить его, не удаляя.

Способ 4: Загрузка навыка 2Slides

Навыки QoderWake — это пакеты возможностей с версионным контролем через git, которые можно сравнивать (diff) и откатывать. Вы загружаете «файл Markdown или архив, содержащий SKILL.md». Официальный навык 2Slides доступен по адресу github.com/2slides/slides-generation-2slides-skills. Упакуйте его в zip-архив так, чтобы SKILL.md находился в корне:

git clone https://github.com/2slides/slides-generation-2slides-skills
cd slides-generation-2slides-skills
zip -r ../2slides-skill.zip SKILL.md scripts references
cd ..
qoderwake skill upload 2slides-skill.zip --waker-id ag_xxx

Это исключит старый бандл .skill из репозитория. Скрипты навыка на Python (Python 3 и requests) считывают ключ из переменной окружения SLIDES_2SLIDES_API_KEY.

Правило секретов. В документации QoderWake указано: «Никогда не помещайте секреты, токены или файлы cookie в задачи, память, базы знаний, файлы ролей или скриншоты». Учетные данные должны находиться в защищенных полях или переменных окружения. Поэтому никогда не вставляйте свой ключ в промпт задачи и не просите Waker «запомнить» его. В документации QoderWake не описан способ передачи переменных окружения напрямую в скрипты навыков, поэтому мы рекомендуем следующее разделение:

Используйте MCP-коннектор (Способ 1) для фактических вызовов API. Ключ хранится в его заголовке.
Используйте навык (skill) только в том случае, если переменная SLIDES_2SLIDES_API_KEY уже задана в среде, где запущен Waker. Проверьте это с помощью тестовой задачи, выполняющей scripts/search_themes.py --query minimal --limit 1.

Создание первой презентации

Read sales_week39.csv in the project, summarize the key movements,
and build an 8-slide weekly sales review with 2slides. Search for a
clean business theme first, then generate the PowerPoint and send
me the download link.

Waker должен вызвать themes_search, затем slides_generate и вернуть downloadUrl. В нашем производственном тесте создание 3-страничной презентации Fast PPT заняло около 22 секунд. Ссылка истекает через 1 час. В документации QoderWake говорится, что доставка файлов «зависит от возможностей канала. Используйте возвращенную ссылку или артефакт задачи». Поэтому попросите Waker сразу отправить ссылку или скачать .pptx в рабочую область. Затем вы сможете забрать файл из сессии с помощью qoderwake session artifacts --session-id sess_xxx.

Кейсы использования для ИИ-сотрудника

Запуск из DingTalk или Feishu. Как только Waker привязан к каналу DingTalk или Feishu, коллега может отправить сообщение: «@Reporting Assistant, сделай отчет на 6 слайдов по плану найма на 4 квартал». Waker соберет контекст, вызовет 2Slides и ответит ссылкой.

Еженедельная презентация по расписанию. В справочнике CLI описана автоматизация по расписанию:

qoderwake automation create schedule --waker-id ag_xxx \
  --name "Weekly Sales Deck" \
  --schedule-type cron --cron "0 9 * * 1" \
  --timezone Asia/Shanghai \
  --prompt "Build this week's 8-slide sales review from the latest CSV with 2slides and post the download link"
qoderwake automation run-now --waker-id ag_xxx --automation-id tr_xxx   # test once

Запустите команду один раз с флагом run-now и проверьте результат с помощью qoderwake automation detail, прежде чем оставлять её работать автономно.

Инструменты 2Slides MCP

Инструмент	Что делает	Кредиты
`themes_search`	Поиск `themeId` среди 1500+ тем	Бесплатно
`slides_generate`	Редактируемый PowerPoint на базе темы (Fast PPT), синхронно или асинхронно	10 / страница
`slides_create_pdf_slides`	Слайды с дизайном в виде изображений из текста (Nano Banana)	100 / страница (1K/2K), 200 (4K)
`slides_create_like_this`	Слайды в стиле референсного изображения	100 / страница (1K/2K), 200 (4K)
`slides_generate_narration`	AI-озвучка для задачи Nano Banana	210 / страница
`slides_download_slides_pages_voices`	ZIP-архив с изображениями страниц, аудио и транскриптом	Бесплатно
`jobs_get`	Опрос статуса асинхронной задачи (каждые 20–30 секунд)	Бесплатно

Что подтверждено, а что еще не документировано (на 30 сентября 2026 г.)

Пункт	Статус
Флаги `waker list`, `mcp add` (`--transport`, `--http-url`, `--header`, `--headers`, `--json`, `--command`, `--args`, `--env`), `skill upload`	Подтверждено в справочнике QoderWake CLI
MCP и навыки привязаны к Waker; секреты не должны попадать в задачи или память	Подтверждено в документации QoderWake
Эндпоинт 2Slides, Bearer-авторизация, 7 инструментов	Протестировано в реальном времени командой 2Slides
Точная структура JSON, принимаемая `mcp add --json`	Не документировано; форма `mcpServers` указана как наиболее вероятная
Как `--header` разделяет значение, содержащее `=`	Не документировано; берите всю пару в кавычки или используйте JSON `--headers`
Передача переменных окружения в скрипты навыков	Не документировано

Устранение неполадок

«daemon unreachable». Выполните qoderwake status. Если демон не запущен, qoderwake start. Если порт занят, qoderwake start --port auto.
401 от самого QoderWake. Выполните qoderwake whoami и, если нужно, qoderwake login повторно.
401 от 2Slides. Вероятно, заголовок пришел без ключа. Добавьте его снова, используя --header в кавычках или JSON-форму --headers.
Инструменты отсутствуют. Выполните qoderwake mcp refresh-tools и убедитесь, что коннектор включен с помощью mcp toggle ... --enabled true.
Ошибка stdio. Проверьте, установлен ли Node.js на устройстве Waker и разделены ли значения в --args запятыми.
Ошибки при выполнении. qoderwake log --level error --limit 100 или qoderwake trace list --status failed.
Ссылка истекла. downloadUrl действует 1 час. Настройте Waker так, чтобы он сохранял файл как артефакт задачи.

Часто задаваемые вопросы

Поддерживает ли QoderWake кастомные MCP-серверы?

Да. Каждый Waker может подключать несколько MCP-серверов через stdio, HTTP или SSE, используя qoderwake mcp add --waker-id <id> или экран «Custom MCP Connectors» в консоли.

Какая точная команда для добавления 2Slides к Waker?

qoderwake mcp add --waker-id ag_xxx --name 2slides --transport http --http-url https://2slides.com/api/mcp --header "Authorization=Bearer YOUR_2SLIDES_API_KEY". Заключите всю пару заголовка в кавычки, так как значение содержит пробел.

Где в QoderWake следует хранить API-ключ 2Slides?

В заголовке MCP-коннектора (--header или --headers) или в его --env для stdio. Никогда не помещайте его в задачу, память, базу знаний или файл роли. Документация QoderWake прямо это запрещает.

Может ли Waker отправить PowerPoint в DingTalk или Feishu?

Waker всегда может отправить ссылку на скачивание от 2Slides. Будет ли прикреплен сам файл, зависит от возможностей канала. В документации QoderWake рекомендуется использовать возвращенную ссылку или артефакт задачи. Ссылка истекает через 1 час.

Может ли Waker создавать презентацию каждую неделю автоматически?

Да. Создайте автоматизацию по расписанию с помощью qoderwake automation create schedule и выражения cron. Протестируйте её с помощью automation run-now, прежде чем запускать в автономном режиме.

Сколько это стоит?

Новые аккаунты 2Slides получают 500 бесплатных кредитов. Fast PPT стоит 10 кредитов за страницу, так что еженедельная презентация на 8 слайдов обойдется в 80 кредитов. Поиск тем, опрос статуса задач и экспорт — бесплатно.

Главное

Всего одна команда qoderwake mcp add превращает Waker в ИИ-сотрудника, который создает готовые презентации. Укажите ключ в заголовке MCP, запускайте процесс через DingTalk, Feishu или по расписанию cron и сохраняйте .pptx в течение часа.

Получите свой ключ и файл конфигурации на странице 2slides.com/api?tab=mcp.

Источники: