DEKSby EIGEN

Documentación MCP

Conectar un agente a DEKS

Usa el MCP oficial para leer, validar y editar presentaciones desde ChatGPT o Claude.

Última actualización: 18 de septiembre de 2026

Inicio rápido

Elige el endpoint Streamable HTTP según tu conexión:

MCP general

Para Codex, Claude y otras conexiones MCP. Incluye las nuevas herramientas de DEKS, como la carga de audio para narración.

https://api-deks.eigen.cl/mcp/

Plugin de OpenAI

El canal dedicado al plugin de OpenAI conserva una selección estable de herramientas. La carga de audio está disponible en el MCP general.

https://api-deks.eigen.cl/mcp/openai/
  1. Agrega la URL elegida como servidor o conector MCP remoto en tu cliente.
  2. El cliente abrirá el flujo OAuth 2.1 de DEKS en el navegador.
  3. Inicia sesión, elige el workspace y revisa los permisos solicitados.
  4. Aprueba la conexión y vuelve al cliente para listar las herramientas.
  5. Prueba primero una lectura o una validación antes de ejecutar cambios.

El flujo público usa OAuth 2.1 con PKCE. No copies tokens entre aplicaciones ni agregues un header manual para una integración pública.

Guía pública para agentes (texto plano)

Clientes compatibles

ChatGPT

Agrega un conector MCP personalizado desde la configuración de conectores o Developer Mode, usa el canal dedicado al plugin de OpenAI y completa la autorización en DEKS. Cuando el plugin DEKS esté publicado, podrás instalarlo desde el directorio sin registrar manualmente la URL.

Claude

En Claude agrega un conector personalizado remoto con el endpoint general. En Claude Code puedes registrar el mismo servidor HTTP desde la terminal:

claude mcp add --transport http deks https://api-deks.eigen.cl/mcp/

Codex

Agrega un servidor MCP remoto llamado deks en la configuración MCP de Codex y usa el endpoint general. Codex abrirá el navegador cuando necesite completar OAuth. La aplicación de escritorio, la CLI y la extensión comparten la configuración personal de MCP.

Las interfaces cambian con el tiempo. Si un nombre de menú no coincide, busca “MCP”, “connectors” o “custom connector” en la versión actual del cliente.

Presentaciones con voz externa

Prepara un guion y un archivo de audio por diapositiva. Puedes generar la voz en ElevenLabs u otro servicio; la cuenta y el consumo de ese servicio se administran fuera de DEKS.

En el MCP general, usa upload_narration_audio para cargar un archivo WAV o MP3 y set_slide_narration para vincular el audio, guion y pausas a una diapositiva. Subir un archivo crea un recurso privado del workspace; no modifica una presentación.

La carga acepta un adjunto de ChatGPT de hasta 50 MB o audio en base64 de hasta 1 MB decodificado. Cada archivo debe durar como máximo 10 minutos y caber en el espacio del workspace. La carga de imágenes no admite audio.

Al publicar desde el MCP general, comparte playback_url para abrir la presentación con narración y avance automático activados. El enlace al editor es una opción separada.

Guion y audio externos → presentación .deks → enlace público
/p/<public_id>?narration=1&autoAdvance=1
/p/<public_id>/editor

El enlace de presentación ocupa la ventana y espera Play. Narración y avance automático son preferencias iniciales que cada persona puede cambiar. Pantalla completa es opcional.

En automático, cada diapositiva dura lo que dura su audio y sus pausas, aunque la voz esté apagada; sin audio espera 20 segundos. En manual, la persona decide cuándo avanzar.

El enlace al editor se habilita por presentación. Permite explorar el original, copiarlo o descargarlo. Sólo quienes ya tienen permiso de edición pueden modificar el original.

El guion se conserva como referencia y la presentación mantiene la versión cargada hasta recargar la página.

Permisos de lectura y escritura

Autoriza sólo lo que necesita el flujo:

  • Lectura: listar y leer presentaciones, revisar slides, validar layout y exportar un deck.
  • Escritura: crear, modificar, reordenar o eliminar contenido dentro del workspace autorizado.

Empieza con lectura para auditorías y consultas. Activa escritura sólo cuando quieras que el agente cambie contenido. Las operaciones destructivas deben mostrar confirmación y pueden exigir datos adicionales, como el nombre y revisión vigentes de una presentación.

PAT para desarrollo local y CLI

Los Personal Access Tokens se reservan para desarrollo local, pruebas controladas y clientes CLI que no puedan completar OAuth. Crea uno con el alcance mínimo, guárdalo en el almacén de secretos del cliente y revócalo al terminar. Nunca lo publiques en Git, documentación, logs ni variables expuestas al navegador.

Para ChatGPT y conectores remotos administrados usa siempre OAuth; no pegues un PAT en una interfaz de terceros.

Revisar y revocar acceso

Revisa las conexiones en la configuración MCP del workspace. Revoca inmediatamente cualquier cliente que no reconozcas, que ya no uses o que tenga permisos mayores a los necesarios. La revocación invalida su acceso futuro; también conviene eliminar el servidor desde el cliente.

Buenas prácticas

  • Usa HTTPS y el host exacto api-deks.eigen.cl, con la ruta /mcp/ o /mcp/openai/ según tu conexión.
  • No entregues enlaces mágicos, cookies, códigos OAuth ni tokens a un agente.
  • Valida el layout después de una edición y revisa el resultado antes de presentarlo.
  • Conserva una exportación de contenido crítico antes de cambios destructivos.
  • Separa conexiones personales y de equipo usando el workspace correcto.

Para problemas de autorización o una conexión inesperada, visita Soporte DEKS.

Documentación de los clientes