Come usare OpenClaw con il server MCP di 2Slides (Guida 2026)

Risposta rapida (≤60 parole): OpenClaw può generare veri file PowerPoint aggiungendo il server MCP di 2Slides sotto la chiave mcp.servers in ~/.openclaw/openclaw.json. Ottieni una chiave su 2slides.com/api, aggiungi un server stdio (command: "npx", args: ["2slides-mcp"], env.API_KEY) o uno remoto (url + transport: "streamable-http"), poi chiedi al tuo agente OpenClaw di creare una presentazione.

OpenClaw è un framework open-source per agenti AI ed è un client completo del Model Context Protocol (MCP). Collega il server MCP di 2Slides e qualsiasi agente OpenClaw acquisisce la capacità di trasformare un brief — o un documento che può leggere — in un .pptx finito e modificabile.

Questa guida copre lo schema openclaw.json esatto per entrambi i trasporti (stdio locale e Streamable HTTP remoto), le scorciatoie della CLI openclaw mcp, come gli strumenti MCP emergono nei profili di strumenti dell'agente e come verificare il tutto con una sonda dal vivo.

Perché dare a OpenClaw il server di 2Slides?

Gli agenti OpenClaw ragionano, pianificano e leggono i tuoi file. Non producono file di slide binari — questo è compito di un generatore dedicato. Con 2Slides collegato:

• OpenClaw decide la struttura delle slide, i testi e la narrazione a partire dal tuo materiale di origine.
• Il server MCP di 2Slides produce il vero PowerPoint — Fast PPT basato su tema, oppure slide progettate con immagini con narrazione vocale AI opzionale e un pacchetto di asset esportabili.

Cosa ti serve prima

1. OpenClaw installato (openclaw nel tuo PATH).
2. Una chiave API di 2Slides da 2slides.com/api.
3. Node.js per il trasporto stdio (npx -y 2slides-mcp@latest). Il trasporto HTTP non richiede nulla in locale.

Stdio o Streamable HTTP: quale trasporto?

Il server MCP di 2Slides supporta entrambi. In OpenClaw, i due si distinguono semplicemente in base a quali campi imposti — non c'è alcun campo type:

Metodo 1: stdio in openclaw.json

La configurazione di OpenClaw risiede in ~/.openclaw/openclaw.json. I server MCP vanno sotto la chiave di primo livello mcp, in un oggetto servers indicizzato per nome:

Tutto qui — la presenza di command lo contrassegna come server stdio locale.

Metodo 2: Streamable HTTP in openclaw.json

Per l'endpoint ospitato, imposta url e il campo canonico transport:

Nota: il valore canonico del trasporto in OpenClaw è "streamable-http" (un alias legacy type: "http" viene accettato ma normalizzato — scrivi transport). Se la tua chiave deve stare in un header anziché nell'URL, usa "headers": { "Authorization": "Bearer YOUR_2SLIDES_API_KEY" } invece della query ?apikey=.

Oppure usa la CLI openclaw mcp

Questi scrivono nella stessa configurazione mcp.servers:

Verifica la connessione

OpenClaw include strumenti di diagnostica MCP dedicati:

Un probe riuscito elenca gli strumenti di 2Slides (slides_generate, themes_search e gli altri), confermando che l'agente può richiamarli.

Come gli strumenti raggiungono il tuo agente

Gli strumenti MCP configurati vengono esposti automaticamente nei profili di strumenti coding e messaging di OpenClaw. Note:

• Il profilo minimal nasconde gli strumenti MCP; cambia profilo se non li vedi.
• Per disabilitare esplicitamente gli strumenti MCP, aggiungi "bundle-mcp" a tools.deny.
• Per esporre solo alcuni strumenti di 2Slides, usa per server toolFilter.include / toolFilter.exclude (nomi esatti o glob *):

Per mantenere un server definito ma inattivo, imposta "enabled": false.

Genera la tua prima presentazione

Chiedi al tuo agente OpenClaw in linguaggio naturale:

OpenClaw richiama themes_search → slides_generate (Fast PPT) → restituisce il downloadUrl. Per slide personalizzate progettate con immagini usa slides_create_pdf_slides e interroga jobs_get (circa ogni 20 secondi) finché non è pronto.

L'elenco degli strumenti MCP di 2Slides

Errori comuni e risoluzione dei problemi

• Usato mcpServers invece di mcp.servers. Nella configurazione di OpenClaw la chiave è mcp.servers. (mcpServers è un concetto diverso, relativo ai client esterni — eseguire OpenClaw come server.)
• Scritto type invece di transport. type è un alias legacy; il campo canonico è transport: "streamable-http".
• Gli strumenti non compaiono. Probabilmente sei sul profilo minimal, oppure tools.deny contiene bundle-mcp. Passa a coding/messaging ed esegui openclaw mcp reload.
• Il server stdio non si avvia. Verifica che Node.js sia installato e che API_KEY sia impostato in env.
• Polling dei job asincroni. Lascia che l'agente interroghi jobs_get circa ogni 20s; i job Nano Banana e di narrazione sono asincroni per impostazione predefinita.

Domande frequenti

OpenClaw supporta server MCP personalizzati?

Sì. OpenClaw è un client MCP nativo. Aggiungi i server sotto la chiave mcp.servers in ~/.openclaw/openclaw.json, oppure tramite openclaw mcp add / openclaw mcp set. Sono supportati sia il trasporto stdio che Streamable HTTP.

Qual è la chiave di configurazione per i server MCP in OpenClaw?

mcp.servers — un oggetto indicizzato per nome all'interno dell'oggetto di primo livello mcp. I server locali usano command/args/env; i server remoti usano url + transport: "streamable-http".

Come confermo che 2Slides è connesso?

Esegui openclaw mcp probe 2slides --json per una connessione dal vivo che elenca gli strumenti esposti, oppure openclaw mcp doctor 2slides --probe per i controlli statici più un test di connessione.

Genera un vero PowerPoint?

Sì. slides_generate restituisce un .pptx modificabile; gli strumenti Nano Banana restituiscono presentazioni progettate con immagini con narrazione AI opzionale e un pacchetto esportabile.

Dove ottengo la chiave e la configurazione?

Su 2slides.com/api?tab=mcp — la tua chiave, una configurazione pronta da copiare e l'endpoint Streamable HTTP.

In sintesi

Una sola voce mcp.servers in openclaw.json dà a ogni agente OpenClaw un generatore di slide. Stdio per il locale, transport: "streamable-http" per il remoto — poi openclaw mcp probe per dimostrare che funziona.

Per il contesto più ampio, vedi come l'MCP sta cambiando i flussi di lavoro delle presentazioni e la mappa dell'ecosistema dei server MCP per PowerPoint. Stai confrontando gli agenti? Vedi come usare Claude Code e OpenAI Codex con lo stesso server.

Ottieni la tua chiave e la configurazione su 2slides.com/api?tab=mcp e dai al tuo agente OpenClaw un percorso di una sola frase verso una presentazione finita.

Fonti:

• OpenClaw — MCP CLI docs
• 2Slides API & MCP server