

Πώς να χρησιμοποιήσετε το QoderWake με το 2Slides: MCP για AI Employees (2026)
Γρήγορη απάντηση (≤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, περιγράφει το προϊόν του ως "Αυτόνομοι AI Employees, Επί τω Έργω". Κάθε ψηφιακός υπάλληλος ονομάζεται Waker. Ένας Waker ενεργοποιείται από μηνύματα IM, χρονοδιαγράμματα, hook events ή κλήσεις API και εκτελεί την εργασία αυτόνομα. Το QoderWake τρέχει σε macOS 13+, Linux και Windows 10+. Διαθέτει μια τοπική κονσόλα web στο 127.0.0.1:19820 και ένα πλήρες CLI, ενώ συνδέεται με το DingTalk και το Feishu.
Οι διακομιστές MCP και τα skills συνδέονται ανά Waker. Αυτός ο οδηγός δείχνει πώς να δώσετε σε έναν Waker (για παράδειγμα, στον "Reporting Assistant" σας) τη μηχανή παρουσιάσεων του 2Slides. Χρησιμοποιεί την επίσημη αναφορά CLI του QoderWake και τα endpoints του 2Slides που δοκιμάσαμε ζωντανά σε περιβάλλον παραγωγής στις 30 Σεπτεμβρίου 2026.
Γιατί να δώσετε στο 2Slides πρόσβαση σε έναν Waker;
- Οι Wakers είναι κατασκευασμένοι για επαναλαμβανόμενες εργασίες, και η μετατροπή των "αριθμών αυτής της εβδομάδας σε ένα deck" είναι ακριβώς αυτού του είδους η δουλειά.
- Το 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. Εάν το shell δεν μπορεί να βρει το qoderwake, χρησιμοποιήστε το ~/.qoderwake/bin/qoderwake.
- Ένα κλειδί API του 2Slides από το 2slides.com/api (
sk-2slides-...). Οι νέοι λογαριασμοί λαμβάνουν 500 δωρεάν μονάδες, οι οποίες καλύπτουν 50 σελίδες Fast PPT. - Node.js στη συσκευή, μόνο για τη μέθοδο stdio.
Βήμα 1: Βρείτε το Waker ID
qoderwake waker list --jsonΤα Waker IDs ξεκινούν με ag_. Αντιγράψτε αυτό που αντιστοιχεί στον Waker που πρόκειται να δημιουργεί decks. Τα παρακάτω παραδείγματα χρησιμοποιούν το ag_xxx.
Μέθοδος 1: Hosted 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 σε διπλά εισαγωγικά, όπως φαίνεται. Χωρίς εισαγωγικά, το shell το χωρίζει σε δύο ορίσματα και το header φτάνει μόνο ως 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 μεταξύ διαφορετικών shells μπορεί να είναι περίπλοκη. Σε αυτή την περίπτωση, η εισαγωγή μέσω αρχείου στη Μέθοδο 2 είναι η ασφαλέστερη επιλογή.
Εναλλακτική λύση χωρίς header. Εάν το header εξακολουθεί να μην φτάνει (σφάλμα 401 ή Authentication required κατά την ανανέωση των εργαλείων), παραλείψτε εντελώς τα headers. Το 2Slides δέχεται επίσης το κλειδί ως παράμετρο ερωτήματος URL (query parameter), και δοκιμάσαμε αυτή τη μορφή πλήρως:
qoderwake mcp add --waker-id ag_xxx \
--name 2slides \
--transport http \
--http-url "https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY"Χειριστείτε αυτό το URL σαν κωδικό πρόσβασης: μην το επικολλάτε σε εργασίες ή στιγμιότυπα οθόνης και κάντε rotate το κλειδί στο 2slides.com/api εάν διαρρεύσει.
Το 2Slides χρησιμοποιεί ένα απλό κλειδί API, όχι OAuth, επομένως αφήστε απενεργοποιημένα όλα τα flags --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 δέχεται ο εισαγωγέας. Το παραπάνω block είναι η κοινή μορφή mcpServers. Εάν η εισαγωγή απορριφθεί, χρησιμοποιήστε τα flags της Μεθόδου 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. Αυτό απαιτεί Node.js στο μηχάνημα όπου τρέχει ο Waker, και το 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 είναι να επικυρώνετε έναν νέο connector με μια κλήση μόνο για ανάγνωση πρώτα:
List the tools you have from 2slides, then search for a "minimal" theme and show me the themeId.Το themes_search είναι δωρεάν, επομένως αυτή η δοκιμή δεν κοστίζει τίποτα. Εάν ένας connector δυσλειτουργεί, το qoderwake mcp toggle --waker-id ag_xxx --mcp-id <mid> --enabled false τον απενεργοποιεί χωρίς να τον διαγράψει.
Μέθοδος 4: Μεταφόρτωση του 2Slides skill
Τα QoderWake skills είναι πακέτα δυνατοτήτων με έκδοση git που μπορείτε να συγκρίνετε (diff) και να επαναφέρετε. Μεταφορτώνετε "ένα αρχείο Markdown ή ένα αρχείο αρχειοθέτησης που περιέχει το SKILL.md". Το επίσημο 2Slides skill βρίσκεται στο 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 του skill (Python 3 και requests) διαβάζουν το κλειδί από τη μεταβλητή περιβάλλοντος SLIDES_2SLIDES_API_KEY.
Κανόνας για τα μυστικά (Secrets). Τα έγγραφα του QoderWake αναφέρουν: "Ποτέ μην τοποθετείτε μυστικά, tokens ή cookies σε εργασίες, μνήμη, βάσεις γνώσεων, αρχεία ρόλων ή στιγμιότυπα οθόνης." Τα διαπιστευτήρια ανήκουν σε προστατευμένα πεδία ή μεταβλητές περιβάλλοντος. Επομένως, μην επικολλάτε ποτέ το κλειδί σας σε ένα prompt εργασίας και μην λέτε στον Waker να το "θυμηθεί". Το QoderWake δεν τεκμηριώνει κάποιον τρόπο μεταβίβασης μεταβλητών περιβάλλοντος σε σενάρια skill, επομένως προτείνουμε αυτόν τον διαχωρισμό:
- Χρησιμοποιήστε τον σύνδεσμο MCP (Μέθοδος 1) για τις πραγματικές κλήσεις API. Το κλειδί παραμένει στην κεφαλίδα του.
- Χρησιμοποιήστε το skill μόνο εάν η μεταβλητή
SLIDES_2SLIDES_API_KEYείναι ήδη ορισμένη στο περιβάλλον όπου εκτελείται ο Waker. Ελέγξτε το με μια δοκιμαστική εργασία που εκτελεί τοscripts/search_themes.py --query minimal --limit 1.
Δημιουργήστε το πρώτο σας deck
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. Στη δοκιμή παραγωγής μας, ένα Fast PPT deck 3 σελίδων επιστράφηκε σε περίπου 22 δευτερόλεπτα. Ο σύνδεσμος λήγει μετά από 1 ώρα. Τα έγγραφα του QoderWake αναφέρουν ότι η παράδοση αρχείων "εξαρτάται από τις δυνατότητες του καναλιού. Χρησιμοποιήστε τον σύνδεσμο που επιστράφηκε ή το παραδοτέο της εργασίας". Επομένως, ζητήστε από τον Waker να δημοσιεύσει τον σύνδεσμο αμέσως ή να κατεβάσει το .pptx στον χώρο εργασίας του. Στη συνέχεια, μπορείτε να το ανακτήσετε από τη συνεδρία με το qoderwake session artifacts --session-id sess_xxx.
Περιπτώσεις χρήσης για έναν AI employee
Ενεργοποίηση από DingTalk ή Feishu. Μόλις ένας Waker συζευχθεί με ένα κανάλι DingTalk ή Feishu, ένας συνεργάτης μπορεί να στείλει μήνυμα "@Reporting Assistant φτιάξε μια ενημέρωση 6 διαφανειών για το πλάνο προσλήψεων του 4ου τριμήνου". Ο Waker συγκεντρώνει το πλαίσιο, καλεί το 2Slides και απαντά με τον σύνδεσμο.
Ένα εβδομαδιαίο deck βάσει προγράμματος. Η αναφορά 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 ανάμεσα σε 1.500+ θέματα | Δωρεάν |
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 | narration vocale IA για μια εργασία Nano Banana | 210 / σελίδα |
slides_download_slides_pages_voices | ZIP με εικόνες σελίδων, ήχο και μεταγραφή | Δωρεάν |
jobs_get | Έλεγχος κατάστασης (polling) μιας ασύγχρονης εργασίας (κάθε 20 έως 30 δευτερόλεπτα) | Δωρεάν |
Τι έχει επιβεβαιωθεί έναντι όσων δεν έχουν τεκμηριωθεί ακόμη (έως τις 30 Σεπτεμβρίου 2026)
| Στοιχείο | Κατάσταση |
|---|---|
waker list, mcp add flags (--transport, --http-url, --header, --headers, --json, --command, --args, --env), skill upload | Επιβεβαιώθηκε στην αναφορά QoderWake CLI |
| Τα MCP και τα skills είναι ανά Waker· τα μυστικά δεν πρέπει να μπαίνουν σε εργασίες ή μνήμη | Επιβεβαιώθηκε στα έγγραφα του QoderWake |
| 2Slides endpoint, Bearer auth, 7 εργαλεία | Δοκιμάστηκε ζωντανά από το 2Slides |
Ακριβής μορφή JSON που γίνεται αποδεκτή από το mcp add --json | Δεν έχει τεκμηριωθεί· η μορφή mcpServers εμφανίζεται ως βέλτιστη προσπάθεια |
Πώς το --header διαχωρίζει μια τιμή που περιέχει = | Δεν έχει τεκμηριωθεί· βάλτε σε εισαγωγικά ολόκληρο το ζεύγος ή χρησιμοποιήστε --headers JSON |
| Μεταβίβαση μεταβλητών περιβάλλοντος σε σενάρια skill | Δεν έχει τεκμηριωθεί |
Αντιμετώπιση προβλημάτων
- "daemon unreachable". Εκτελέστε το
qoderwake status. Εάν ο daemon δεν εκτελείται,qoderwake start. Εάν η θύρα είναι κατειλημμένη,qoderwake start --port auto. - 401 από το ίδιο το QoderWake. Εκτελέστε το
qoderwake whoami, και τοqoderwake loginξανά εάν χρειάζεται. - 401 από το 2Slides. Η κεφαλίδα πιθανώς έφτασε χωρίς το κλειδί. Προσθέστε το ξανά με το
--headerσε εισαγωγικά ή τη μορφή--headersJSON. - Λείπουν εργαλεία. Εκτελέστε το
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". Βάλτε σε εισαγωγικά ολόκληρο το ζεύγος κεφαλίδας, επειδή η τιμή περιέχει κενό διάστημα.
Πού πρέπει να αποθηκεύσω το κλειδί API του 2Slides στο QoderWake;
Στην κεφαλίδα του συνδέσμου MCP (--header ή --headers) ή στο --env του για stdio. Ποτέ μην το τοποθετείτε σε εργασία, μνήμη, βάση γνώσεων ή αρχείο ρόλου. Τα έγγραφα του QoderWake το απαγορεύουν ρητά.
Μπορεί ένας Waker να στείλει το PowerPoint στο DingTalk ή το Feishu;
Ο Waker μπορεί πάντα να απαντήσει με τον σύνδεσμο λήψης του 2Slides. Το αν θα επισυναφθεί το ίδιο το αρχείο εξαρτάται από το κανάλι. Τα έγγραφα του QoderWake συνιστούν τη χρήση του συνδέσμου που επιστράφηκε ή του παραδοτέου της εργασίας. Ο σύνδεσμος λήγει μετά από 1 ώρα.
Μπορεί ένας Waker να φτιάχνει ένα deck κάθε εβδομάδα αυτόματα;
Ναι. Δημιουργήστε έναν προγραμματισμένο αυτοματισμό με το qoderwake automation create schedule και μια έκφραση cron. Δοκιμάστε τον με το automation run-now προτού τον αφήσετε να εκτελεστεί χωρίς επίβλεψη.
Πόσο κοστίζει;
Οι νέοι λογαριασμοί 2Slides λαμβάνουν 500 δωρεάν πιστώσεις. Το Fast PPT κοστίζει 10 πιστώσεις ανά σελίδα, επομένως ένα εβδομαδιαίο deck 8 διαφανειών κοστίζει 80 πιστώσεις. Η αναζήτηση θεμάτων, ο έλεγχος κατάστασης εργασιών και οι εξαγωγές είναι δωρεάν.
Το συμπέρασμα
Μία εντολή
qoderwake mcp addμετατρέπει έναν Waker σε έναν υπάλληλο AI που παραδίδει πραγματικά παρουσιάσεις. Διατηρήστε το κλειδί στο MCP επικεφαλίδα, ενεργοποιήστε το από το DingTalk, το Feishu ή μέσω ενός χρονοπρογραμματισμό cron, και αποθηκεύστε το.pptxμέσα σε μία ώρα.
Σχετικοί οδηγοί: προσωπικοί AI agents που μπορούν να δημιουργήσουν διαφάνειες, QwenWork με το 2Slides, WorkBuddy με το 2Slides, χρήση οποιουδήποτε AI agent με τον 2Slides MCP server, και agent skills έναντι MCP servers.
Λάβετε το κλειδί και τις ρυθμίσεις σας στο 2slides.com/api?tab=mcp.
Πηγές:
About 2Slides
Create stunning AI-powered presentations in seconds. Transform your ideas into professional slides with 2slides AI Agent.
Try For Free