Kuidas kasutada QoderWake'i koos 2Slidesiga: MCP tehisintellektist töötajatele (2026)

Kiire vastus (kuni 60 sõna): Leidke oma Wakeri ID käsuga qoderwake waker list --json, seejärel käivitage 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". See Waker saab seejärel otsida 2Slidesi malle ja tagastada redigeeritava .pptx faili vastavalt vajadusele DingTalkist, Feishust või ajakava alusel.

QoderWake, mis pärineb Alibaba Qoderi meeskonnalt, nimetab oma toodet "autonoomseteks tehisintellektist töötajateks töökohal". Iga digitaalset töötajat nimetatakse nimega Waker. Wakeri käivitavad kiirsuhtlusrakenduste sõnumid, ajakavad, hook-sündmused või API-päringud ning ta teeb töö iseseisvalt ära. QoderWake töötab macOS 13+, Linuxi ja Windows 10+ operatsioonisüsteemides. Sellel on kohalik veebikonsool aadressil 127.0.0.1:19820 ja täielik CLI ning see ühildub DingTalki ja Feishuga.

MCP-serverid ja oskused lisatakse Wakeri-põhiselt. See juhend näitab, kuidas anda ühele Wakerile (näiteks teie "aruandlusassistendile") 2Slidesi esitlusmootor. Juhend kasutab ametlikku QoderWake CLI viidet ja 2Slidesi lõpppunkte, mida testisime reaalajas tootmiskeskkonnas 30. septembril 2026.

Miks anda Wakerile 2Slides?

Wakerid on loodud korduvaks tööks ja "muuda selle nädala numbrid slaidipakiks" on täpselt selline ülesanne.
2Slides loob faili: mallipõhise redigeeritava PowerPointi (Fast PPT, 10 krediiti lehe kohta) või pildidisainiga slaidid (Nano Banana, 100 krediiti lehe kohta 1K/2K resolutsioonis) koos valikulise AI-hääljutustusega.
Wakeri-põhine ulatus tähendab, et ainult see Waker, kes vajab slaide, saab tööriista ja võtme.

Mida te esmalt vajate

QoderWake on installitud ja sisse logitud. macOS-is või Linuxis pakub CLI viide üherealist installijat:

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

Windowsi ja macOS-i paketid on saadaval QoderWake'i veebisaidil. Kui kest (shell) ei leia käsku qoderwake, kasutage ~/.qoderwake/bin/qoderwake.

2Slides API võti lehelt 2slides.com/api (sk-2slides-...). Uued kontod saavad 500 tasuta krediiti, mis katab 50 Fast PPT lehekülge.
Node.js seadmes, ainult stdio meetodi puhul.

1. samm: Leidke Waker ID

qoderwake waker list --json

Wakeri ID-d algavad eesliitega ag_. Kopeerige selle Wakeri ID, kes peaks hakkama slaide tegema. Allpool toodud näited kasutavad ID-d ag_xxx.

1. meetod: Majutatud MCP üle HTTP (soovitatav)

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"

Jutumärkide kohta. CLI süntaks on --header KEY=VALUE (korduv). Siinne väärtus Bearer YOUR_2SLIDES_API_KEY sisaldab tühikut, seega pange kogu KEY=VALUE paar topeltjutumärkidesse, nagu näidatud. Ilma jutumärkideta jagab kest selle kaheks argumendiks ja päis jõuab kohale vaid kujul Bearer.

Soovite vältida = ja tühikute parsimise probleeme? Kasutage sama valiku JSON-vormingut --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 PowerShellis töötavad ka üksikjutumärgid, kuid JSON-i tsiteerimine erinevates kestades võib olla keeruline. Sellisel juhul on 2. meetodi failipõhine importimine turvalisem valik.

Varulahendus ilma päiseta. Kui päis ikkagi kohale ei jõua (tööriistade värskendamisel tekib 401 või Authentication required), loobuge päistest täielikult. 2Slides aktsepteerib võtit ka URL-i päringuparameetrina ja me testisime seda vormi algusest lõpuni:

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

Käsitlege seda URL-i nagu parooli: ärge kleepige seda ülesannetesse ega ekraanipiltidele ning lekke korral vahetage võti välja lehel 2slides.com/api.

2Slides kasutab tavalist API võtit, mitte OAuth-i, seega jätke kõik --oauth-* lipud lisamata.

2. meetod: MCP JSON-i importimine

qoderwake mcp add aktsepteerib ka --json <json> või --json-file <path> MCP JSON-i otse importimiseks. Salvestage see failina 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 viide ei täpsusta, milliseid JSON-struktuure importija aktsepteerib. Ülaltoodud plokk on tavaline mcpServers vorming. Kui import lükatakse tagasi, kasutage 1. meetodi lippe, mis on täielikult dokumenteeritud. Kustutage fail pärast seda või hoidke see Git-hoidlatest eemal, kuna see sisaldab teie võtit.

3. meetod: Kohalik stdio server

Avatud lähtekoodiga 2slides-mcp paketi käivitamiseks Wakeri seadmes:

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 võtab vastu komadega eraldatud loendi, sarnaselt CLI viites toodud ametlikule failisüsteemi näitele. --env võtab vastu JSON-i. See eeldab Node.js-i olemasolu masinas, kus Waker töötab, ning QoderWake on vaikimisi seadmesisene.

Ühenduse kontrollimine

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

Võtke <mid> väljundist mcp list. Seejärel saatke Wakerile ainult lugemisõigusega testpäring. QoderWake'i enda juhis on kontrollida uut konnektorit esmalt lugemisõigusega päringuga:

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

themes_search on tasuta, seega see test ei maksa midagi. Kui konnektor käitub valesti, lülitab qoderwake mcp toggle --waker-id ag_xxx --mcp-id <mid> --enabled false selle välja ilma seda kustutamata.

Meetod 4: 2Slidesi oskuse üleslaadimine

QoderWake'i oskused on git-versioonitud võimekuste paketid, mida saab võrrelda (diff) ja tagasi rullida. Te laadite üles "Markdown-faili või arhiivi, mis sisaldab faili SKILL.md". Ametlik 2Slidesi oskus asub aadressil github.com/2slides/slides-generation-2slides-skills. Pakkige see zip-faili nii, et SKILL.md asuks arhiivi juurkataloogis:

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

See jätab välja repositooriumis oleva vanema .skill paketi. Oskuse Pythoni skriptid (Python 3 ja requests) loevad võtit keskkonnamuutujast SLIDES_2SLIDES_API_KEY.

Saladuste reegel. QoderWake'i dokumentatsioon ütleb: "Ärge kunagi pange saladusi, tokeneid ega küpsiseid ülesannetesse, mällu, teadmusbaasidesse, rollifailidesse ega ekraanitõmmistesse." Kredentsiaalid kuuluvad kaitstud väljadele või keskkonnamuutujatesse. Seega ärge kunagi kleepige oma võtit ülesande prompti ega käskige Wakeril seda "meelde jätta". QoderWake ei dokumenteeri viisi keskkonnamuutujate edastamiseks oskuste skriptidele, seega soovitame järgmist jaotust:

Kasutage MCP konnektorit (Meetod 1) tegelike API päringute jaoks. Võti asub selle päises.
Kasutage oskust ainult siis, kui SLIDES_2SLIDES_API_KEY muutuja on juba seadistatud keskkonnas, kus Waker töötab. Kontrollige seda testülesandega, mis käivitab käsu scripts/search_themes.py --query minimal --limit 1.

Genereerige oma esimene slaidipakk

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 peaks kutsuma välja funktsiooni themes_search, seejärel slides_generate ning tagastama downloadUrl. Meie tootmistestis valmis 3-leheküljeline Fast PPT slaidipakk umbes 22 sekundiga. Link aegub 1 tunni pärast. QoderWake'i dokumentatsioon märgib, et failide edastamine "sõltub kanali võimekustest. Kasutage tagastatud linki või ülesande artifakti". Seega laske Wakeril link kohe postitada või laadige .pptx selle tööalasse alla. Seejärel saate selle sessioonist kätte käsuga qoderwake session artifacts --session-id sess_xxx.

Tehisintellektist töötaja kasutusjuhud

Käivitatakse DingTalkist või Feishust. Kui Waker on seotud DingTalki või Feishu kanaliga, saab meeskonnakaaslane saata sõnumi "@Reporting Assistant tee 6-slaidine ülevaade Q4 värbamisplaanist". Waker kogub konteksti, kutsub välja 2Slidesi ja vastab lingiga.

Iganädalane slaidipakk graafiku alusel. CLI viide dokumenteerib ajastatud automatiseerimised:

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

Käivitage see üks kord käsuga run-now ja kontrollige tulemust käsuga qoderwake automation detail, enne kui lubate sellel iseseisvalt töötada.

2Slides MCP tööriistad

Tööriist	Mida see teeb	Krediiti
`themes_search`	Leiab sobiva `themeId` enam kui 1500 teema hulgast	Tasuta
`slides_generate`	Teemapõhine muudetav PowerPoint (Fast PPT), sünkroonne või asünkroonne	10 / lehekülg
`slides_create_pdf_slides`	Pildidisainiga slaidid tekstist (Nano Banana)	100 / lehekülg (1K/2K), 200 (4K)
`slides_create_like_this`	Viitepildi stiiliga sobivad slaidid	100 / lehekülg (1K/2K), 200 (4K)
`slides_generate_narration`	AI-hääljutustus (AI voice narration) Nano Banana tööle	210 / lehekülg
`slides_download_slides_pages_voices`	Lehekülgede piltide, heli ja transkriptsiooni ZIP-fail	Tasuta
`jobs_get`	Asünkroonse töö oleku kontrollimine (iga 20–30 sekundi järel)	Tasuta

Mis on kinnitatud vs. veel dokumenteerimata (seisuga 30. september 2026)

Punkt	Staatus
`waker list`, `mcp add` lipud (`--transport`, `--http-url`, `--header`, `--headers`, `--json`, `--command`, `--args`, `--env`), `skill upload`	Kinnitatud QoderWake CLI viites
MCP ja oskused on Wakeri-põhised; saladused ei tohi sattuda ülesannetesse ega mällu	Kinnitatud QoderWake'i dokumentatsioonis
2Slidesi lõpp-punkt, Bearer-autentimine, 7 tööriista	2Slidesi poolt testitud
Täpne JSON-kuju, mida `mcp add --json` aktsepteerib	Dokumenteerimata; `mcpServers` vorm on esitatud parima oletusena
Kuidas `--header` jagab märki `=` sisaldavat väärtust	Dokumenteerimata; pange kogu paar jutumärkidesse või kasutage `--headers` JSON-it
Keskkonnamuutujate edastamine oskuste skriptidele	Dokumenteerimata

Veaotsing

"daemon unreachable". Käivitage qoderwake status. Kui deemon ei tööta, siis qoderwake start. Kui port on hõivatud, siis qoderwake start --port auto.
401 viga QoderWake'ilt endalt. Käivitage qoderwake whoami ja vajadusel uuesti qoderwake login.
401 viga 2Slidesilt. Päis saabus tõenäoliselt ilma võtmeta. Lisage see uuesti, kasutades jutumärkides --header või --headers JSON-vormingut.
Tööriistad puuduvad. Käivitage qoderwake mcp refresh-tools ja kontrollige käsuga mcp toggle ... --enabled true, kas konnektor on lubatud.
stdio tõrge. Kontrollige, kas Node.js on Wakeri seadmesse installitud ja kas --args on komadega eraldatud.
Vead käivitamisel. qoderwake log --level error --limit 100 või qoderwake trace list --status failed.
Link on aegunud. downloadUrl kehtib 1 tunni. Laske Wakeril salvestada fail ülesande artifaktina.

Korduma kippuvad küsimused

Kas QoderWake toetab kohandatud MCP-servereid?

Jah. Iga Waker saab ühendada mitu MCP-serverit stdio, HTTP või SSE kaudu, kasutades käsku qoderwake mcp add --waker-id <id> või konsooli Custom MCP Connectors vaadet.

Milline on täpne käsk 2Slidesi lisamiseks Wakerile?

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". Pange kogu päise paar jutumärkidesse, kuna väärtus sisaldab tühikut.

Kus peaksin QoderWake'is hoidma 2Slidesi API võtit?

MCP konnektori päises (--header või --headers) või selle --env väljal stdio jaoks. Ärge kunagi pange seda ülesandesse, mällu, teadmusbaasi ega rollifaili. QoderWake'i dokumentatsioon keelab selle selgesõnaliselt.

Kas Waker saab saata PowerPointi faili DingTalki või Feishusse?

Waker saab alati vastata 2Slidesi allalaadimislingiga. See, kas fail ise manustatakse, sõltub kanalist. QoderWake'i dokumentatsioon soovitab kasutada tagastatud linki või ülesande artifakti. Link aegub 1 tunni pärast.

Kas Waker saab teha slaidipaki igal nädalal automaatselt?

Jah. Looge ajastatud automatiseerimine käsuga qoderwake automation create schedule ja cron-avaldisega. Testige seda käsuga automation run-now, enne kui jätate selle järelevalveta tööle.

Kui palju see maksab?

Uued 2Slidesi kontod saavad 500 tasuta krediiti. Fast PPT maksab 10 krediiti lehekülje kohta, seega iganädalane 8-slaidine pakk on 80 krediiti. Teemaotsing, töö oleku kontrollimine ja eksportimine on tasuta.

Peamine järeldus

Üks qoderwake mcp add käsk muudab Wakeri tehisintellektist töötajaks, kes loob ja edastab valmis esitlusi. Hoidke võtit MCP päises, käivitage see DingTalkist, Feishust või cron-ajakava alusel ning salvestage .pptx tunni jooksul.

Seotud juhendid: isiklikud AI-agendid, mis suudavad luua slaide, QwenWork koos 2Slidesiga, WorkBuddy koos 2Slidesiga, kasutage mis tahes AI-agenti koos 2Slidesi MCP-serveriga ja agendi oskused vs MCP-serverid esitluste loomiseks.

Hankige oma võti ja konfiguratsioon aadressilt 2slides.com/api?tab=mcp.

Allikad: