Jak używać QoderWake z 2Slides: MCP dla pracowników AI (2026)

Q: Jaka jest dokładna komenda, aby dodać 2Slides do Wakera?

qoderwake mcp add --waker-id agxxx --name 2slides --transport http --http-url https://2slides.com/api/mcp --header "Authorization=Bearer YOUR2SLIDESAPIKEY". Ujmij całą parę nagłówka w cudzysłów, ponieważ wartość zawiera spację.

Q: Gdzie należy przechowywać klucz API 2Slides w QoderWake?

W nagłówku konektora MCP (--header lub --headers) lub w jego --env dla stdio. Nigdy nie umieszczaj go w zadaniu, pamięci, bazie wiedzy ani pliku roli. Dokumentacja QoderWake wyraźnie tego zabrania.

Q: Czy Waker może automatycznie tworzyć prezentację co tydzień?

Tak. Utwórz zaplanowaną automatyzację za pomocą qoderwake automation create schedule i wyrażenia cron. Przetestuj ją za pomocą automation run-now, zanim zaczniesz korzystać z niej bez nadzoru.

Szybka odpowiedź (≤60 słów): Znajdź ID swojego Wakera za pomocą qoderwake waker list --json, a następnie uruchom 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". Ten Waker będzie mógł przeszukiwać szablony 2Slides i zwracać edytowalny plik .pptx na żądanie z DingTalk lub Feishu, bądź według harmonogramu.

QoderWake, stworzony przez zespół Qoder z Alibaba, określa swój produkt jako „Autonomiczni pracownicy AI w pracy”. Każdy cyfrowy pracownik nazywany jest Waker. Waker jest aktywowany przez wiadomości komunikatorów (IM), harmonogramy, zdarzenia typu hook lub wywołania API i samodzielnie wykonuje powierzone zadania. QoderWake działa na systemach macOS 13+, Linux oraz Windows 10+. Posiada lokalną konsolę webową pod adresem 127.0.0.1:19820 oraz pełne CLI, a także łączy się z DingTalk i Feishu.

Serwery i umiejętności MCP są przypisywane do konkretnego Wakera. Ten przewodnik pokazuje, jak wyposażyć jednego Wakera (np. Twojego „Asystenta ds. Raportowania”) w silnik prezentacji 2Slides. Wykorzystujemy oficjalną dokumentację QoderWake CLI oraz endpointy 2Slides przetestowane na żywo w środowisku produkcyjnym 30 września 2026 r.

Dlaczego warto dać Wakerowi dostęp do 2Slides?

Wakery są stworzone do pracy powtarzalnej, a „zamiana wyników z tego tygodnia w prezentację” to dokładnie ten typ zadania.
2Slides generuje gotowy plik: edytowalny PowerPoint oparty na szablonie (Fast PPT, 10 kredytów za stronę) lub slajdy zaprojektowane jako obrazy (Nano Banana, 100 kredytów za stronę w rozdzielczości 1K/2K) z opcjonalną funkcją KI-Sprachnarration.
Zakres per-Waker oznacza, że tylko ten Waker, który faktycznie potrzebuje slajdów, otrzymuje narzędzie i klucz.

Czego potrzebujesz na start

Zainstalowany i zalogowany QoderWake. Na systemach macOS lub Linux dokumentacja CLI podaje jednostronicowy instalator:

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

Pakiety dla Windows i macOS są dostępne na stronie QoderWake. Jeśli powłoka nie może odnaleźć qoderwake, użyj ~/.qoderwake/bin/qoderwake.

Klucz API 2Slides ze strony 2slides.com/api (sk-2slides-...). Nowe konta otrzymują 500 darmowych kredytów, co pokrywa 50 stron Fast PPT.
Node.js na urządzeniu, wymagany tylko dla metody stdio.

Krok 1: Znajdź ID Wakera

qoderwake waker list --json

ID Wakerów zaczynają się od ag_. Skopiuj ID tego Wakera, który ma tworzyć prezentacje. W poniższych przykładach używamy ag_xxx.

Metoda 1: Hostowany MCP przez HTTP (zalecana)

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"

Uwaga dotycząca cudzysłowów. Składnia CLI to --header KEY=VALUE (można powtarzać). Wartość tutaj, Bearer YOUR_2SLIDES_API_KEY, zawiera spację, więc należy ująć całą parę KEY=VALUE w podwójny cudzysłów, jak pokazano powyżej. Bez cudzysłowów powłoka podzieli to na dwa argumenty, a nagłówek dotrze jedynie jako Bearer.

Chcesz całkowicie uniknąć problemów z = i parsowaniem spacji? Użyj formatu JSON dla tej samej opcji, --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"}'

W systemie Windows PowerShell działają również pojedyncze cudzysłowy, ale cytowanie JSON-a w różnych powłokach bywa kłopotliwe. W takim przypadku bezpieczniejszym wyborem jest import z pliku opisany w Metodzie 2.

Opcja rezerwowa bez nagłówka. Jeśli nagłówek nadal nie dociera (błąd 401 lub Authentication required przy odświeżaniu narzędzi), pomiń nagłówki całkowicie. 2Slides akceptuje klucz również jako parametr zapytania URL, co przetestowaliśmy kompleksowo:

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

Traktuj ten adres URL jak hasło: nie wklejaj go do zadań ani zrzutów ekranu, a w razie wycieku zresetuj klucz na 2slides.com/api.

2Slides używa zwykłego klucza API, a nie OAuth, więc pozostaw wszystkie flagi --oauth-* wyłączone.

Metoda 2: Import MCP JSON

qoderwake mcp add akceptuje również --json <json> lub --json-file <path> do bezpośredniego importu pliku MCP JSON. Zapisz poniższą treść jako 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

Dokumentacja CLI nie precyzuje dokładnie, jakie struktury JSON akceptuje importer. Powyższy blok to popularny format mcpServers. Jeśli import zostanie odrzucony, użyj flag z Metody 1, które są w pełni udokumentowane. Po zakończeniu usuń plik lub trzymaj go poza repozytoriami Git, ponieważ zawiera Twój klucz.

Metoda 3: Lokalny serwer stdio

Aby uruchomić otwartoźródłowy pakiet 2slides-mcp na urządzeniu Wakera:

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 przyjmuje listę rozdzieloną przecinkami, zgodnie z oficjalnym przykładem systemu plików w dokumentacji CLI. --env przyjmuje JSON. Ta metoda wymaga Node.js na maszynie, na której działa Waker (QoderWake domyślnie rezyduje na urządzeniu).

Weryfikacja połączenia

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

Pobierz <mid> z mcp list. Następnie wyślij Wakerowi test tylko do odczytu. Oficjalne wytyczne QoderWake to walidacja nowego konektora najpierw za pomocą wywołania typu read-only:

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

themes_search jest bezpłatne, więc ten test nic nie kosztuje. Jeśli konektor działa nieprawidłowo, qoderwake mcp toggle --waker-id ag_xxx --mcp-id <mid> --enabled false pozwala go wyłączyć bez konieczności usuwania.

Metoda 4: Przesłanie umiejętności (skill) 2Slides

Umiejętności QoderWake to pakiety możliwości wersjonowane w systemie git, które można porównywać (diff) i przywracać. Przesyłasz „plik Markdown lub archiwum zawierające SKILL.md”. Oficjalna umiejętność 2Slides znajduje się pod adresem github.com/2slides/slides-generation-2slides-skills. Spakuj ją tak, aby SKILL.md znajdował się w katalogu głównym archiwum:

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

Pomija to starszy pakiet .skill w repozytorium. Skrypty Python umiejętności (Python 3 i requests) odczytują klucz ze zmiennej środowiskowej SLIDES_2SLIDES_API_KEY.

Zasada dotycząca danych wrażliwych. Dokumentacja QoderWake mówi: „Nigdy nie umieszczaj sekretów, tokenów ani plików cookie w zadaniach, pamięci, bazach wiedzy, plikach ról ani zrzutach ekranu”. Dane uwierzytelniające powinny znajdować się w chronionych polach lub zmiennych środowiskowych. Dlatego nigdy nie wklejaj swojego klucza do promptu zadania ani nie każ Wakerowi go „zapamiętać”. QoderWake nie dokumentuje sposobu przekazywania zmiennych środowiskowych do skryptów umiejętności, dlatego zalecamy ten podział:

Używaj konektora MCP (Metoda 1) do faktycznych wywołań API. Klucz znajduje się w jego nagłówku.
Używaj umiejętności (skill) tylko wtedy, gdy zmienna SLIDES_2SLIDES_API_KEY jest już ustawiona w środowisku, w którym działa Waker. Sprawdź to za pomocą zadania testowego uruchamiającego scripts/search_themes.py --query minimal --limit 1.

Wygeneruj swoją pierwszą prezentację

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 powinien wywołać themes_search, następnie slides_generate i zwrócić downloadUrl. W naszym teście produkcyjnym 3-slajdowa prezentacja Fast PPT została zwrócona w około 22 sekundy. Link wygasa po 1 godzinie. Dokumentacja QoderWake podaje, że dostarczanie plików „zależy od możliwości kanału. Użyj zwróconego linku lub artefaktu zadania”. Poproś więc Wakera o natychmiastowe opublikowanie linku lub pobranie .pptx do jego obszaru roboczego. Możesz go następnie pobrać z sesji za pomocą qoderwake session artifacts --session-id sess_xxx.

Przypadki użycia dla pracownika AI

Wyzwalanie z DingTalk lub Feishu. Gdy Waker zostanie sparowany z kanałem DingTalk lub Feishu, członek zespołu może wysłać wiadomość „@Reporting Assistant przygotuj 6-slajdową aktualizację planu zatrudnienia na Q4”. Waker zbiera kontekst, wywołuje 2Slides i odpowiada linkiem.

Cotygodniowa prezentacja według harmonogramu. Dokumentacja CLI opisuje zaplanowane automatyzacje:

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

Uruchom to raz za pomocą run-now i sprawdź wynik za pomocą qoderwake automation detail, zanim pozwolisz systemowi działać samodzielnie.

Narzędzia MCP 2Slides

Narzędzie	Działanie	Kredyty
`themes_search`	Znajdź `themeId` wśród ponad 1500 motywów	Bezpłatnie
`slides_generate`	Edytowalny PowerPoint na bazie motywu (Fast PPT), synchronicznie lub asynchronicznie	10 / strona
`slides_create_pdf_slides`	Slajdy zaprojektowane jako obrazy z tekstu (Nano Banana)	100 / strona (1K/2K), 200 (4K)
`slides_create_like_this`	Slajdy pasujące do stylu obrazu referencyjnego	100 / strona (1K/2K), 200 (4K)
`slides_generate_narration`	KI-Sprachnarration dla zadania Nano Banana	210 / slajd
`slides_download_slides_pages_voices`	ZIP z obrazami stron, dźwiękiem i transkrypcją	Bezpłatnie
`jobs_get`	Odpytywanie zadania asynchronicznego (co 20–30 sekund)	Bezpłatnie

Co zostało potwierdzone, a co nie jest jeszcze udokumentowane (stan na 30 września 2026 r.)

Element	Status
Flagi `waker list`, `mcp add` (`--transport`, `--http-url`, `--header`, `--headers`, `--json`, `--command`, `--args`, `--env`), `skill upload`	Potwierdzone w dokumentacji QoderWake CLI
MCP i umiejętności są przypisane do Wakera; sekrety nie mogą trafiać do zadań ani pamięci	Potwierdzone w dokumentacji QoderWake
Endpoint 2Slides, autoryzacja Bearer, 7 narzędzi	Przetestowane na żywo przez 2Slides
Dokładna struktura JSON akceptowana przez `mcp add --json`	Brak dokumentacji; forma `mcpServers` wskazana jako najlepsza próba
Jak `--header` dzieli wartość zawierającą `=`	Brak dokumentacji; ujmij całą parę w cudzysłów lub użyj JSON `--headers`
Przekazywanie zmiennych środowiskowych do skryptów umiejętności	Brak dokumentacji

Rozwiązywanie problemów

"daemon unreachable". Uruchom qoderwake status. Jeśli demon nie działa, qoderwake start. Jeśli port jest zajęty, qoderwake start --port auto.
Błąd 401 z samego QoderWake. Uruchom qoderwake whoami i w razie potrzeby ponownie qoderwake login.
Błąd 401 z 2Slides. Nagłówek prawdopodobnie dotarł bez klucza. Dodaj go ponownie, używając ujętego w cudzysłów --header lub formy JSON --headers.
Brakujące narzędzia. Uruchom qoderwake mcp refresh-tools i sprawdź, czy konektor jest włączony za pomocą mcp toggle ... --enabled true.
Błąd stdio. Sprawdź, czy Node.js jest zainstalowany na urządzeniu Wakera i czy --args są rozdzielone przecinkami.
Błędy podczas uruchomienia. qoderwake log --level error --limit 100 lub qoderwake trace list --status failed.
Link wygasł. downloadUrl jest ważny przez 1 godzinę. Poproś Wakera o zapisanie pliku jako artefaktu zadania.

Często zadawane pytania

Czy QoderWake obsługuje niestandardowe serwery MCP?

Tak. Każdy Waker może podłączyć kilka serwerów MCP przez stdio, HTTP lub SSE, używając qoderwake mcp add --waker-id <id> lub ekranu Custom MCP Connectors w konsoli.

Jaka jest dokładna komenda, aby dodać 2Slides do Wakera?

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". Ujmij całą parę nagłówka w cudzysłów, ponieważ wartość zawiera spację.

Gdzie należy przechowywać klucz API 2Slides w QoderWake?

W nagłówku konektora MCP (--header lub --headers) lub w jego --env dla stdio. Nigdy nie umieszczaj go w zadaniu, pamięci, bazie wiedzy ani pliku roli. Dokumentacja QoderWake wyraźnie tego zabrania.

Czy Waker może wysłać PowerPointa do DingTalk lub Feishu?

Waker zawsze może odpowiedzieć linkiem do pobrania z 2Slides. To, czy sam plik zostanie załączony, zależy od kanału. Dokumentacja QoderWake zaleca korzystanie ze zwróconego linku lub artefaktu zadania. Link wygasa po 1 godzinie.

Czy Waker może automatycznie tworzyć prezentację co tydzień?

Tak. Utwórz zaplanowaną automatyzację za pomocą qoderwake automation create schedule i wyrażenia cron. Przetestuj ją za pomocą automation run-now, zanim zaczniesz korzystać z niej bez nadzoru.

Ile to kosztuje?

Nowe konta 2Slides otrzymują 500 darmowych kredytów. Fast PPT kosztuje 10 kredytów za stronę, więc cotygodniowa 8-slajdowa prezentacja to koszt 80 kredytów. Wyszukiwanie motywów, sprawdzanie statusu zadania i eksporty są bezpłatne.

Podsumowanie

Jedna komenda qoderwake mcp add zmienia Wakera w pracownika AI, który dostarcza gotowe prezentacje. Przechowuj klucz w nagłówku MCP, wyzwalaj go z DingTalk, Feishu lub harmonogramu cron i zapisz .pptx w ciągu godziny.

Powiązane poradniki: osobiści agenci AI tworzący slajdy, QwenWork z 2Slides, WorkBuddy z 2Slides, używanie dowolnego agenta AI z serwerem MCP 2Slides oraz umiejętności agentów vs serwery MCP.

Pobierz swój klucz i konfigurację na stronie 2slides.com/api?tab=mcp.

Źródła: