2Slides Team
7 min read
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.serversin~/.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
- OpenClaw installato (
openclawnel tuo PATH). - Una chiave API di 2Slides da 2slides.com/api.
- 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:
| Stdio (locale) | Streamable HTTP (remoto) | |
|---|---|---|
| Campo identificativo | command presente | url presente |
| Campo del trasporto | n/d | transport: "streamable-http" |
| Node.js locale | Richiesto | Non richiesto |
| Ideale per | Agenti locali, controllo completo | Agenti remoti/ospitati, CI |
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:
{
"mcp": {
"servers": {
"2slides": {
"command": "npx",
"args": ["-y", "2slides-mcp@latest"],
"env": { "API_KEY": "YOUR_2SLIDES_API_KEY" }
}
}
}
}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:
{
"mcp": {
"servers": {
"2slides": {
"url": "https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY",
"transport": "streamable-http"
}
}
}
}Nota: il valore canonico del trasporto in OpenClaw è
"streamable-http"(un alias legacytype: "http"viene accettato ma normalizzato — scrivitransport). 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:
# stdio
openclaw mcp add 2slides --command npx --arg 2slides-mcp --env API_KEY=YOUR_2SLIDES_API_KEY
# remote (set the full server object as JSON)
openclaw mcp set 2slides '{"url":"https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY","transport":"streamable-http"}'Verifica la connessione
OpenClaw include strumenti di diagnostica MCP dedicati:
openclaw mcp status --verbose # resolved transport/auth/timeouts (static, no connection)
openclaw mcp doctor 2slides --probe # static checks, then a live connection test
openclaw mcp probe 2slides --json # connect live and list the exposed tools
openclaw mcp reload # drop cached in-process MCP runtimesUn 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
minimalnasconde gli strumenti MCP; cambia profilo se non li vedi. - Per disabilitare esplicitamente gli strumenti MCP, aggiungi
"bundle-mcp"atools.deny. - Per esporre solo alcuni strumenti di 2Slides, usa per server
toolFilter.include/toolFilter.exclude(nomi esatti o glob*):
{
"mcp": {
"servers": {
"2slides": {
"command": "npx",
"args": ["-y", "2slides-mcp@latest"],
"env": { "API_KEY": "YOUR_2SLIDES_API_KEY" },
"toolFilter": { "include": ["themes_search", "slides_generate", "jobs_get"] }
}
}
}
}Per mantenere un server definito ma inattivo, imposta "enabled": false.
Genera la tua prima presentazione
Chiedi al tuo agente OpenClaw in linguaggio naturale:
Read PROJECT_BRIEF.md and generate an 8-slide overview deck.
Find a clean "minimal" theme from 2slides first, then create
the PowerPoint and give me the download link.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
| Strumento | Cosa fa | Crediti |
|---|---|---|
themes_search | Trova un themeId per Fast PPT | Gratis |
slides_generate | PowerPoint basato su tema (Fast PPT), sincrono/asincrono | 10 / pagina |
slides_create_pdf_slides | Slide personalizzate progettate con immagini a partire dal testo (Nano Banana) | 100 / pagina (1K/2K), 200 (4K) |
slides_create_like_this | Slide che ricalcano lo stile di un'immagine di riferimento | 100 / pagina (1K/2K), 200 (4K) |
slides_generate_narration | Aggiunge narrazione vocale AI a un job Nano Banana | 210 / pagina |
slides_download_slides_pages_voices | Esporta pagine + audio in un file ZIP | Gratis |
jobs_get | Interroga un job asincrono fino al completamento | Gratis |
Errori comuni e risoluzione dei problemi
- Usato
mcpServersinvece dimcp.servers. Nella configurazione di OpenClaw la chiave èmcp.servers. (mcpServersè un concetto diverso, relativo ai client esterni — eseguire OpenClaw come server.) - Scritto
typeinvece ditransport.typeè un alias legacy; il campo canonico ètransport: "streamable-http". - Gli strumenti non compaiono. Probabilmente sei sul profilo
minimal, oppuretools.denycontienebundle-mcp. Passa acoding/messaginged eseguiopenclaw mcp reload. - Il server stdio non si avvia. Verifica che Node.js sia installato e che
API_KEYsia impostato inenv. - Polling dei job asincroni. Lascia che l'agente interroghi
jobs_getcirca 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.serversinopenclaw.jsondà a ogni agente OpenClaw un generatore di slide. Stdio per il locale,transport: "streamable-http"per il remoto — poiopenclaw mcp probeper 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:
About 2Slides
Create stunning AI-powered presentations in seconds. Transform your ideas into professional slides with 2slides AI Agent.
Try For Free
