Come usare WorkBuddy con il 2Slides MCP Server (Guida 2026)

In breve (≤60 parole): In WorkBuddy, apri Plugin → MCP Server → Configura MCP (o Connettori → Connettore personalizzato) e incolla una voce mcpServers che esegua npx -y 2slides-mcp@latest con env.API_KEY impostata sulla tua chiave 2Slides. Una spunta verde conferma la connessione. Chiedi a WorkBuddy un deck, anche via WeChat, e riceverai un link per il download del file .pptx.

WorkBuddy è l'area di lavoro per agenti AI desktop di Tencent, sviluppata dal team di CodeBuddy. Legge i tuoi file, esegue task sul computer, riceve istruzioni da WeChat, WeCom (企业微信), Feishu, DingTalk e QQ, e gestisce automazioni pianificate. Ciò che gli manca è un motore dedicato per le presentazioni. Aggiungendo il server MCP di 2Slides, WorkBuddy può trasformare un brief, un report o un messaggio in chat in un file PowerPoint modificabile. Riceverai il file tramite un link.

Questa guida copre tre configurazioni, ordinate dalla più documentata ufficialmente da WorkBuddy alla meno diretta:

1. Server MCP stdio locale (consigliato, segue esattamente la struttura della guida MCP di WorkBuddy)
2. Endpoint HTTP remoto Streamable (non richiede Node.js)
3. Skill Agente 2Slides (installazione come pacchetto skill invece di un server MCP)

Perché collegare WorkBuddy a 2Slides?

WorkBuddy eccelle nella pianificazione, nella lettura di documenti e nel lavoro cross-piattaforma. Generare un set di slide dal design curato è un compito distinto. Con 2Slides integrato:

• WorkBuddy scrive la struttura e il contenuto delle slide partendo dai tuoi file, note o richieste in chat.
• 2Slides produce il deck effettivo: un file .pptx modificabile basato su temi (Fast PPT, da oltre 1.500 modelli), oppure slide con design a immagini e AI voice narration opzionale.

Poiché WorkBuddy è attivo anche sulle app di messaggistica ed esegue task pianificati, puoi richiedere un deck dal telefono o riceverne uno generato ogni settimana senza dover aprire l'app desktop.

Requisiti preliminari

1. WorkBuddy desktop installato e con accesso effettuato (workbuddy.cn in Cina o workbuddy.ai a livello internazionale).
2. Una chiave API 2Slides da 2slides.com/api. Le chiavi hanno il formato sk-2slides-.... I nuovi account ricevono 500 crediti gratuiti, pari a 50 pagine Fast PPT (10 crediti per pagina). Il modello di fatturazione è a consumo (pagamento conforme o uso) e i crediti non scadono mai.
3. Node.js sullo stesso computer, solo per il Metodo 1 (node -v dovrebbe restituire una versione). Il Metodo 2 non richiede nulla a livello locale. Il Metodo 3 richiede Python 3 con requests.

Stato delle funzionalità (aggiornato al 30 settembre 2026)

Metodo 1: Server stdio locale (consigliato)

Questa opzione segue lo schema dell'esempio ufficiale nella guida MCP di WorkBuddy (command, args, env), risultando la più affidabile.

Passaggio 1. Apri l'editor MCP. Segui uno di questi percorsi:

• Barra laterale → 插件 (Plugin) → MCP 服务器 (MCP Server) (in alto a destra) → 配置 MCP (Configura MCP)
• 连接器 (Connettori) → 自定义连接器 (Connettore personalizzato) (in alto a destra) → 配置 MCP (Configura MCP)

Oppure modifica direttamente ~/.workbuddy/mcp.json per tutti i progetti, o <project>/.workbuddy/mcp.json per un singolo progetto.

Passaggio 2. Incolla questa voce (uniscila a mcpServers se hai già altri server):

Passaggio 3. Salva e verifica lo stato. Una spunta verde ✓ accanto a 2slides indica che WorkBuddy ha avviato il server e caricato gli strumenti. Una croce rossa ✗ indica un problema di configurazione (vedi risoluzione problemi).

Note:

• La variabile d'ambiente deve chiamarsi esattamente API_KEY. È il nome letto dal pacchetto npm 2slides-mcp.
• La documentazione Open Platform di WorkBuddy riporta le voci stdio con un "type": "stdio" extra. Puoi aggiungerlo, ma l'esempio della guida utente funziona anche senza.
• Il server gira sul tuo computer: affinché le richieste da WeChat o pianificate vadano a buon fine, il computer deve essere attivo e WorkBuddy aperto.

Metodo 2: Endpoint HTTP remoto Streamable

2Slides ospita un server MCP all'indirizzo https://2slides.com/api/mcp. Accetta la chiave come header Bearer o nell'URL. Non essendoci OAuth, dovrai passare la chiave manualmente.

La guida MCP per l'utente finale di WorkBuddy mostra solo esempi stdio. Tuttavia, i documenti dei connettori Open Platform di WorkBuddy usano "type": "streamableHttp" per i server remoti, e le guide di terze parti (come quella di Wolters Kluwer) usano lo stesso valore tramite Connettori → Connettore personalizzato → Configura MCP. Usa questo formato:

Se preferisci non inserire la chiave nell'URL, usa un header:

Se lo stato rimane rosso: WorkBuddy appartiene alla stessa famiglia di Tencent CodeBuddy; i doc CLI di quest'ultimo indicano i server remoti come "type": "http" con url + headers. Prova a cambiare "streamableHttp" in "http". Se nessuna delle due opzioni funziona nella tua build, torna al Metodo 1, che segue lo schema documentato.

Sicurezza: Un URL contenente ?apikey= è un segreto, proprio come la chiave stessa. Non incollarlo in chat condivise o screenshot, e non includerlo in un file .workbuddy/mcp.json a livello di progetto se intendi condividerlo. In caso di esposizione, elimina la chiave e creane una nuova su 2slides.com/api.

Metodo 3: Installare la skill di 2Slides

WorkBuddy supporta le skill basate su SKILL.md. La skill ufficiale di 2Slides (name: 2slides) include script Python che richiamano le REST API di 2Slides. Per questa opzione non è necessario un server MCP.

Opzione A: caricare il pacchetto.

1. Su GitHub, apri 2slides/slides-generation-2slides-skills → Code → Download ZIP.
2. Nella pagina delle skill di WorkBuddy, scegli 上传技能 (Carica Skill) e trascina lo ZIP, oppure clicca su 选择文件. WorkBuddy completerà l'importazione automaticamente.

Installa lo ZIP dalla repo corrente, non il vecchio bundle 2slides.skill all'interno della repo.

Opzione B: chiedere in chat. Digita qualcosa come "查找技能：2Slides presentation generation" (trova una skill), oppure incolla l'URL della repo GitHub e chiedi a WorkBuddy di installarla come skill.

Configurare la chiave. Gli script leggono la chiave dalla variabile d'ambiente SLIDES_2SLIDES_API_KEY, non da API_KEY. WorkBuddy non documenta un campo specifico per le variabili d'ambiente per singola skill. La soluzione pratica è impostarla nel profilo della tua shell (ad esempio export SLIDES_2SLIDES_API_KEY=YOUR_2SLIDES_API_KEY in ~/.zshrc su macOS, o una variabile d'ambiente utente su Windows) e poi riavviare WorkBuddy. Fai un test con: "Usa la skill 2slides per cercare un tema minimal." Questo comando esegue search_themes.py e non consuma crediti.

MCP o skill? L'MCP fornisce a WorkBuddy strumenti strutturati e un indicatore di stato. La skill non richiede Node.js e funziona bene se gestisci già altre skill. Scegline uno; non servono entrambi. Per un confronto approfondito, consulta Agent Skills vs MCP servers per le presentazioni.

Verifica del funzionamento

Avvia una nuova attività su WorkBuddy e chiedi:

Dovresti vedere la chiamata a themes_search e una lista di ID dei temi. La ricerca dei temi è gratuita, quindi questo controllo non costa nulla.

Genera il tuo primo deck

WorkBuddy chiama themes_search, poi slides_generate, e restituisce un downloadUrl per il .pptx. Nei test interni di 2Slides, un Fast PPT di 3 pagine è stato generato in circa 22 secondi. Dieci pagine costano 100 crediti.

Il link per il download scade dopo 1 ora. Chiedi a WorkBuddy di salvare immediatamente il file in una cartella locale ("scaricalo in ~/Documents/Decks") o aprilo subito.

Due workflow in cui WorkBuddy eccelle

1. Richiedere un deck da WeChat o WeCom

WorkBuddy può ricevere istruzioni da WeChat, WeCom (企业微信), Feishu, DingTalk e QQ. Una volta collegato 2Slides, invia un messaggio dal tuo telefono:

WorkBuddy eseguirà il lavoro sul tuo computer e risponderà nella stessa chat con il link per il download. Poiché il link dura un'ora, aggiungi "salva anche una copia sul mio Desktop" per conservare il file. Se il tuo canale supporta l'invio di file, puoi chiedere a WorkBuddy di inviarti direttamente il file.

2. Deck programmati con attività di automazione

Il modulo di automazione di WorkBuddy esegue attività pianificate. Un esempio settimanale potrebbe essere:

La pagina dei Prezzi di WorkBuddy elenca il limite di attività di automazione per piano: 3 nella versione gratuita 体验版, 15 nella 标准版 (¥99/mese), 30 nella 高级版 (¥199/mese) e 99 nella 旗舰版 (¥999/mese). I crediti di WorkBuddy e i crediti di 2Slides sono separati. Ogni deck generato utilizza i crediti 2Slides della tua chiave API (10 per ogni pagina Fast PPT).

Panoramica degli strumenti MCP di 2Slides

I lavori Nano Banana e la narrazione sono asincroni e richiedono solitamente 1–3 minuti. WorkBuddy interroga jobs_get fino al completamento.

Risoluzione dei problemi

• ✗ rossa su una voce stdio. Verifica che Node.js sia installato (node -v), che il JSON sia valido (niente virgole finali) e che env contenga API_KEY. Al primo avvio npx scarica il pacchetto, quindi una rete lenta può ritardare lo stato verde.
• ✗ rossa su una voce remota. Prova "type": "http" invece di "streamableHttp". Assicurati che l'URL sia esattamente https://2slides.com/api/mcp più la query string. Se il problema persiste, usa il Metodo 1.
• 401 / non autorizzato. La chiave è errata, è stata eliminata o si trova nel campo sbagliato. Per stdio la variabile d'ambiente è API_KEY; per la skill è SLIDES_2SLIDES_API_KEY.
• Crediti insufficienti. Ricarica su 2slides.com/pricing, a partire da $5 per 2.000 crediti.
• Link scaduto. downloadUrl dura 1 ora. Chiedi a WorkBuddy di rigenerarlo o di salvare i file localmente d'ora in poi.
• Narrazione vocale IA richiesta su un deck Fast PPT. La narrazione vocale IA funziona solo sui lavori Nano Banana. Richiedi prima slides_create_pdf_slides.

Domande frequenti

WorkBuddy supporta server MCP personalizzati?

Sì. WorkBuddy include un editor MCP in Plugin → MCP Server → Configura MCP e una voce Connettore Personalizzato nella pagina dei Connettori. La configurazione viene salvata in ~/.workbuddy/mcp.json (livello utente) o <project>/.workbuddy/mcp.json (livello progetto). Una spunta verde ✓ indica che il server è connesso correttamente.

Qual è l'esatta configurazione MCP di WorkBuddy per 2Slides?

La voce consigliata è "2slides": {"command": "npx", "args": ["-y", "2slides-mcp@latest"], "env": {"API_KEY": "YOUR_2SLIDES_API_KEY"}} all'interno di mcpServers. Richiede Node.js. L'alternativa remota è "type": "streamableHttp" con "url": "https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY".

Posso chiedere a WorkBuddy un PPT tramite WeChat?

Sì. Una volta che WorkBuddy è collegato a WeChat o WeCom e 2Slides è connesso, invia la richiesta in chat. WorkBuddy genera il deck sul tuo computer e risponde con il link per il download. Il link scade dopo 1 ora, quindi chiedigli di salvarne anche una copia locale.

WorkBuddy può usare la skill di 2Slides invece di MCP?

Sì. Scarica lo ZIP della repository della skill da GitHub e trascinalo nella finestra Carica Skill di WorkBuddy, oppure chiedi a WorkBuddy di trovarla e installarla. La skill legge SLIDES_2SLIDES_API_KEY dall'ambiente e richiede Python 3 con requests.

Quanto costa?

WorkBuddy ha un piano gratuito (500 crediti WorkBuddy/mese, 3 attività di automazione) e piani a pagamento a partire da ¥99/mese. 2Slides viene fatturato separatamente: 500 crediti gratuiti per i nuovi account, Fast PPT a 10 crediti per pagina e slide con design a immagini a 100 crediti per pagina.

La configurazione remota è supportata ufficialmente da WorkBuddy?

Parzialmente. La documentazione del connettore Open Platform di WorkBuddy utilizza "type": "streamableHttp" per i server remoti, ma la guida MCP per l'utente finale mostra solo stdio. Per questo motivo, questa guida raccomanda prima stdio e indica "type": "http" come soluzione di ripiego per il remoto.

In sintesi

Una singola voce mcpServers che esegue npx -y 2slides-mcp@latest trasforma WorkBuddy in un generatore di presentazioni accessibile da WeChat, WeCom o tramite una pianificazione del lunedì mattina. Cerca la spunta verde ✓, salva i file prima che il link scada dopo un'ora e usa la skill se preferisci evitare Node.js.

Altri agent in questa serie: l'hub degli agenti AI personali per le presentazioni, QwenWork (千问办公), QoderWake, Manus e OpenClaw. Per qualsiasi altro client MCP, consulta come usare qualsiasi agente AI con il server MCP di 2Slides.

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

Fonti:

• Guida MCP di WorkBuddy (Plugin → MCP Server, percorsi mcp.json)
• Documentazione connettore Open Platform di WorkBuddy (tipi streamableHttp / stdio)
• Guida alle skill di WorkBuddy (Carica Skill, 查找技能, 创建技能)
• Prezzi di WorkBuddy (limiti attività di automazione)
• Documentazione MCP di Tencent CodeBuddy (tipo http, url, header)
• Wolters Kluwer: aggiungere un MCP remoto in WorkBuddy
• API e server MCP di 2Slides
• 2slides-mcp su GitHub
• 2Slides Agent Skill su GitHub