Come usare QoderWake con 2Slides: MCP per AI Employee (2026)

In breve (≤60 parole): Trova l'ID del tuo Waker con qoderwake waker list --json, quindi esegui 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". Quel Waker potrà cercare i temi di 2Slides e restituire un file .pptx modificabile, su richiesta da DingTalk o Feishu, oppure secondo una pianificazione prestabilita.

QoderWake, sviluppato dal team Qoder di Alibaba, definisce il suo prodotto come "AI Employee autonomi, operativi sul campo". Ogni dipendente digitale è chiamato Waker. Un Waker viene attivato da messaggi IM, pianificazioni, eventi hook o chiamate API, e svolge il lavoro in autonomia. QoderWake gira su macOS 13+, Linux e Windows 10+. Dispone di una console web locale all'indirizzo 127.0.0.1:19820 e di una CLI completa, e si connette a DingTalk e Feishu.

I server e le skill MCP vengono collegati per singolo Waker. Questa guida mostra come dotare un Waker (ad esempio, il tuo "Reporting Assistant") del motore di presentazione di 2Slides. Utilizza i riferimenti ufficiali della CLI di QoderWake e gli endpoint di 2Slides testati live in produzione il 30 settembre 2026.

Perché dotare un Waker di 2Slides?

• I Waker sono nati per il lavoro ricorrente, e "trasformare i numeri di questa settimana in un deck" è esattamente quel tipo di compito.
• 2Slides produce il file: un PowerPoint modificabile basato su temi (Fast PPT, 10 crediti per pagina), o slide con design a immagini (Nano Banana, 100 crediti per pagina a 1K/2K) con narrazione vocale IA opzionale.
• L'ambito per-Waker garantisce che solo il Waker che ha effettivamente bisogno di slide riceva lo strumento e la chiave.

Requisiti preliminari

1. QoderWake installato e accesso effettuato. Su macOS o Linux, la documentazione della CLI fornisce un installer a riga singola:

I pacchetti per Windows e macOS sono disponibili sul sito web di QoderWake. Se la shell non trova qoderwake, usa ~/.qoderwake/bin/qoderwake.

1. Una API key di 2Slides da 2slides.com/api (sk-2slides-...). I nuovi account ricevono 500 crediti gratuiti, sufficienti per 50 pagine Fast PPT.
2. Node.js sul dispositivo, necessario solo per il metodo stdio.

Passaggio 1: Trovare l'ID del Waker

Gli ID dei Waker iniziano con ag_. Copia quello relativo al Waker che dovrà creare i deck. Gli esempi seguenti utilizzano ag_xxx.

Metodo 1: MCP ospitato via HTTP (consigliato)

Nota sulle virgolette. La sintassi della CLI è --header KEY=VALUE (ripetibile). Il valore qui, Bearer YOUR_2SLIDES_API_KEY, contiene uno spazio, quindi racchiudi l'intera coppia KEY=VALUE tra virgolette doppie come mostrato. Senza virgolette, la shell la divide in due argomenti e l'header arriverebbe solo come Bearer.

Vuoi evitare del tutto i problemi di parsing di = e degli spazi? Usa il formato JSON della stessa opzione, --headers <json>:

In Windows PowerShell funzionano anche le virgolette singole, ma la gestione del JSON tra diverse shell può essere complicata. In tal caso, l'importazione tramite file del Metodo 2 è la scelta più sicura.

Fallback senza header. Se l'header continua a non arrivare (errore 401 o Authentication required al refresh dei tool), ignora completamente gli header. 2Slides accetta la chiave anche come parametro query nell'URL, e abbiamo testato questa modalità end-to-end:

Tratta questo URL come una password: non incollarlo in task o screenshot, e ruota la chiave su 2slides.com/api se dovesse trapelare.

2Slides utilizza una semplice API key, non OAuth, quindi lascia disattivati tutti i flag --oauth-*.

Metodo 2: Importare JSON MCP

qoderwake mcp add accetta anche --json <json> o --json-file <path> per importare direttamente il JSON MCP. Salva questo contenuto come 2slides-mcp.json:

La documentazione della CLI non specifica quali strutture JSON siano accettate dall'importer. Il blocco sopra segue il formato comune mcpServers. Se l'importazione viene rifiutata, usa i flag del Metodo 1, che sono completamente documentati. Elimina il file dopo l'operazione, o tienilo fuori da qualsiasi repository Git, poiché contiene la tua chiave.

Metodo 3: Server stdio locale

Per eseguire il pacchetto open-source 2slides-mcp sul dispositivo del Waker:

--args accetta una lista separata da virgole, lo stesso stile dell'esempio ufficiale del filesystem nella documentazione CLI. --env accetta JSON. Questo metodo richiede Node.js sulla macchina dove gira il Waker; ricorda che QoderWake risiede sul dispositivo per impostazione predefinita.

Verificare la connessione

Prendi il valore <mid> da mcp list. Invia quindi al Waker un test di sola lettura. Le linee guida di QoderWake suggeriscono di convalidare un nuovo connettore con una chiamata di sola lettura come prima operazione:

themes_search è gratuito, quindi questo test non costa nulla. Se un connettore non si comporta correttamente, qoderwake mcp toggle --waker-id ag_xxx --mcp-id <mid> --enabled false lo disattiva senza eliminarlo.

Metodo 4: Caricare la skill 2Slides

Le skill di QoderWake sono pacchetti di funzionalità con versionamento git che puoi confrontare (diff) e ripristinare. Per l'installazione, carica "un file Markdown o un archivio contenente SKILL.md". La skill ufficiale di 2Slides è disponibile su github.com/2slides/slides-generation-2slides-skills. Crea un file zip in modo che SKILL.md si trovi nella root dell'archivio:

Questo esclude il vecchio bundle .skill presente nel repository. Gli script Python della skill (Python 3 e requests) leggono la chiave dalla variabile d'ambiente SLIDES_2SLIDES_API_KEY.

Regola sui segreti. La documentazione di QoderWake specifica: "Non inserire mai segreti, token o cookie in task, memoria, knowledge base, file di ruolo o screenshot". Le credenziali devono essere inserite in campi protetti o variabili d'ambiente. Pertanto, non incollare mai la tua chiave nel prompt di un task e non chiedere al Waker di "ricordarla". Poiché QoderWake non documenta un modo per passare variabili d'ambiente agli script delle skill, consigliamo questa suddivisione:

• Usa il connettore MCP (Metodo 1) per le chiamate API effettive. La chiave risiede nel suo header.
• Usa la skill solo se la variabile SLIDES_2SLIDES_API_KEY è già impostata nell'ambiente in cui gira il Waker. Verifica con un task di test che esegua scripts/search_themes.py --query minimal --limit 1.

Genera il tuo primo deck

Il Waker dovrebbe chiamare themes_search, poi slides_generate, e restituire un downloadUrl. Nei nostri test di produzione, un deck Fast PPT di 3 pagine è stato generato in circa 22 secondi. Il link scade dopo 1 ora. La documentazione di QoderWake indica che la consegna dei file "dipende dalle capacità del canale. Usa il link restituito o l'artifact del task". Ti consigliamo quindi di far postare il link al Waker immediatamente, oppure di scaricare il .pptx nel suo workspace. Potrai poi recuperarlo dalla sessione con qoderwake session artifacts --session-id sess_xxx.

Casi d'uso per un AI employee

Attivazione da DingTalk o Feishu. Una volta che un Waker è associato a un canale DingTalk o Feishu, un collega può inviare un messaggio: "@Reporting Assistant crea un aggiornamento di 6 slide sul piano di assunzioni del Q4". Il Waker raccoglie il contesto, chiama 2Slides e risponde con il link.

Un deck settimanale programmato. La documentazione della CLI riporta le automazioni pianificate:

Eseguilo una volta con run-now e controlla il risultato con qoderwake automation detail prima di lasciarlo girare autonomamente.

Gli strumenti MCP di 2Slides

Cosa è confermato vs. non ancora documentato (al 30 settembre 2026)

Risoluzione dei problemi

• "daemon unreachable". Esegui qoderwake status. Se il daemon non è attivo, qoderwake start. Se la porta è occupata, qoderwake start --port auto.
• 401 da QoderWake stesso. Esegui qoderwake whoami e, se necessario, di nuovo qoderwake login.
• 401 da 2Slides. Probabilmente l'header è arrivato senza la chiave. Aggiungila di nuovo usando --header tra virgolette o il formato JSON --headers.
• Strumenti mancanti. Esegui qoderwake mcp refresh-tools e verifica che il connettore sia abilitato con mcp toggle ... --enabled true.
• Errore stdio. Verifica che Node.js sia installato sul dispositivo del Waker e che --args sia separato da virgole.
• Errori durante l'esecuzione. Usa qoderwake log --level error --limit 100 o qoderwake trace list --status failed.
• Link scaduto. downloadUrl dura 1 ora. Chiedi al Waker di salvare il file come artifact del task.

Domande frequenti

QoderWake supporta server MCP personalizzati?

Sì. Ogni Waker può montare diversi server MCP tramite stdio, HTTP o SSE, utilizzando qoderwake mcp add --waker-id <id> o la schermata "Custom MCP Connectors" nella console.

Qual è il comando esatto per aggiungere 2Slides a un 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". Racchiudi tra virgolette l'intera coppia dell'header, poiché il valore contiene uno spazio.

Dove devo conservare la chiave API di 2Slides in QoderWake?

Nell'header del connettore MCP (--header o --headers) o nel suo --env per stdio. Non inserirla mai in un task, nella memoria, nella knowledge base o nei file di ruolo. La documentazione di QoderWake lo vieta esplicitamente.

Un Waker può inviare il PowerPoint a DingTalk o Feishu?

Il Waker può sempre rispondere con il link di download di 2Slides. L'effettivo allegato del file dipende dalle capacità del canale. La documentazione di QoderWake suggerisce di usare il link restituito o l'artifact del task. Il link scade dopo 1 ora.

Un Waker può creare un deck ogni settimana automaticamente?

Sì. Crea un'automazione programmata con qoderwake automation create schedule e un'espressione cron. Testala con automation run-now prima di renderla operativa.

Quanto costa?

I nuovi account 2Slides ricevono 500 crediti gratuiti. Fast PPT costa 10 crediti per pagina, quindi un deck settimanale da 8 slide consuma 80 crediti. La ricerca dei temi, il monitoraggio dei job e gli export sono gratuiti.

In sintesi

Un singolo comando qoderwake mcp add trasforma un Waker in un dipendente AI in grado di consegnare presentazioni reali. Mantieni la chiave nell'header MCP, attivalo da DingTalk, Feishu o tramite una pianificazione cron e salva il .pptx entro un'ora.

Guide correlate: agenti AI personali per creare slide, QwenWork con 2Slides, WorkBuddy con 2Slides, usare qualsiasi agente AI con il server MCP di 2Slides e skill degli agenti vs server MCP per le presentazioni.

Ottieni la tua chiave e la configurazione su 2slides.com/api?tab=mcp.

Fonti:

• Documentazione CLI di QoderWake
• Skill e integrazioni di QoderWake
• Pagina prodotto di QoderWake
• API e server MCP di 2Slides
• Skill 2Slides su GitHub
• 2slides-mcp su GitHub