Para agentes de IA

Cómo funciona la integración MCP

Nextavio expone un servidor MCP (Model Context Protocol) remoto: un agente de IA compatible — como Claude Code — puede crear una presentación interactiva completa (título, diapositivas y elementos) de una sola llamada, sin pasar por el editor visual.

¿Qué puede hacer un agente con esto?

El servidor expone dos herramientas. Entre las dos cubren el flujo completo: generar el contenido de una presentación y, si hace falta, subir las imágenes que use.

`create_presentation`

Recibe un título y una lista de diapositivas con sus elementos, y crea la presentación entera en una sola llamada. Soporta los 17 tipos de elemento del editor (texto, imagen, vídeo, audio, capa, botón, pregunta, cuestionario, imagen interactiva, flashcards, timeline, rellenar huecos, arrastrar y soltar, relacionar, ramificación, vídeo interactivo, sopa de letras).

La posición y el tamaño (rect) de cada elemento son opcionales — si se omiten, un auto-layout los coloca en columnas sin solapar, con el mismo tamaño por defecto que usa el editor al añadir un elemento desde la interfaz.
Los botones y ramificaciones referencian otras diapositivas de la misma llamada por su posición en la lista, no por id — el servidor resuelve los ids reales al crearlas.
Devuelve un enlace directo a la presentación ya creada y lista para abrir.

`upload_image`

Sube una imagen a la cuenta de medios de Nextavio y devuelve la URL definitiva para usarla como src de un elemento image (o imageHotspots) en create_presentation.

Acepta una url pública (se descarga en el servidor), o data + mimeType con los bytes en base64, para cuando el cliente MCP solo tiene un archivo local.

Flujo típico

Si la presentación necesita imágenes propias, el agente llama a upload_image una vez por imagen y guarda la URL que devuelve.
El agente llama a create_presentation con el título y el array de diapositivas, usando esas URLs donde haga falta.
Recibe de vuelta un enlace (https://www.nextavio.es/?open=<id>) que abre la presentación ya creada directamente en el editor.

Ejemplo (esquemático)

{
  "tool": "create_presentation",
  "input": {
    "title": "El ciclo del agua",
    "slides": [
      {
        "name": "Portada",
        "elements": [
          { "type": "text", "html": "<h1>El ciclo del agua</h1>" }
        ]
      },
      {
        "elements": [
          { "type": "image", "src": "https://res.cloudinary.com/.../nube.png", "alt": "Nube" },
          { "type": "text", "html": "<p>El agua se evapora, forma nubes y cae como lluvia.</p>" }
        ]
      }
    ]
  }
}

Transporte y autenticación

El servidor usa Streamable HTTP en modo sin estado — cada llamada es independiente, sin sesión persistida entre invocaciones — y se autentica con una clave de API personal (Authorization: Bearer <clave>) en vez de una sesión de Nextavio: cada presentación que cree un agente queda en tu cuenta, identificada por esa clave.

Genera tu clave

Inicia sesión en Nextavio y abre el menú de tu perfil (arriba a la derecha).
Entra en «Claves de API (MCP)» y pulsa «+ Nueva clave».
Cópiala en ese momento — por seguridad no se vuelve a mostrar. Puedes crear varias (una por dispositivo o cliente) y revocar cualquiera cuando quieras sin afectar a las demás.

Con la clave ya copiada, un cliente MCP se registra así en Claude Code:

claude mcp add --transport http nextavio https://www.nextavio.es/api/mcp \
  --header "Authorization: Bearer <tu-clave>"

Guarda la clave como un secreto — cualquiera que la tenga puede crear presentaciones en tu cuenta hasta que la revoques. Si sospechas que se ha filtrado, revócala desde «Claves de API (MCP)» y genera una nueva.