Cómo usar QoderWake con 2Slides: MCP para empleados de IA (2026)

Respuesta rápida (≤60 palabras): Busca el ID de tu Waker con qoderwake waker list --json, luego ejecuta qoderwake mcp add --waker-id ag_xxx --name 2slides --transport http --http-url https://2slides.com/api/mcp --header "Authorization=Bearer TU_API_KEY_DE_2SLIDES". Ese Waker podrá buscar temas en 2Slides y generar una presentación .pptx editable bajo demanda desde DingTalk, Feishu o de forma programada.

QoderWake, del equipo de Qoder en Alibaba, define su producto como "Empleados de IA autónomos en el puesto de trabajo". Cada empleado digital se denomina Waker. Un Waker se activa mediante mensajes de mensajería instantánea (IM), programaciones, eventos de hook o llamadas a la API, y realiza el trabajo por su cuenta. QoderWake funciona en macOS 13+, Linux y Windows 10+. Dispone de una consola web local en 127.0.0.1:19820, una CLI completa y se conecta con DingTalk y Feishu.

Los servidores y habilidades MCP se vinculan por cada Waker. Esta guía muestra cómo dotar a un Waker (por ejemplo, tu "Asistente de Informes") con el motor de presentaciones de 2Slides. Utiliza la referencia oficial de la CLI de QoderWake y los endpoints de 2Slides que probamos en producción el 30 de septiembre de 2026.

¿Por qué dar 2Slides a un Waker?

• Los Wakers están diseñados para tareas recurrentes, y "convertir las cifras de esta semana en una presentación" es exactamente ese tipo de trabajo.
• 2Slides genera el archivo: un PowerPoint editable basado en temas (Fast PPT, 10 créditos por página) o diapositivas con diseño de imagen (Nano Banana, 100 créditos por página a 1K/2K) con narración por IA opcional.
• El alcance por Waker garantiza que solo el Waker que necesita diapositivas tenga acceso a la herramienta y a la clave.

Requisitos previos

1. QoderWake instalado y con sesión iniciada. En macOS o Linux, la referencia de la CLI ofrece un instalador de una sola línea:

Los paquetes para Windows y macOS están disponibles en el sitio web de QoderWake. Si la terminal no encuentra qoderwake, usa ~/.qoderwake/bin/qoderwake.

1. Una clave de API de 2Slides desde 2slides.com/api (sk-2slides-...). Las cuentas nuevas reciben 500 créditos gratuitos, lo que cubre 50 páginas de Fast PPT.
2. Node.js en el dispositivo, solo si vas a usar el método stdio.

Paso 1: Buscar el ID del Waker

Los ID de los Waker comienzan por ag_. Copia el correspondiente al Waker que debe crear las presentaciones. Los ejemplos siguientes utilizan ag_xxx.

Método 1: MCP alojado sobre HTTP (recomendado)

Sobre el uso de comillas. La sintaxis de la CLI es --header CLAVE=VALOR (repetible). El valor aquí, Bearer TU_API_KEY_DE_2SLIDES, contiene un espacio, por lo que debes envolver todo el par CLAVE=VALOR entre comillas dobles como se muestra. Sin comillas, la terminal lo dividirá en dos argumentos y el encabezado llegará solo como Bearer.

¿Quieres evitar por completo los problemas de parseo con el = y los espacios? Usa el formato JSON de la misma opción, --headers <json>:

En Windows PowerShell, las comillas simples también funcionan, pero el uso de comillas en JSON entre diferentes terminales puede ser complicado. En ese caso, la importación mediante archivo del Método 2 es la opción más segura.

Alternativa sin encabezados. Si el encabezado sigue sin llegar (un error 401 o Authentication required al actualizar las herramientas), omite los encabezados por completo. 2Slides también acepta la clave como un parámetro de consulta en la URL, y hemos probado esta forma de extremo a extremo:

Trata esa URL como una contraseña: no la pegues en tareas ni capturas de pantalla, y rota la clave en 2slides.com/api si se filtra.

2Slides utiliza una clave de API sencilla, no OAuth, así que deja desactivados todos los flags --oauth-*.

Método 2: Importar JSON de MCP

qoderwake mcp add también acepta --json <json> o --json-file <path> para importar el JSON de MCP directamente. Guarda esto como 2slides-mcp.json:

La referencia de la CLI no especifica qué estructuras JSON acepta el importador. El bloque anterior es el formato común mcpServers. Si se rechaza la importación, utiliza los flags del Método 1, que están totalmente documentados. Elimina el archivo después o mantenlo fuera de cualquier repositorio Git, ya que contiene tu clave.

Método 3: Servidor stdio local

Para ejecutar el paquete de código abierto 2slides-mcp en el dispositivo del Waker:

--args acepta una lista separada por comas, el mismo estilo que el ejemplo oficial de sistema de archivos en la referencia de la CLI. --env acepta JSON. Esto requiere Node.js en la máquina donde se ejecuta el Waker; recuerda que QoderWake reside en el dispositivo por defecto.

Verificar la conexión

Toma el <mid> de mcp list. Luego, envía al Waker una prueba de solo lectura. La recomendación de QoderWake es validar cualquier conector nuevo con una llamada de solo lectura primero:

themes_search es gratuito, por lo que esta prueba no consume créditos. Si un conector se comporta de forma incorrecta, qoderwake mcp toggle --waker-id ag_xxx --mcp-id <mid> --enabled false lo desactiva sin llegar a eliminarlo.

Método 4: Cargar la skill de 2Slides

Las skills de QoderWake son paquetes de capacidades con versiones en git que puedes comparar (diff) y revertir. Para instalarlas, debes subir "un archivo Markdown o un archivo comprimido que contenga SKILL.md". La skill oficial de 2Slides se encuentra en github.com/2slides/slides-generation-2slides-skills. Comprímela en un archivo ZIP de modo que SKILL.md quede en la raíz del archivo:

Esto excluye el paquete .skill antiguo del repositorio. Los scripts de Python de la skill (Python 3 y requests) leen la clave desde la variable de entorno SLIDES_2SLIDES_API_KEY.

Regla sobre secretos. La documentación de QoderWake indica: "Nunca incluyas secretos, tokens o cookies en tareas, memoria, bases de conocimiento, archivos de rol o capturas de pantalla". Las credenciales deben ir en campos protegidos o variables de entorno. Por tanto, nunca pegues tu clave en el prompt de una tarea ni le pidas al Waker que la "recuerde". Dado que QoderWake no documenta una forma de pasar variables de entorno a los scripts de las skills, recomendamos esta división:

• Usa el conector MCP (Método 1) para las llamadas reales a la API. La clave reside en su cabecera.
• Usa la skill solo si la variable SLIDES_2SLIDES_API_KEY ya está configurada en el entorno donde se ejecuta el Waker. Verifícalo con una tarea de prueba que ejecute scripts/search_themes.py --query minimal --limit 1.

Genera tu primera presentación

El Waker debería llamar a themes_search, luego a slides_generate y devolver un downloadUrl. En nuestra prueba de producción, una presentación Fast PPT de 3 diapositivas se generó en unos 22 segundos. El enlace caduca después de 1 hora. La documentación de QoderWake menciona que la entrega de archivos "depende de las capacidades del canal. Usa el enlace devuelto o el artefacto de la tarea". Por lo tanto, haz que el Waker publique el enlace de inmediato o que descargue el archivo .pptx en su espacio de trabajo. Luego puedes extraerlo de la sesión con qoderwake session artifacts --session-id sess_xxx.

Casos de uso para un empleado de IA

Activado desde DingTalk o Feishu. Una vez que un Waker está vinculado a un canal de DingTalk o Feishu, un compañero de equipo puede enviar un mensaje: "@Asistente de Reportes haz una actualización de 6 diapositivas sobre el plan de contratación del Q4". El Waker recopila el contexto, llama a 2Slides y responde con el enlace.

Una presentación semanal programada. La referencia de la CLI documenta las automatizaciones programadas:

Ejecútala una vez con run-now y verifica el resultado con qoderwake automation detail antes de dejar que funcione por su cuenta.

Las herramientas MCP de 2Slides

Lo confirmado frente a lo no documentado (a 30 de septiembre de 2026)

Resolución de problemas

• "daemon unreachable". Ejecuta qoderwake status. Si el demonio no está en marcha, usa qoderwake start. Si el puerto está ocupado, qoderwake start --port auto.
• Error 401 de QoderWake. Ejecuta qoderwake whoami y vuelve a hacer qoderwake login si es necesario.
• Error 401 de 2Slides. Probablemente la cabecera llegó sin la clave. Vuelve a añadirla usando --header entre comillas o el formato JSON de --headers.
• Faltan herramientas. Ejecuta qoderwake mcp refresh-tools y comprueba que el conector esté habilitado con mcp toggle ... --enabled true.
• Fallo en stdio. Verifica que Node.js esté instalado en el dispositivo del Waker y que --args esté separado por comas.
• Errores en una ejecución. Usa qoderwake log --level error --limit 100 o qoderwake trace list --status failed.
• Enlace caducado. El downloadUrl dura 1 hora. Haz que el Waker guarde el archivo como un artefacto de la tarea.

Preguntas frecuentes

¿Admite QoderWake servidores MCP personalizados?

Sí. Cada Waker puede montar varios servidores MCP a través de stdio, HTTP o SSE, utilizando qoderwake mcp add --waker-id <id> o la pantalla de Conectores MCP Personalizados en la consola.

¿Cuál es el comando exacto para añadir 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". Pon entre comillas todo el par de la cabecera, ya que el valor contiene un espacio.

¿Dónde debo guardar la clave de API de 2Slides en QoderWake?

En la cabecera del conector MCP (--header o --headers) o en su --env para stdio. Nunca la pongas en una tarea, memoria, base de conocimiento o archivo de rol. La documentación de QoderWake lo prohíbe explícitamente.

¿Puede un Waker enviar el PowerPoint a DingTalk o Feishu?

El Waker siempre puede responder con el enlace de descarga de 2Slides. Que el archivo en sí se adjunte depende del canal. La documentación de QoderWake recomienda usar el enlace devuelto o el artefacto de la tarea. El enlace caduca tras 1 hora.

¿Puede un Waker crear una presentación cada semana automáticamente?

Sí. Crea una automatización programada con qoderwake automation create schedule y una expresión cron. Pruébala con automation run-now antes de dejarla en modo desatendido.

¿Cuánto cuesta?

Las cuentas nuevas de 2Slides reciben 500 créditos gratuitos. Fast PPT cuesta 10 créditos por página, por lo que una presentación semanal de 8 diapositivas consume 80 créditos. La búsqueda de plantillas, la consulta de estados de trabajos y las exportaciones son gratuitas.

Conclusión

Un solo comando qoderwake mcp add convierte a un Waker en un empleado de IA capaz de entregar presentaciones reales. Mantén la clave en la cabecera MCP, actívalo desde DingTalk, Feishu o mediante una tarea programada (cron), y guarda el archivo .pptx en menos de una hora.

Guías relacionadas: agentes de IA personales que pueden crear diapositivas, QwenWork con 2Slides, WorkBuddy con 2Slides, usa cualquier agente de IA con el servidor MCP de 2Slides y habilidades de agentes frente a servidores MCP.

Obtén tu clave y configuración en 2slides.com/api?tab=mcp.

Fuentes:

• Referencia de la CLI de QoderWake
• Habilidades e integraciones de QoderWake
• Página de producto de QoderWake
• API y servidor MCP de 2Slides
• Skill de 2Slides en GitHub
• 2slides-mcp en GitHub